StringUtils Class Reference

Some static methods for string processing. More...

#include <StringUtils.h>

Static Public Member Functions
static std::string	charToHex (unsigned char c)
	char to hexadecimal More...
static std::string	convertUmlaute (std::string str)
	Converts german "Umlaute" to their latin-version. More...
static bool	endsWith (const std::string &str, const std::string suffix)
	Checks whether a given string ends with the suffix. More...
static std::string	escapeXML (const std::string &orig, const bool maskDoubleHyphen=false)
	Replaces the standard escapes by their XML entities. More...
template<typename T , typename... Targs>
static const std::string	format (const std::string &format, T value, Targs... Fargs)
	adds a new formatted message More...
static unsigned char	hexToChar (const std::string &str)
	hexadecimal to char More...
static int	hexToInt (const std::string &sData)
	converts a string with a hex value into the integer value described by it by calling the char-type converter More...
static std::string	latin1_to_utf8 (std::string str)
	Transfers from Latin 1 (ISO-8859-1) to UTF-8. More...
static std::string	padFront (const std::string &str, int length, char padding)
static std::string	prune (const std::string &str)
	Removes trailing and leading whitechars. More...
static std::string	pruneZeros (const std::string &str, int max)
	Removes trailing zeros (at most 'max') More...
static std::string	replace (std::string str, const std::string &what, const std::string &by)
	Replaces all occurrences of the second string by the third string within the first string. More...
static void	resetTranscoder ()
	must be called when shutting down the xml subsystem More...
static bool	startsWith (const std::string &str, const std::string prefix)
	Checks whether a given string starts with the prefix. More...
static std::string	substituteEnvironment (const std::string &str, const std::chrono::time_point< std::chrono::system_clock > *const timeRef=nullptr)
	Replaces an environment variable with its value (similar to bash); syntax for a variable is ${NAME}. More...
static std::string	to_lower_case (const std::string &str)
	Transfers the content to lower case. More...
static bool	toBool (const std::string &sData)
	converts a string into the bool value described by it by calling the char-type converter More...
static double	toDouble (const std::string &sData)
	converts a string into the double value described by it by calling the char-type converter More...
static double	toDoubleSecure (const std::string &sData, const double def)
	converts a string into the integer value described by it More...
static int	toInt (const std::string &sData)
	converts a string into the integer value described by it by calling the char-type converter, which More...
static int	toIntSecure (const std::string &sData, int def)
	converts a string into the integer value described by it More...
static long long int	toLong (const std::string &sData)
	converts a string into the long value described by it by calling the char-type converter, which More...
static MMVersion	toVersion (const std::string &sData)
	to version More...
static std::string	transcode (const XMLCh *const data)
	converts a 0-terminated XMLCh* array (usually UTF-16, stemming from Xerces) into std::string in UTF-8 More...
static std::string	transcode (const XMLCh *const data, int length)
	converts a 0-terminated XMLCh* array (usually UTF-16, stemming from Xerces) into std::string in UTF-8 considering the given length More...
static std::string	transcodeFromLocal (const std::string &localString)
	convert a string from the local codepage to UTF-8 More...
static std::string	transcodeToLocal (const std::string &utf8String)
	convert a string from UTF-8 to the local codepage More...
static std::string	trim (const std::string s, const std::string &t=" \t\n")
	remove leading and trailing whitespace More...
static std::string	trim_left (const std::string s, const std::string &t=" \t\n")
	remove leading whitespace from string More...
static std::string	trim_right (const std::string s, const std::string &t=" \t\n")
	remove trailing whitespace from string More...
static std::string	urlDecode (const std::string &encoded)
	decode url (stem from http://bogomip.net/blog/cpp-url-encoding-and-decoding/) More...
static std::string	urlEncode (const std::string &url, const std::string encodeWhich="")
	encode url (stem from http://bogomip.net/blog/cpp-url-encoding-and-decoding/) More...

Static Public Attributes
static std::string	emptyString
	An empty string. More...

Static Private Member Functions
static void	_format (const char *format, std::ostringstream &os)
template<typename T , typename... Targs>
static void	_format (const char *format, std::ostringstream &os, T value, Targs... Fargs)
	adds a new formatted message More...

Static Private Attributes
static XERCES_CPP_NAMESPACE::XMLLCPTranscoder *	myLCPTranscoder = nullptr

Detailed Description

Some static methods for string processing.

Definition at line 40 of file StringUtils.h.

Member Function Documentation

_format() [1/2]

static void StringUtils::_format ( const char *  format, std::ostringstream &  os  )

inlinestaticprivate

Definition at line 184 of file StringUtils.h.

References format().

Referenced by _format(), and format().

Here is the caller graph for this function:

_format() [2/2]

template<typename T , typename... Targs>

static void StringUtils::_format ( const char *  format, std::ostringstream &  os, T  value, Targs...  Fargs  )

inlinestaticprivate

adds a new formatted message

Definition at line 191 of file StringUtils.h.

References _format(), and format().

charToHex()

std::string StringUtils::charToHex ( unsigned char  c )

static

char to hexadecimal

Definition at line 290 of file StringUtils.cpp.

Referenced by urlEncode().

Here is the caller graph for this function:

convertUmlaute()

std::string StringUtils::convertUmlaute ( std::string  str )

static

Converts german "Umlaute" to their latin-version.

Definition at line 104 of file StringUtils.cpp.

References replace().

Referenced by PCLoaderDlrNavteq::loadPolyFile(), NIImporter_Vissim::VissimSingleTypeParser::readName(), and NBEdge::reinit().

Here is the caller graph for this function:

endsWith()

bool StringUtils::endsWith ( const std::string &  str, const std::string  suffix  )

static

Checks whether a given string ends with the suffix.

Definition at line 216 of file StringUtils.cpp.

Referenced by NIImporter_VISUM::getNamedFloat(), MSBaseVehicle::getPrefixedParameter(), LandmarkLookupTable< E, V >::LandmarkLookupTable(), NIImporter_Vissim::load(), and NIImporter_OpenStreetMap::EdgesHandler::myStartElement().

Here is the caller graph for this function:

escapeXML()

std::string StringUtils::escapeXML ( const std::string &  orig, const bool  maskDoubleHyphen = false  )

static

Replaces the standard escapes by their XML entities.

The strings &, <, >, ", and ' are replaced by &, <, >, ", and '

Parameters

[in]	orig	The original string
[in]	maskDoubleHyphen	Whether – in input shall be converted to -- (semantically equivalent but allowed in XML comments)

Returns

the string with the escaped sequences

Definition at line 232 of file StringUtils.cpp.

References replace().

Referenced by NBPTStop::addLine(), PCLoaderOSM::addPOI(), PCLoaderOSM::addPolygon(), NIImporter_OpenStreetMap::insertEdge(), MSStageDriving::routeOutput(), MSStageTranship::routeOutput(), MSStageWaiting::routeOutput(), MSStageWalking::routeOutput(), RODFDetectorCon::save(), RODFDetectorCon::saveAsPOIs(), NBPTLine::write(), NBPTStop::write(), MSFCDExport::write(), GNEBusStop::writeAdditional(), GNEChargingStation::writeAdditional(), GNEContainerStop::writeAdditional(), GNEInductionLoopDetector::writeAdditional(), GNEInstantInductionLoopDetector::writeAdditional(), GNELaneAreaDetector::writeAdditional(), GNEMultiEntryExitDetector::writeAdditional(), GNEParkingArea::writeAdditional(), GNEParkingSpace::writeAdditional(), GNERerouter::writeAdditional(), GNEVaporizer::writeAdditional(), GNEVariableSpeedSign::writeAdditional(), OptionsCont::writeConfiguration(), NWWriter_SUMO::writeEdge(), NWWriter_XML::writeEdgesAndConnections(), RODFDetectorCon::writeEmitterPOIs(), RODFDetectorCon::writeEmitters(), RODFDetectorCon::writeEndRerouterDetectors(), NWWriter_SUMO::writeJunction(), NWWriter_XML::writeNodes(), NWWriter_OpenDrive::writeNormalEdge(), Parameterised::writeParams(), NWWriter_OpenDrive::writeRoadObjectPOI(), NWWriter_OpenDrive::writeRoadObjectPoly(), RODFDetectorCon::writeSpeedTrigger(), NWWriter_SUMO::writeTrafficLight(), RODFDetectorCon::writeValidationDetectors(), SUMOPolygon::writeXML(), PointOfInterest::writeXML(), MEInductLoop::writeXMLOutput(), and MSInductLoop::writeXMLOutput().

Here is the caller graph for this function:

format()

template<typename T , typename... Targs>

static const std::string StringUtils::format ( const std::string &  format, T  value, Targs...  Fargs  )

inlinestatic

adds a new formatted message

Definition at line 176 of file StringUtils.h.

References _format(), and gPrecision.

Referenced by _format(), SUMORTree::addAdditionalGLObject(), GNEAdditional::checkChildAdditionalRestriction(), GNEDemandElement::checkChildDemandElementRestriction(), MsgHandler::informf(), and SUMORTree::removeAdditionalGLObject().

Here is the caller graph for this function:

hexToChar()

unsigned char StringUtils::hexToChar ( const std::string &  str )

static

hexadecimal to char

Definition at line 302 of file StringUtils.cpp.

Referenced by urlDecode().

Here is the caller graph for this function:

hexToInt()

int StringUtils::hexToInt ( const std::string &  sData )

static

converts a string with a hex value into the integer value described by it by calling the char-type converter

Exceptions

an	EmptyData - exception if the given string is empty
a	NumberFormatException - exception when the string does not contain an integer

Definition at line 359 of file StringUtils.cpp.

Referenced by NIImporter_Vissim::NIVissimXMLHandler_Fahrzeugklassendefinition::myEndElement(), and RGBColor::parseColor().

Here is the caller graph for this function:

latin1_to_utf8()

std::string StringUtils::latin1_to_utf8 ( std::string  str )

static

Transfers from Latin 1 (ISO-8859-1) to UTF-8.

Definition at line 87 of file StringUtils.cpp.

Referenced by PCLoaderArcView::load(), NIImporter_VISUM::parse_Edges(), and NIImporter_VISUM::parse_stopPoints().

Here is the caller graph for this function:

padFront()

std::string StringUtils::padFront ( const std::string &  str, int  length, char  padding  )

static

Definition at line 226 of file StringUtils.cpp.

References MAX2().

Referenced by GUITLLogicPhasesTrackerWindow::drawValues().

Here is the caller graph for this function:

prune()

std::string StringUtils::prune ( const std::string &  str )

static

Removes trailing and leading whitechars.

Definition at line 56 of file StringUtils.cpp.

Referenced by MSRailSignalConstraint_Predecessor::getDescription(), ODMatrix::getNextNonCommentLine(), NIImporter_OpenStreetMap::EdgesHandler::interpretSpeed(), PCLoaderArcView::load(), PCLoaderDlrNavteq::loadPOIFile(), PCLoaderDlrNavteq::loadPolyFile(), main(), NIImporter_ITSUMO::Handler::myCharacters(), NIImporter_OpenStreetMap::EdgesHandler::myStartElement(), GUIDialog_Breakpoints::onCmdEditTable(), ODMatrix::readO(), ODMatrix::readV(), Option_StringVector::set(), GNETLSEditorFrame::TLSPhases::setEarliestEnd(), GNETLSEditorFrame::TLSPhases::setLatestEnd(), GNETLSEditorFrame::TLSPhases::setMaxDur(), GNETLSEditorFrame::TLSPhases::setMinDur(), GNETLSEditorFrame::TLSPhases::setRed(), GNETLSEditorFrame::TLSPhases::setVehExt(), and GNETLSEditorFrame::TLSPhases::setYellow().

Here is the caller graph for this function:

pruneZeros()

std::string StringUtils::pruneZeros ( const std::string &  str, int  max  )

static

Removes trailing zeros (at most 'max')

Definition at line 67 of file StringUtils.cpp.

References MAX2().

Referenced by SUMOVehicleParameter::getDepartPos(), SUMOVehicleParameter::getDepartPosLat(), and SUMOVehicleParameter::getDepartSpeed().

Here is the caller graph for this function:

replace()

std::string StringUtils::replace ( std::string  str, const std::string &  what, const std::string &  by  )

static

Replaces all occurrences of the second string by the third string within the first string.

Definition at line 121 of file StringUtils.cpp.

Referenced by AStarRouter< E, V >::compute(), convertUmlaute(), escapeXML(), GeoConvHelper::getLoadedPlain(), PHEMlightdllV5::Correction::GetMileage(), PHEMlightdllV5::Correction::IniDETfactor(), PHEMlightdllV5::Correction::IniTNOxfactor(), NIImporter_ArcView::load(), GNESelectorFrame::SelectionOperation::loadFromFile(), GUISelectedStorage::loadIDs(), GNEApplicationWindowHelper::GNENeteditConfigHandler::loadNeteditConfig(), GNEApplicationWindowHelper::GNESumoConfigHandler::loadSumoConfig(), GNEApplicationWindow::onCmdSaveNeteditConfig(), GNEApplicationWindow::onCmdSavePlainXMLAs(), GNEApplicationWindow::onCmdSaveSumoConfig(), GUIGLObjectPopupMenu::onCmdShowCursorGeoPositionOnline(), GNEFrameAttributeModules::AttributesEditorRow::stripWhitespaceAfterComma(), substituteEnvironment(), and GNEAttributeCarrier::writeAttributeHelp().

Here is the caller graph for this function:

resetTranscoder()

void StringUtils::resetTranscoder ( )

static

must be called when shutting down the xml subsystem

Definition at line 509 of file StringUtils.cpp.

References myLCPTranscoder.

Referenced by XMLSubSys::close().

Here is the caller graph for this function:

startsWith()

bool StringUtils::startsWith ( const std::string &  str, const std::string  prefix  )

static

Checks whether a given string starts with the prefix.

Definition at line 210 of file StringUtils.cpp.

Referenced by NLHandler::addEdgeLaneMeanData(), MSDevice_Taxi::compatibleLine(), NBNodeCont::customTLID(), GUISUMOAbstractView::displayColorLegend(), EnergyParams::EnergyParams(), MSDevice_Tripinfo::getGlobalParameter(), MSDevice_Routing::getParameter(), MSActuatedTrafficLightLogic::getParameter(), NEMALogic::getParameter(), LIBSUMO_NAMESPACE::Simulation::getParameter(), MSBaseVehicle::getPrefixedParameter(), NWWriter_DlrNavteq::getRoadClass(), MSActuatedTrafficLightLogic::init(), MSDevice_SSM::initEdgeFilter(), MSDevice_FCD::initOnce(), MSBaseVehicle::initTransientModelParams(), NIImporter_OpenStreetMap::interpretDistance(), MSDevice_Taxi::isReservation(), NBHelpers::loadEdgesFromFile(), GNESelectorFrame::SelectionOperation::loadFromFile(), GUISelectedStorage::loadIDs(), NBHelpers::loadPrefixedIDsFomFile(), GUISettingsHandler::myStartElement(), NIImporter_OpenStreetMap::NodesHandler::myStartElement(), NIImporter_OpenStreetMap::EdgesHandler::myStartElement(), GUIDialog_ViewSettings::onCmdSaveSetting(), NBEdgeCont::remapIDs(), NBNodeCont::remapIDs(), SUMOSAXReader::LocalSchemaResolver::resolveEntity(), MSDevice_Routing::setParameter(), MSActuatedTrafficLightLogic::setParameter(), NEMALogic::setParameter(), and NIImporter_OpenStreetMap::usableType().

Here is the caller graph for this function:

substituteEnvironment()

std::string StringUtils::substituteEnvironment ( const std::string &  str, const std::chrono::time_point< std::chrono::system_clock > *const  timeRef = nullptr  )

static

Replaces an environment variable with its value (similar to bash); syntax for a variable is ${NAME}.

Definition at line 136 of file StringUtils.cpp.

References replace(), and toString().

Referenced by OutputDevice::getDevice(), GUISettingsHandler::myStartElement(), and OptionsCont::set().

Here is the caller graph for this function:

to_lower_case()

std::string StringUtils::to_lower_case ( const std::string &  str )

static

Transfers the content to lower case.

Definition at line 77 of file StringUtils.cpp.

Referenced by NamedColumnsParser::get(), HelpersPHEMlight::getClassByName(), HelpersPHEMlight5::getClassByName(), PollutantsInterface::Helper::getClassByName(), GNEOptionsDialogElements::InputOption::getDescriptionLower(), GNEOptionsDialogElements::InputOption::getNameLower(), NIImporter_VISUM::getPermissions(), HelpersHBEFA3::HelpersHBEFA3(), NIImporter_OpenStreetMap::EdgesHandler::interpretSpeed(), NamedColumnsParser::know(), MSSwarmTrafficLightLogic::MSSwarmTrafficLightLogic(), NIImporter_Vissim::VissimSingleTypeParser::myRead(), GUISettingsHandler::myStartElement(), RGBColor::parseColor(), OptionsCont::printHelp(), NIImporter_Vissim::readContents(), NIImporter_Vissim::VissimSingleTypeParser::readEndSecure(), NIImporter_DlrNavteq::readVersion(), NamedColumnsParser::reinitMap(), toBool(), GNEOptionsDialog::updateVisibleEntriesBySearch(), GNEAttributeCarrier::writeAttributeHelp(), OptionsCont::writeConfiguration(), and OptionsCont::writeSchema().

Here is the caller graph for this function:

toBool()

bool StringUtils::toBool ( const std::string &  sData )

static

converts a string into the bool value described by it by calling the char-type converter

Returns

true if the data* is one of the following (case insensitive): '1', 'x', 'true', 'yes', 'on', 't'

false if the data* is one of the following (case insensitive): '0', '-', 'false', 'no', 'off', 'f'

Exceptions

EmptyData	- exception if the given string is empty or 0 pointer
BoolFormatException	in any other case

Definition at line 412 of file StringUtils.cpp.

References to_lower_case().

Referenced by NBRailwayTopologyAnalyzer::addBidiEdgesForBufferStops(), MSVehicleType::check(), MSDevice::equippedByDefaultAssignmentOptions(), SUMOSAXAttributes::getBool(), MSDevice::getBoolParam(), NBRailwayTopologyAnalyzer::getBrokenRailNodes(), GUIVehicle::getColorValue(), GNELane::getColorValue(), GUIEdge::getColorValue(), GUILane::getColorValue(), GUIBaseVehicle::getScaleValue(), NIImporter_VISUM::getWeightedBool(), NEMALogic::init(), MSSOTLTrafficLightLogic::isDecayThresholdActivated(), MSActuatedTrafficLightLogic::MSActuatedTrafficLightLogic(), MSDelayBasedTrafficLightLogic::MSDelayBasedTrafficLightLogic(), MSSimpleTrafficLightLogic::MSSimpleTrafficLightLogic(), PCTypeDefHandler::myStartElement(), GUISettingsHandler::myStartElement(), NIImporter_OpenStreetMap::EdgesHandler::myStartElement(), NEMALogic::NEMALogic(), GNEOptionsDialogElements::InputBool::onCmdResetOption(), NIImporter_VISUM::parse_Edges(), NIImporter_VISUM::parse_TrafficLights(), SUMOVehicleParameter::parseParkingType(), GUISettingsHandler::parseSizeSettings(), SUMOVehicleParameter::parseStopTriggers(), GUISettingsHandler::parseTextSettings(), MSDevice_SSM::requestsTrajectories(), Option_Bool::set(), Option_BoolExtended::set(), MSDevice_ToC::setParameter(), MSActuatedTrafficLightLogic::setParameter(), MSRailSignal::setParameter(), MSSimpleTrafficLightLogic::setParameter(), LIBSUMO_NAMESPACE::Vehicle::setStopParameter(), TemplateHandler::startElement(), MSDevice_SSM::useGeoCoords(), MSDevice_SSM::writeLanesPositions(), and MSDevice_SSM::writePositions().

Here is the caller graph for this function:

toDouble()

double StringUtils::toDouble ( const std::string &  sData )

static

converts a string into the double value described by it by calling the char-type converter

Exceptions

an	EmptyData - exception if the given string is empty
a	NumberFormatException - exception when the string does not contain a double

Definition at line 383 of file StringUtils.cpp.

Referenced by MSTLLogicControl::WAUTSwitchProcedure_Stretch::adaptLogic(), NIXMLPTHandler::addPTLine(), NBEdgeCont::applyOptions(), MSDevice_ElecHybrid::buildVehicleDevices(), MSDevice_Example::buildVehicleDevices(), ROEdge::cacheParamRestrictions(), SUMOVTypeParameter::cacheParamRestrictions(), MSFrame::checkOptions(), MSDevice::equippedByDefaultAssignmentOptions(), MSActuatedTrafficLightLogic::evalAtomicExpression(), MSPModel_JuPedSim::execute(), LIBSUMO_NAMESPACE::Simulation::findIntermodalRoute(), MSSwarmTrafficLightLogic::getBetaNo(), MSSwarmTrafficLightLogic::getBetaSp(), SUMOVTypeParameter::getCFParam(), MSSwarmTrafficLightLogic::getChangePlanProbability(), GUIVehicle::getColorValue(), GNEEdgeData::getColorValue(), GNEEdgeRelData::getColorValue(), GNETAZRelData::getColorValue(), GNELane::getColorValue(), GUIEdge::getColorValue(), GUILane::getColorValue(), MSSOTLTrafficLightLogic::getDecayConstant(), MSDevice_SSM::getDetectionRange(), NGNet::getDistribution(), Parameterised::getDouble(), Parameterised::getDoubles(), MSDevice_SSM::getExtraTime(), SUMOSAXAttributesImpl_Cached::getFloat(), SUMOSAXAttributesImpl_Xerces::getFloat(), SUMOSAXAttributes::getFloat(), MSSwarmTrafficLightLogic::getForgettingCox(), MSSwarmTrafficLightLogic::getGammaNo(), MSSwarmTrafficLightLogic::getGammaSp(), MSSOTLTrafficLightLogic::getInputSensorsLength(), SUMOVTypeParameter::getJMParam(), SUMOVTypeParameter::getLCParam(), MSSwarmTrafficLightLogic::getLearningCox(), MSDevice_SSM::getMDRAC_PRT(), MSDevice_SSM::getMeasuresAndThresholds(), NIImporter_VISUM::getNamedFloat(), MSSOTLTrafficLightLogic::getOutputSensorsLength(), MSSwarmTrafficLightLogic::getPheroMaxVal(), GUIBaseVehicle::getScaleValue(), MSSOTLTrafficLightLogic::getSpeedThreshold(), MSSwarmTrafficLightLogic::getThetaInit(), MSSwarmTrafficLightLogic::getThetaMax(), MSSwarmTrafficLightLogic::getThetaMin(), getTurningDefaults(), MSCFModel_Rail::getValueTable(), MSTriggeredRerouter::getWeight(), NIImporter_VISUM::getWeightedFloat(), MSRailCrossing::init(), MSSwarmTrafficLightLogic::init(), MSActuatedTrafficLightLogic::init(), PushButtonLogic::init(), SigmoidLogic::init(), SUMOVTypeParameter::initRailVisualizationParameters(), NIImporter_OpenStreetMap::interpretDistance(), NIImporter_OpenStreetMap::EdgesHandler::interpretSpeed(), LandmarkLookupTable< E, V >::LandmarkLookupTable(), PCLoaderVisum::load(), PCLoaderDlrNavteq::loadPolyFile(), main(), MSActuatedTrafficLightLogic::MSActuatedTrafficLightLogic(), MSDelayBasedTrafficLightLogic::MSDelayBasedTrafficLightLogic(), MSSimpleTrafficLightLogic::MSSimpleTrafficLightLogic(), MSSOTLPolicy::MSSOTLPolicy(), NIImporter_ITSUMO::Handler::myEndElement(), NIImporter_Vissim::NIVissimXMLHandler_Streckendefinition::myEndElement(), NIImporter_Vissim::NIVissimXMLHandler_Geschwindigkeitsverteilungsdefinition::myEndElement(), GUISettingsHandler::myStartElement(), NIImporter_OpenStreetMap::NodesHandler::myStartElement(), NIImporter_OpenStreetMap::EdgesHandler::myStartElement(), NEMALogic::NEMALogic(), MSDevice_GLOSA::notifyEnter(), MFXDecalsTable::onCmdEditRowString(), Distribution_Parameterized::parse(), NIVissimSingleTypeParser_Geschwindigkeitsverteilungsdefinition::parse(), NIVissimSingleTypeParser_Laengenverteilungsdefinition::parse(), NIVissimSingleTypeParser_Simdauer::parse(), NIVissimSingleTypeParser_Streckendefinition::parse(), NIVissimSingleTypeParser_Verbindungsdefinition::parse(), NIVissimSingleTypeParser_Zeitenverteilungsdefinition::parse(), NIImporter_VISUM::parse_Edges(), NIImporter_VISUM::parse_Lanes(), NIImporter_VISUM::parse_Point(), NIImporter_VISUM::parse_stopPoints(), NLTriggerBuilder::parseAndBuildRerouter(), SUMOVehicleParameter::parseArrivalPos(), SUMOVehicleParameter::parseArrivalPosLat(), SUMOVehicleParameter::parseArrivalSpeed(), GeomConvHelper::parseBoundaryReporting(), SUMOVehicleParserHelper::parseCFMParams(), RGBColor::parseColor(), SUMOVehicleParameter::parseDepartPos(), SUMOVehicleParameter::parseDepartPosLat(), SUMOVehicleParameter::parseDepartSpeed(), GNEOptionsDialogElements::InputFloat::parseFloat(), SUMOVehicleParserHelper::parseFlowAttributes(), SUMOVehicleParserHelper::parseJMParams(), SUMOVTypeParameter::parseLatAlignment(), SUMOVehicleParserHelper::parseLCParams(), GenericEngineModel::parseParameter(), GeomConvHelper::parseShapeReporting(), GUISettingsHandler::parseSizeSettings(), GUISettingsHandler::parseTextSettings(), ODMatrix::parseTimeLine(), RODFDetFlowLoader::read(), ODMatrix::readFactor(), ODMatrix::readO(), MSDevice_Battery::readParameterValue(), ODMatrix::readV(), NIImporter_DlrNavteq::readVersion(), NIImporter_DlrNavteq::EdgesHandler::report(), Option_Float::set(), MSFrame::setMSGlobals(), MSDevice_Battery::setParameter(), MSDevice_Bluelight::setParameter(), MSDevice_DriverState::setParameter(), MSDevice_ElecHybrid::setParameter(), MSDevice_Example::setParameter(), MSDevice_Friction::setParameter(), MSDevice_GLOSA::setParameter(), MSDevice_Routing::setParameter(), MSDevice_SSM::setParameter(), MSDevice_Taxi::setParameter(), MSTransportableDevice_Routing::setParameter(), MSRailCrossing::setParameter(), MSDevice_ToC::setParameter(), MSLCM_LC2013::setParameter(), MSLCM_SL2015::setParameter(), MSActuatedTrafficLightLogic::setParameter(), NEMALogic::setParameter(), MSCFModel_CC::setParameter(), LIBSUMO_NAMESPACE::Vehicle::setStopParameter(), MSTLLogicControl::WAUTSwitchProcedure_Stretch::stretchLogic(), string2time(), toDoubleSecure(), toVersion(), MSTLLogicControl::WAUTSwitchProcedure_Stretch::WAUTSwitchProcedure_Stretch(), and RODFDetector::writeEmitterDefinition().

toDoubleSecure()

double StringUtils::toDoubleSecure ( const std::string &  sData, const double  def  )

static

converts a string into the integer value described by it

Returns

the default value if the data is empty

Definition at line 403 of file StringUtils.cpp.

References toDouble().

Referenced by MSRouteHandler::openRouteDistribution(), MSRouteHandler::openVehicleTypeDistribution(), RORouteHandler::openVehicleTypeDistribution(), and NWWriter_OpenDrive::writeRoadObjectPoly().

Here is the caller graph for this function:

toInt()

int StringUtils::toInt ( const std::string &  sData )

static

converts a string into the integer value described by it by calling the char-type converter, which

Exceptions

an	EmptyData - exception if the given string is empty
NumberFormatException	- exception when the string does not contain an integer

Definition at line 316 of file StringUtils.cpp.

References toLong(), and toString().

Referenced by NIXMLPTHandler::addPTLine(), NIXMLEdgesHandler::addSplit(), FareModul::addStop(), NBOwnTLDef::buildNemaPhases(), NEMALogic::constructTimingAndPhaseDefs(), MSActuatedTrafficLightLogic::evalAtomicExpression(), OutputDevice::getDevice(), SUMOXMLDefinitions::getIndexFromLane(), SUMOSAXAttributes::getInt(), NBEdge::getLaneIndexFromLaneID(), NINavTeqHelper::getLaneNumber(), MSSwarmTrafficLightLogic::getMaxCongestionDuration(), MSSOTLRequestPolicy::getMinDecisionalPhaseDuration(), MSSOTLTrafficLightLogic::getMode(), MSSwarmTrafficLightLogic::getReinforcementMode(), NINavTeqHelper::getSpeed(), MSSOTLTrafficLightLogic::getThreshold(), MSSwarmTrafficLightLogic::init(), MSActuatedTrafficLightLogic::init(), MSBaseVehicle::initTransientModelParams(), NBHelpers::interpretLaneID(), PCLoaderVisum::load(), NIImporter_OpenDrive::loadNetwork(), NIImporter_ITSUMO::Handler::myEndElement(), NIImporter_OpenDrive::myEndElement(), NIImporter_Vissim::NIVissimXMLHandler_Streckendefinition::myEndElement(), NIImporter_Vissim::NIVissimXMLHandler_Fahrzeugklassendefinition::myEndElement(), MSStateHandler::myStartElement(), NIImporter_MATSim::EdgesHandler::myStartElement(), GUISettingsHandler::myStartElement(), NIImporter_OpenStreetMap::EdgesHandler::myStartElement(), GNEOptionsDialogElements::InputIntVector::onCmdSetOption(), GNEAttributeCarrier::parse(), NIVissimSingleTypeParser_Fahrzeugklassendefinition::parse(), NIVissimSingleTypeParser_Fahrzeugtypdefinition::parse(), NIVissimSingleTypeParser_Kantensperrung::parse(), NIVissimSingleTypeParser_Knotendefinition::parse(), NIVissimSingleTypeParser_Streckendefinition::parse(), NIVissimSingleTypeParser_Verbindungsdefinition::parse(), NIVissimSingleTypeParser_VWunschentscheidungsdefinition::parse(), NIImporter_VISUM::parse_EdgePolys(), NIImporter_VISUM::parse_Edges(), NIImporter_VISUM::parse_Lanes(), NIImporter_VISUM::parse_LanesConnections(), NIImporter_VISUM::parse_Types(), SUMOVehicleParserHelper::parseAngleTimesMap(), SUMOVehicleParameter::parseArrivalLane(), NIImporter_Vissim::VissimSingleTypeParser::parseAssignedVehicleTypes(), RGBColor::parseColor(), SUMOVehicleParameter::parseDepartLane(), GenericEngineModel::parseParameter(), NIVissimSingleTypeParser_Querverkehrsstoerungsdefinition::parsePos(), SUMOVehicleParameter::parseRouteIndex(), ODMatrix::parseSingleTime(), NIImporter_DlrNavteq::readDate(), NIImporter_Vissim::VissimSingleTypeParser::readExtEdgePointDef(), ODMatrix::readO(), ODMatrix::readV(), NIImporter_DlrNavteq::EdgesHandler::report(), NIImporter_DlrNavteq::ConnectedLanesHandler::report(), Option_Integer::set(), Option_IntVector::set(), MSCFModel_CC::setParameter(), NIVissimConflictArea::setPriorityRegulation(), LIBSUMO_NAMESPACE::Vehicle::setStopParameter(), MSSOTLE2Sensors::setVehicleWeigths(), GUIMainWindow::setWindowSizeAndPos(), toIntSecure(), toVersion(), NWWriter_SUMO::writeInternalNodes(), and NWWriter_DlrNavteq::writeLinksUnsplitted().

toIntSecure()

int StringUtils::toIntSecure ( const std::string &  sData, int  def  )

static

converts a string into the integer value described by it

Returns

the default value if the data is empty

Definition at line 326 of file StringUtils.cpp.

References toInt().

Referenced by NIXMLConnectionsHandler::parseDeprecatedLaneDefinition().

Here is the caller graph for this function:

toLong()

long long int StringUtils::toLong ( const std::string &  sData )

static

converts a string into the long value described by it by calling the char-type converter, which

Exceptions

an	EmptyData - exception if the given string is empty
NumberFormatException	- exception when the string does not contain a long integer

Definition at line 335 of file StringUtils.cpp.

Referenced by SUMOSAXAttributes::getLong(), NIImporter_OpenStreetMap::insertEdge(), PCLoaderVisum::load(), MSDevice_Vehroutes::loadState(), MSStateHandler::myStartElement(), NIImporter_OpenStreetMap::NodesHandler::myStartElement(), NIImporter_VISUM::parse_AreaSubPartElement(), NIImporter_VISUM::parse_Districts(), NIImporter_VISUM::parse_Kante(), NIImporter_VISUM::parse_PartOfArea(), NIImporter_VISUM::parse_Point(), NBEdgeCont::remapIDs(), NBNodeCont::remapIDs(), and toInt().

Here is the caller graph for this function:

toVersion()

MMVersion StringUtils::toVersion ( const std::string &  sData )

static

to version

Definition at line 427 of file StringUtils.cpp.

References StringTokenizer::getVector(), toDouble(), and toInt().

Referenced by NIImporter_SUMO::myStartElement(), NLHandler::myStartElement(), and RONetHandler::myStartElement().

Here is the caller graph for this function:

transcode() [1/2]

static std::string StringUtils::transcode ( const XMLCh *const  data )

inlinestatic

converts a 0-terminated XMLCh* array (usually UTF-16, stemming from Xerces) into std::string in UTF-8

Exceptions

an	EmptyData - exception if the given pointer is 0

Definition at line 146 of file StringUtils.h.

Referenced by OptionsLoader::characters(), GenericHandler::characters(), GenericSAXHandler::characters(), SUMOSAXAttributesImpl_Xerces::clone(), GenericHandler::endElement(), GenericSAXHandler::endElement(), TemplateHandler::error(), OptionsLoader::error(), TemplateHandler::fatalError(), OptionsLoader::fatalError(), SUMOSAXAttributesImpl_Xerces::getAttributeNames(), SUMOSAXAttributesImpl_Xerces::getFloat(), OptionsIO::getRoot(), SUMOSAXAttributesImpl_Xerces::getString(), SUMOSAXAttributesImpl_Xerces::getStringSecure(), XMLSubSys::init(), NITypeLoader::load(), OptionsIO::loadConfiguration(), GNEOptionsDialog::loadConfiguration(), GNEPythonTool::loadConfiguration(), GNEApplicationWindowHelper::GNENeteditConfigHandler::loadNeteditConfig(), GNEApplicationWindowHelper::GNESumoConfigHandler::loadSumoConfig(), main(), TemplateHandler::parseTemplate(), SUMOSAXReader::LocalSchemaResolver::resolveEntity(), XMLSubSys::runParser(), SUMOSAXAttributesImpl_Xerces::serialize(), TemplateHandler::startElement(), OptionsLoader::startElement(), GenericHandler::startElement(), GenericSAXHandler::startElement(), transcodeFromLocal(), TemplateHandler::warning(), and OptionsLoader::warning().

Here is the caller graph for this function:

transcode() [2/2]

std::string StringUtils::transcode ( const XMLCh *const  data, int  length  )

static

converts a 0-terminated XMLCh* array (usually UTF-16, stemming from Xerces) into std::string in UTF-8 considering the given length

Exceptions

EmptyData

if the given pointer is 0

Definition at line 433 of file StringUtils.cpp.

transcodeFromLocal()

std::string StringUtils::transcodeFromLocal ( const std::string &  localString )

static

convert a string from the local codepage to UTF-8

Definition at line 457 of file StringUtils.cpp.

References myLCPTranscoder, and transcode().

Referenced by OptionsIO::setArgs().

Here is the caller graph for this function:

transcodeToLocal()

std::string StringUtils::transcodeToLocal ( const std::string &  utf8String )

static

convert a string from UTF-8 to the local codepage

Definition at line 473 of file StringUtils.cpp.

References myLCPTranscoder.

Referenced by OptionsIO::getRoot(), FileHelpers::isDirectory(), FileHelpers::isReadable(), OptionsIO::loadConfiguration(), GNEOptionsDialog::loadConfiguration(), GNEPythonTool::loadConfiguration(), GNEApplicationWindowHelper::GNENeteditConfigHandler::loadNeteditConfig(), GNEApplicationWindowHelper::GNESumoConfigHandler::loadSumoConfig(), GUIApplicationWindow::onCmdSaveConfig(), GNEApplicationWindow::onCmdSaveNeteditConfig(), GNEOptionsDialog::onCmdSaveOptions(), GNEApplicationWindow::onCmdSaveSumoConfig(), OutputDevice_File::OutputDevice_File(), SUMOSAXReader::parse(), SUMOSAXReader::parseFirst(), OptionsCont::processMetaOptions(), GNERunNetgenerate::run(), GNERunPythonTool::run(), and SysUtils::runHiddenCommand().

Here is the caller graph for this function:

trim()

std::string StringUtils::trim ( const std::string  s, const std::string &  t = " \t\n"  )

static

remove leading and trailing whitespace

Definition at line 504 of file StringUtils.cpp.

References trim_left(), and trim_right().

Referenced by GNENet::createEdge().

Here is the caller graph for this function:

trim_left()

std::string StringUtils::trim_left ( const std::string  s, const std::string &  t = " \t\n"  )

static

remove leading whitespace from string

Definition at line 490 of file StringUtils.cpp.

Referenced by trim().

Here is the caller graph for this function:

trim_right()

std::string StringUtils::trim_right ( const std::string  s, const std::string &  t = " \t\n"  )

static

remove trailing whitespace from string

Definition at line 497 of file StringUtils.cpp.

Referenced by trim().

Here is the caller graph for this function:

urlDecode()

std::string StringUtils::urlDecode ( const std::string &  encoded )

static

decode url (stem from http://bogomip.net/blog/cpp-url-encoding-and-decoding/)

Definition at line 273 of file StringUtils.cpp.

References hexToChar().

Referenced by MSDevice_SSM::getOutputFilename(), and OptionsCont::relocateFiles().

Here is the caller graph for this function:

urlEncode()

std::string StringUtils::urlEncode ( const std::string &  url, const std::string  encodeWhich = ""  )

static

encode url (stem from http://bogomip.net/blog/cpp-url-encoding-and-decoding/)

Definition at line 248 of file StringUtils.cpp.

References charToHex().

Referenced by OptionsCont::writeConfiguration().

Here is the caller graph for this function:

Field Documentation

emptyString

std::string StringUtils::emptyString

static

An empty string.

Definition at line 86 of file StringUtils.h.

Referenced by MSPerson::getNextEdge(), and GUIGlObject::getParentName().

myLCPTranscoder

XERCES_CPP_NAMESPACE::XMLLCPTranscoder * StringUtils::myLCPTranscoder = nullptr

staticprivate

Definition at line 202 of file StringUtils.h.

Referenced by resetTranscoder(), transcodeFromLocal(), and transcodeToLocal().

---

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

• StringUtils.h
• StringUtils.cpp