SUMOSAXAttributes.h

Go to the documentation of this file.

/****************************************************************************/
// Encapsulated SAX-Attributes
/****************************************************************************/
// 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 SUMOSAXAttributes_h
#define SUMOSAXAttributes_h


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

#include <string>
#include <vector>
#include <utils/common/SUMOTime.h>
#include "SUMOXMLDefinitions.h"
#include <utils/common/UtilExceptions.h>


// ===========================================================================
// class definitions
// ===========================================================================
class SUMOSAXAttributes {
public:
    SUMOSAXAttributes() throw() { }


    virtual ~SUMOSAXAttributes() throw() { }


    bool setIDFromAttributes(const char *objecttype, std::string &id,
                             bool report=true) const throw();



    int getIntReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                        bool report=true) const throw();


    int getOptIntReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                           int defaultValue, bool report=true) const throw();



    SUMOReal getSUMORealReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                                  bool report=true) const throw();



    SUMOReal getOptSUMORealReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                                     SUMOReal defaultValue, bool report=true) const throw();



    bool getBoolReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                          bool report=true) const throw();



    bool getOptBoolReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                             bool defaultValue, bool report=true) const throw();



    std::string getStringReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                                   bool report=true) const throw();



    std::string getOptStringReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                                      const std::string &defaultValue, bool report=true) const throw();



    SUMOTime getSUMOTimeReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                                  bool report=true) const throw();



    SUMOTime getOptSUMOTimeReporting(SumoXMLAttr attr, const char *objecttype, const char *objectid, bool &ok,
                                     SUMOTime defaultValue, bool report=true) const throw();









    virtual bool hasAttribute(SumoXMLAttr id) const throw() = 0;


    virtual bool hasAttribute(const std::string &id) const throw() = 0;


    virtual bool getBool(SumoXMLAttr id) const throw(EmptyData, BoolFormatException) = 0;

    virtual bool getBoolSecure(SumoXMLAttr id, bool val) const throw(EmptyData) = 0;


    virtual int getInt(SumoXMLAttr id) const throw(EmptyData, NumberFormatException) = 0;


    virtual int getIntSecure(SumoXMLAttr id, int def) const throw(EmptyData, NumberFormatException) = 0;


    virtual std::string getString(SumoXMLAttr id) const throw(EmptyData) = 0;


    virtual std::string getStringSecure(SumoXMLAttr id,
                                        const std::string &def) const throw(EmptyData) = 0;


    virtual SUMOReal getFloat(SumoXMLAttr id) const throw(EmptyData, NumberFormatException) = 0;

    virtual SUMOReal getFloatSecure(SumoXMLAttr id, SUMOReal def) const throw(EmptyData, NumberFormatException) = 0;


    virtual SUMOReal getFloat(const std::string &id) const throw(EmptyData, NumberFormatException) = 0;


    virtual std::string getStringSecure(const std::string &id,
                                        const std::string &def) const throw() = 0;
    //}


    virtual std::string getName(SumoXMLAttr attr) const throw() = 0;


    static void parseStringVector(const std::string &def, std::vector<std::string> &into) throw();

protected:
    void emitUngivenError(const std::string &attrname, const char *objecttype, const char *objectid) const throw();
    void emitEmptyError(const std::string &attrname, const char *objecttype, const char *objectid) const throw();
    void emitFormatError(const std::string &attrname, const std::string &type, const char *objecttype, const char *objectid) const throw();

private:
    static bool myHaveInformedAboutDeprecatedDivider;

private:
    SUMOSAXAttributes(const SUMOSAXAttributes &src);

    SUMOSAXAttributes &operator=(const SUMOSAXAttributes &src);


};


#endif

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