OutputDevice.h

Go to the documentation of this file.

/****************************************************************************/
// Static storage of an output device and its base (abstract) implementation
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright 2001-2010 DLR (http://www.dlr.de/) and contributors
/****************************************************************************/
//
//   This program is free software; you can redistribute it and/or modify
//   it under the terms of the GNU General Public License as published by
//   the Free Software Foundation; either version 2 of the License, or
//   (at your option) any later version.
//
/****************************************************************************/
#ifndef OutputDevice_h
#define OutputDevice_h


// ===========================================================================
// included modules
// ===========================================================================
#ifdef _MSC_VER
#include <windows_config.h>
#else
#include <config.h>
#endif

#include <string>
#include <vector>
#include <map>
#include <utils/common/UtilExceptions.h>


// ===========================================================================
// class definitions
// ===========================================================================
class OutputDevice {
public:

    static OutputDevice& getDevice(const std::string &name,
                                   const std::string &base="") throw(IOError);


    static bool createDeviceByOption(const std::string &optionName,
                                     const std::string &rootElement="") throw(IOError);


    static OutputDevice& getDeviceByOption(const std::string &name) throw(IOError, InvalidArgument);


    static void closeAll() throw();



public:

    OutputDevice() throw(IOError) { }


    virtual ~OutputDevice() throw() { }


    virtual bool ok() throw();


    void close() throw();


    void setPrecision(unsigned int precision=OUTPUT_ACCURACY) throw();


    bool writeXMLHeader(const std::string &rootElement,
                        const bool writeConfig=true,
                        const std::string &attrs="",
                        const std::string &comment="") throw();


    OutputDevice& indent() throw();


    OutputDevice& openTag(const std::string &xmlElement) throw();


    bool closeTag(bool abbreviated=false) throw();


    void inform(const std::string &msg);


    template <class T>
    OutputDevice &operator<<(const T &t) {
        getOStream() << t;
        postWriteHook();
        return *this;
    }

protected:
    virtual std::ostream &getOStream() throw() = 0;


    virtual void postWriteHook() throw();


private:

    typedef std::map<std::string, OutputDevice*> DeviceMap;

    static DeviceMap myOutputDevices;


private:

    std::vector<std::string> myXMLStack;

};


#endif

/****************************************************************************/