SUMO - Simulation of Urban MObility
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
FileHelpers Class Reference

Functions for an easier usage of files and paths. More...

#include <FileHelpers.h>

Public Member Functions

template<typename E >
void readEdgeVector (std::istream &in, std::vector< const E * > &edges, const std::string &rid)
 
template<typename E >
std::ostream & writeEdgeVector (std::ostream &os, const std::vector< E > &edges)
 

Static Public Member Functions

file access functions
static bool exists (std::string path)
 Checks whether the given file exists. More...
 
file path evaluating functions
static std::string getFilePath (const std::string &path)
 Removes the file information from the given path. More...
 
static std::string getConfigurationRelative (const std::string &configPath, const std::string &path)
 Returns the second path as a relative path to the first file. More...
 
static bool isSocket (const std::string &name)
 Returns the information whether the given name represents a socket. More...
 
static bool isAbsolute (const std::string &path)
 Returns the information whether the given path is absolute. More...
 
static std::string checkForRelativity (const std::string &filename, const std::string &basePath)
 Returns the path from a configuration so that it is accessable from the current working directory. More...
 
binary writing functions
static std::ostream & writeInt (std::ostream &strm, int value)
 Writes an integer binary. More...
 
static std::ostream & writeUInt (std::ostream &strm, unsigned int value)
 Writes an unsigned integer binary. More...
 
static std::ostream & writeFloat (std::ostream &strm, SUMOReal value)
 Writes a float binary. More...
 
static std::ostream & writeByte (std::ostream &strm, unsigned char value)
 Writes a byte binary. More...
 
static std::ostream & writeString (std::ostream &strm, const std::string &value)
 Writes a string binary. More...
 
static std::ostream & writeTime (std::ostream &strm, SUMOTime value)
 Writes a time description binary. More...
 
template<typename E >
static std::ostream & writeEdgeVector (std::ostream &os, const std::vector< E > &edges)
 Writes an edge vector binary. More...
 
template<typename E >
static void readEdgeVector (std::istream &in, std::vector< const E * > &edges, const std::string &rid)
 Reads an edge vector binary. More...
 

Detailed Description

Functions for an easier usage of files and paths.

Definition at line 48 of file FileHelpers.h.

Member Function Documentation

std::string FileHelpers::checkForRelativity ( const std::string &  filename,
const std::string &  basePath 
)
static

Returns the path from a configuration so that it is accessable from the current working directory.

If the path is absolute, it is returned. Otherwise, the file's position is computed regarding the configuration path (see getConfigurationRelative).

