NamedObjectCont.h

Go to the documentation of this file.

/****************************************************************************/
// A map of named object pointers
/****************************************************************************/
// SUMO, Simulation of Urban MObility; see http://sumo.sourceforge.net/
// Copyright (C) 2001-2011 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 NamedObjectCont_h
#define NamedObjectCont_h


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

#include <map>
#include <string>
#include <vector>
#include <algorithm>


// ===========================================================================
// class definitions
// ===========================================================================
template<class T>
class NamedObjectCont {
public:
    NamedObjectCont() throw() : myHaveChanged(false) { }


    virtual ~NamedObjectCont() throw() {
        for (typename IDMap::iterator i=myMap.begin(); i!=myMap.end(); i++) {
            delete(*i).second;
        }
    }


    virtual bool add(const std::string& id, T item) throw() {
        if (myMap.find(id)!=myMap.end()) {
            return false;
        }
        myMap.insert(std::make_pair(id, item));
        myHaveChanged = true;
        return true;
    }


    virtual bool remove(const std::string& id) throw() {
        if (myMap.find(id)==myMap.end()) {
            return false;
        }
        typename std::map<std::string, T>::iterator i = myMap.find(id);
        delete i->second;
        myMap.erase(i);
        myHaveChanged = true;
        return true;
    }


    T get(const std::string& id) const throw() {
        typename std::map<std::string, T>::const_iterator i = myMap.find(id);
        if (i==myMap.end()) {
            return 0;
        }
        return (*i).second;
    }


    void clear() throw() {
        for (typename IDMap::iterator i=myMap.begin(); i!=myMap.end(); i++) {
            delete(*i).second;
        }
        myMap.clear();
        myVector.clear();
        myHaveChanged = true;
    }


    unsigned int size() const throw() {
        return (unsigned int) myMap.size();
    }


    bool erase(const std::string& id) throw() {
        typename IDMap::iterator i=myMap.find(id);
        if (i==myMap.end()) {
            return false;
        }
        T o = (*i).second;
        myMap.erase(i);
        // and from the vector
        typename ObjectVector::iterator i2 =
            find(myVector.begin(), myVector.end(), o);
        myHaveChanged = true;
        if (i2!=myVector.end()) {
            myVector.erase(i2);
        }
        delete o;
        return true;
    }


    /* @brief Returns the reference to a vector that contains all objects.
     *
     * This method returns the reference to a vector which is stored within
     *  this class and contains all known objects stored within the map.
     * This vector is rebuild in prior if "myHaveChanged" indicates
     *  a change has taken place.
     *
     * @return Reference to a saved vector of objects within the map
     */
    const std::vector<T> &buildAndGetStaticVector() const throw() {
        if (myHaveChanged) {
            myVector.clear();
            typename IDMap::const_iterator i;
            for (i=myMap.begin(); i!=myMap.end(); ++i) {
                myVector.push_back((*i).second);
            }
            myHaveChanged = false;
        }
        return myVector;
    }


    /* @brief Returns a vector that contains all objects.
     *
     * This method builds and returns a vector which contains all known
     *  objects stored within the map.
     *
     * @return A vector of objects within the map
     */
    std::vector<T> getTempVector() const throw() {
        std::vector<T> ret;
        typename IDMap::const_iterator i;
        for (i=myMap.begin(); i!=myMap.end(); ++i) {
            ret.push_back((*i).second);
        }
        return ret;
    }


    /* @brief Fills the given vector with the stored objects' ids
     * @param[in] into The container to fill
     */
    void insertIDs(std::vector<std::string> &into) const throw() {
        typename IDMap::const_iterator i;
        for (i=myMap.begin(); i!=myMap.end(); ++i) {
            into.push_back((*i).first);
        }
    }


    /* @brief Returns a reference to the internal map
     *
     * @return A reference to the internal map
     */
    const std::map<std::string, T> &getMyMap() const throw() {
        return myMap;
    }


private:
    typedef std::map< std::string, T > IDMap;

    typedef typename IDMap::iterator myContIt;

    IDMap myMap;

    typedef std::vector<T> ObjectVector;

    mutable ObjectVector myVector;

    mutable bool myHaveChanged;

};


#endif

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