PlainXMLFormatter.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2012-2025 German Aerospace Center (DLR) and others.
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0/
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License 2.0 are satisfied: GNU General Public License, version 2
// or later which is available at
// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
/****************************************************************************/
// Output formatter for plain XML output
/****************************************************************************/
#pragma once
#include <config.h>
 
#ifdef HAVE_FMT
#include <fmt/ostream.h>
#endif
 
#include "OutputFormatter.h"
 
 
// ===========================================================================
// class definitions
// ===========================================================================
class PlainXMLFormatter : public OutputFormatter {
public:
    PlainXMLFormatter(const int defaultIndentation = 0);
 
    virtual ~PlainXMLFormatter() { }
 
    bool writeXMLHeader(std::ostream& into, const std::string& rootElement,
                        const std::map<SumoXMLAttr, std::string>& attrs, bool writeMetadata,
                        bool includeConfig);
 
    void openTag(std::ostream& into, const std::string& xmlElement);
 
    void openTag(std::ostream& into, const SumoXMLTag& xmlElement);
 
    bool closeTag(std::ostream& into, const std::string& comment = "");
 
    void writePreformattedTag(std::ostream& into, const std::string& val);
 
    void writePadding(std::ostream& into, const std::string& val);
 
    template <class T>
    static void writeAttr(std::ostream& into, const std::string& attr, const T& val) {
        into << " " << attr << "=\"" << toString(val, into.precision()) << "\"";
    }
 
    template <class T>
    static void writeAttr(std::ostream& into, const SumoXMLAttr attr, const T& val) {
        into << " " << toString(attr) << "=\"" << toString(val, into.precision()) << "\"";
    }
 
    void writeTime(std::ostream& into, const SumoXMLAttr attr, const SUMOTime val) {
        into << " " << toString(attr) << "=\"" << time2string(val) << "\"";
    }
 
    bool wroteHeader() const {
        return !myXMLStack.empty();
    }
 
private:
    std::vector<std::string> myXMLStack;
 
    int myDefaultIndentation;
 
    bool myHavePendingOpener;
};
 
 
// ===========================================================================
// specialized template implementations (for speedup)
// ===========================================================================
template <>
inline void PlainXMLFormatter::writeAttr(std::ostream& into, const SumoXMLAttr attr, const double& val) {
#ifdef HAVE_FMT
    fmt::print(into, " {}=\"{:.{}f}\"", toString(attr), val, into.precision());
#else
    into << " " << toString(attr) << "=\"" << toString(val, into.precision()) << "\"";
#endif
}
 
 
template <>
inline void PlainXMLFormatter::writeAttr(std::ostream& into, const SumoXMLAttr attr, const std::string& val) {
    into << " " << toString(attr) << "=\"" << val << "\"";
}