See Also
isAbsolute
getConfigurationRelative
Parameters
[in]filenameThe path to the file to be examined
[in]basePathThe path the configuration file (including the config's file name)
Returns
The file's position

Definition at line 123 of file FileHelpers.cpp.

References getConfigurationRelative(), isAbsolute(), and isSocket().

Referenced by NLHandler::addE1Detector(), NLHandler::addE2Detector(), NLHandler::addEdgeLaneMeanData(), NLHandler::addInstantE1Detector(), NLHandler::addRouteProbeDetector(), NLHandler::addVTypeProbeDetector(), NLHandler::beginE3Detector(), NLDiscreteEventBuilder::buildSaveTLStateCommand(), NLDiscreteEventBuilder::buildSaveTLSwitchesCommand(), and NLDiscreteEventBuilder::buildSaveTLSwitchStatesCommand().

std::string FileHelpers::getConfigurationRelative ( const std::string &  configPath,
const std::string &  path 
)
static

Returns the second path as a relative path to the first file.

Given the position of the configuration file, and the information where a second file is relative to the configuration file's position, we want to known where this second file can be found. This method gets the path to the configuration file (including the configuration file name) and the path to get the relative position of and returns this relative position.

Parameters
[in]configPathThe path the configuration file (including the config's file name)
[in]pathThe path to the references file (relativ to configuration path)
Returns
The file's position (relative to curent working directory)

Definition at line 85 of file FileHelpers.cpp.

References getFilePath().

Referenced by NLHandler::addPOI(), NLHandler::addPoly(), SUMOVehicleParserHelper::beginVTypeParsing(), checkForRelativity(), NLTriggerBuilder::getFileName(), GUISettingsHandler::myStartElement(), PCLoaderXML::myStartElement(), OptionsCont::relocateFiles(), and GenericSAXHandler::startElement().

std::string FileHelpers::getFilePath ( const std::string &  path)
static

Removes the file information from the given path.

Parameters
[in]pathThe path to the file to return the folder it is located in
Returns
The directory of the named file

Definition at line 75 of file FileHelpers.cpp.

Referenced by getConfigurationRelative(), RODFDetectorCon::writeEmitters(), and RODFDetectorCon::writeSpeedTrigger().

bool FileHelpers::isAbsolute ( const std::string &  path)
static

Returns the information whether the given path is absolute.

A path is meant to be absolute, if

  • it is a socket
  • it starts with a "/" (Linux)
  • it has a ':' at the second position (Windows)
Parameters
[in]pathThe path to examine
Returns
Whether the path is absolute

Definition at line 100 of file FileHelpers.cpp.

References isSocket().

Referenced by NLHandler::addPOI(), NLHandler::addPoly(), SUMOVehicleParserHelper::beginVTypeParsing(), checkForRelativity(), NLTriggerBuilder::getFileName(), GUISettingsHandler::myStartElement(), PCLoaderXML::myStartElement(), OptionsCont::relocateFiles(), and GenericSAXHandler::startElement().

bool FileHelpers::isSocket ( const std::string &  name)
static

Returns the information whether the given name represents a socket.

A file name is meant to describe a socket address if a colon is found at a position larger than one.

Parameters
[in]nameThe name of a file
Returns
Whether the name names a socket

Definition at line 93 of file FileHelpers.cpp.

Referenced by checkForRelativity(), OutputDevice::getDevice(), and isAbsolute().

template<typename E >
static void FileHelpers::readEdgeVector ( std::istream &  in,
std::vector< const E * > &  edges,
const std::string &  rid 
)
static

Reads an edge vector binary.

Parameters
[in]isThe stream to read from
[out]edgesThe edge vector to write into
Returns
Reference to the stream

Referenced by RORouteHandler::parseEdges(), and MSEdge::parseEdgesList().

template<typename E >
void FileHelpers::readEdgeVector ( std::istream &  in,
std::vector< const E * > &  edges,
const std::string &  rid 
)

Definition at line 278 of file FileHelpers.h.

std::ostream & FileHelpers::writeByte ( std::ostream &  strm,
unsigned char  value 
)
static
template<typename E >
static std::ostream& FileHelpers::writeEdgeVector ( std::ostream &  os,
const std::vector< E > &  edges 
)
static

Writes an edge vector binary.

Parameters
[in,out]osThe stream to write into
[in]edgesThe edges to write
Returns
Reference to the stream

Referenced by BinaryFormatter::writeAttr().

template<typename E >
std::ostream& FileHelpers::writeEdgeVector ( std::ostream &  os,
const std::vector< E > &  edges 
)

Definition at line 222 of file FileHelpers.h.

References writeInt(), and writeUInt().

std::ostream & FileHelpers::writeFloat ( std::ostream &  strm,
SUMOReal  value 
)
static

Writes a float binary.

This method behaves differently depending on the definition of SUMOReal at compile time.

Parameters
[in,out]strmThe stream to write into
[in]valueThe float to write
Returns
Reference to the stream

Definition at line 156 of file FileHelpers.cpp.

References SUMOReal.

Referenced by BinaryFormatter::writeAttr(), and BinaryFormatter::writePosition().

std::ostream & FileHelpers::writeInt ( std::ostream &  strm,
int  value 
)
static

Writes an integer binary.

Parameters
[in,out]strmThe stream to write into
[in]valueThe integer to write
Returns
Reference to the stream

Definition at line 142 of file FileHelpers.cpp.

Referenced by SUMOSAXAttributesImpl_Binary::SUMOSAXAttributesImpl_Binary(), BinaryFormatter::writeAttr(), writeEdgeVector(), BinaryFormatter::writeHeader(), BinaryFormatter::writePosition(), and BinaryFormatter::writeStringList().

std::ostream & FileHelpers::writeString ( std::ostream &  strm,
const std::string &  value 
)
static

Writes a string binary.

Writes the length of the string, first, using writeInt. Writes then the string's characters.

See Also
writeInt
Parameters
[in,out]strmThe stream to write into
[in]valueThe string to write
Returns
Reference to the stream

Definition at line 170 of file FileHelpers.cpp.

References writeUInt().

Referenced by BinaryFormatter::writeAttr(), BinaryFormatter::writeHeader(), BinaryFormatter::writeStringList(), and BinaryFormatter::writeXMLHeader().

std::ostream & FileHelpers::writeTime ( std::ostream &  strm,
SUMOTime  value 
)
static

Writes a time description binary.

This method behaves differently depending on the definition of SUMOTime at compile time, which in turn depends on the enabling of subsecond timesteps.

Parameters
[in,out]strmThe stream to write into
[in]valueThe time to write
Returns
Reference to the stream

Definition at line 180 of file FileHelpers.cpp.

std::ostream & FileHelpers::writeUInt ( std::ostream &  strm,
unsigned int  value 
)
static

Writes an unsigned integer binary.

Parameters
[in,out]strmThe stream to write into
[in]valueThe unsigned integer to write
Returns
Reference to the stream

Definition at line 149 of file FileHelpers.cpp.

Referenced by writeEdgeVector(), and writeString().


The documentation for this class was generated from the following files: