NBConnection.h

Go to the documentation of this file.

/****************************************************************************/
// The class holds a description of a connection between two edges
/****************************************************************************/
// 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 NBConnection_h
#define NBConnection_h


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

#include <string>
#include "NBEdge.h"


// ===========================================================================
// class declarations
// ===========================================================================
class NBNode;


// ===========================================================================
// class definitions
// ===========================================================================
class NBConnection {
public:
    NBConnection(NBEdge* from, NBEdge* to);

    NBConnection(NBEdge* from, int fromLane, NBEdge* to, int toLane, int tlIndex = InvalidTlIndex);

    NBConnection(const std::string& fromID, NBEdge* from,
                 const std::string& toID, NBEdge* to);

    NBConnection(const NBConnection& c);

    virtual ~NBConnection();

    NBEdge* getFrom() const;

    NBEdge* getTo() const;

    bool replaceFrom(NBEdge* which, NBEdge* by);

    bool replaceFrom(NBEdge* which, int whichLane, NBEdge* by, int byLane);

    bool replaceTo(NBEdge* which, NBEdge* by);

    bool replaceTo(NBEdge* which, int whichLane, NBEdge* by, int byLane);

    bool check(const NBEdgeCont& ec);

    int getFromLane() const;

    int getToLane() const;

    /* @brief returns the index within the controlling tls or InvalidTLIndex if this
     * link is unontrolled */
    int getTLIndex() const {
        return myTlIndex;
    }

    // @brief reset the tlIndex
    void setTLIndex(int tlIndex) {
        myTlIndex = tlIndex;
    }

    std::string getID() const;

    friend bool operator<(const NBConnection& c1, const NBConnection& c2);

    bool operator==(const NBConnection& c) const;

    bool operator!=(const NBConnection& c) const {
        return !(*this == c);
    }

    const static int InvalidTlIndex;
    const static NBConnection InvalidConnection;

private:
    NBEdge* checkFrom(const NBEdgeCont& ec);

    NBEdge* checkTo(const NBEdgeCont& ec);

private:
    NBEdge* myFrom, *myTo;

    std::string myFromID, myToID;

    int myFromLane, myToLane;

    // @brief the index within the controlling tls if this connection is tls-controlled
    int myTlIndex;

};


#endif

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