Eclipse SUMO - Simulation of Urban MObility
FileHelpers Class Reference

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

#include <FileHelpers.h>

Collaboration diagram for FileHelpers:

Static Public Member Functions

file access functions
static bool isReadable (std::string path)
 Checks whether the given file is readable. 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 addExtension (const std::string &path, const std::string &extension)
 Add an extension to the given file 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...
 
static std::string prependToLastPathComponent (const std::string &prefix, const std::string &path)
 prepend the given prefix to the last path component of the given file path More...
 
binary writing functions
static std::ostream & writeInt (std::ostream &strm, int value)
 Writes an integer binary. More...
 
static std::ostream & writeFloat (std::ostream &strm, double 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 41 of file FileHelpers.h.

Member Function Documentation

◆ addExtension()

std::string FileHelpers::addExtension ( const std::string &  path,
const std::string &  extension 
)
static

Add an extension to the given file path.

Parameters
[in]pathThe path to the file
[in]extensionnew extension (with dot, example: '.xml')
Returns
the new path with extension, the same path if it already has the extension, or a empty string if path is invalid

Definition at line 77 of file FileHelpers.cpp.

Referenced by GNEApplicationWindow::computeJunctionWithVolatileOptions(), GNEApplicationWindow::onCmdSaveAdditionals(), GNEApplicationWindow::onCmdSaveAdditionalsAs(), GNEApplicationWindow::onCmdSaveAsNetwork(), GNEApplicationWindow::onCmdSaveDemandElements(), GNEApplicationWindow::onCmdSaveDemandElementsAs(), GNEApplicationWindow::onCmdSaveJoined(), GNEApplicationWindow::onCmdSaveTLSPrograms(), and GNEApplicationWindow::onCmdSaveTLSProgramsAs().

◆ checkForRelativity()

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 143 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(), NLDiscreteEventBuilder::buildSaveTLSwitchStatesCommand(), MSActuatedTrafficLightLogic::MSActuatedTrafficLightLogic(), MSDelayBasedTrafficLightLogic::MSDelayBasedTrafficLightLogic(), and OptionsCont::relocateFiles().

◆ getConfigurationRelative()

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 106 of file FileHelpers.cpp.

References getFilePath().

Referenced by ShapeHandler::addPOI(), ShapeHandler::addPoly(), SUMOVehicleParserHelper::beginVTypeParsing(), checkForRelativity(), NWFrame::checkOptions(), NLTriggerBuilder::getFileName(), main(), GUISettingsHandler::myStartElement(), GNEAdditionalHandler::parseAndBuildPOI(), GNEAdditionalHandler::parseAndBuildPoly(), and GenericSAXHandler::startElement().

◆ getFilePath()

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 67 of file FileHelpers.cpp.

Referenced by GNEAdditionalHandler::buildRerouter(), getConfigurationRelative(), GNEAdditional::writeAdditional(), RODFDetectorCon::writeEmitters(), RODFDetectorCon::writeSpeedTrigger(), PointOfInterest::writeXML(), and SUMOPolygon::writeXML().

◆ isAbsolute()

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 120 of file FileHelpers.cpp.

References isSocket().

Referenced by ShapeHandler::addPOI(), ShapeHandler::addPoly(), SUMOVehicleParserHelper::beginVTypeParsing(), checkForRelativity(), NLTriggerBuilder::getFileName(), GUISettingsHandler::myStartElement(), GNEAdditionalHandler::parseAndBuildPOI(), GNEAdditionalHandler::parseAndBuildPoly(), and GenericSAXHandler::startElement().

◆ isReadable()

◆ isSocket()

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 113 of file FileHelpers.cpp.

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

◆ prependToLastPathComponent()

std::string FileHelpers::prependToLastPathComponent ( const std::string &  prefix,
const std::string &  path 
)
static

prepend the given prefix to the last path component of the given file path

Definition at line 161 of file FileHelpers.cpp.

Referenced by OutputDevice::getDevice().

◆ readEdgeVector()

template<typename E >
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

Definition at line 256 of file FileHelpers.h.

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

◆ writeByte()

std::ostream & FileHelpers::writeByte ( std::ostream &  strm,
unsigned char  value 
)
static

◆ writeEdgeVector()

template<typename E >
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

Definition at line 200 of file FileHelpers.h.

References writeInt().

Referenced by BinaryFormatter::writeAttr().

◆ writeFloat()

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

Writes a float binary.

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

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

Definition at line 182 of file FileHelpers.cpp.

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

◆ writeInt()

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 175 of file FileHelpers.cpp.

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

◆ writeString()

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 196 of file FileHelpers.cpp.

References writeInt().

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

◆ writeTime()

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 206 of file FileHelpers.cpp.


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