Detailed Description

Collaboration diagram for String management and utilities (in #include <mrpt/system/string_utils.h>):

Functions
char BASE_IMPEXP *	mrpt::system::strtok (char str, const char strDelimit, char **context) MRPT_NO_THROWS
	An OS-independent method for tokenizing a string. More...

void BASE_IMPEXP	mrpt::system::tokenize (const std::string &inString, const std::string &inDelimiters, std::deque< std::string > &outTokens, bool skipBlankTokens=true) MRPT_NO_THROWS
	Tokenizes a string according to a set of delimiting characters. More...

void BASE_IMPEXP	mrpt::system::tokenize (const std::string &inString, const std::string &inDelimiters, std::vector< std::string > &outTokens, bool skipBlankTokens=true) MRPT_NO_THROWS

std::string BASE_IMPEXP	mrpt::system::trim (const std::string &str)
	Removes leading and trailing spaces. More...

std::string BASE_IMPEXP	mrpt::system::upperCase (const std::string &str)
	Returns a upper-case version of a string. More...

std::string BASE_IMPEXP	mrpt::system::lowerCase (const std::string &str)
	Returns an lower-case version of a string. More...

void BASE_IMPEXP	mrpt::system::decodeUTF8 (const std::string &strUTF8, vector_word &out_uniStr)
	Decodes a UTF-8 string into an UNICODE string. More...

void BASE_IMPEXP	mrpt::system::encodeUTF8 (const vector_word &input, std::string &output)
	Encodes a 2-bytes UNICODE string into a UTF-8 string. More...

void BASE_IMPEXP	mrpt::system::encodeBase64 (const vector_byte &inputData, std::string &outString)
	Encode a sequence of bytes as a string in base-64. More...

bool BASE_IMPEXP	mrpt::system::decodeBase64 (const std::string &inString, vector_byte &outData)
	Decode a base-64 string into the original sequence of bytes. More...

std::string BASE_IMPEXP	mrpt::system::unitsFormat (const double val, int nDecimalDigits=2, bool middle_space=true)
	This function implements formatting with the appropriate SI metric unit prefix: 1e-12->'p', 1e-9->'n', 1e-6->'u', 1e-3->'m', 1->'', 1e3->'K', 1e6->'M', 1e9->'G', 1e12->'T'. More...

std::string BASE_IMPEXP	mrpt::system::rightPad (const std::string &str, const size_t total_len, bool truncate_if_larger=false)
	Enlarge the string with spaces up to the given length. More...

bool BASE_IMPEXP	mrpt::system::strCmp (const std::string &s1, const std::string &s2)
	Return true if the two strings are equal (case sensitive) More...

bool BASE_IMPEXP	mrpt::system::strCmpI (const std::string &s1, const std::string &s2)
	Return true if the two strings are equal (case insensitive) More...

bool BASE_IMPEXP	mrpt::system::strStarts (const std::string &str, const std::string &subStr)
	Return true if "str" starts with "subStr" (case sensitive) More...

bool BASE_IMPEXP	mrpt::system::strStartsI (const std::string &str, const std::string &subStr)
	Return true if "str" starts with "subStr" (case insensitive) More...

template<typename T >
std::string	mrpt::system::sprintf_container (const char *fmt, const T &V)
	Generates a string for a container in the format [A,B,C,...], and the fmt string for each vector element. More...

template<typename T >
T	mrpt::system::str2num (std::string const &value)
	Original code snippet found in http://stackoverflow.com/a/30357710. More...

template<typename T >
std::string	mrpt::system::num2str (T const &value)
	Convert number instance to string. More...

Function Documentation

◆ decodeBase64()

bool mrpt::system::decodeBase64	(	const std::string &	inString,
		vector_byte &	outData
	)

Decode a base-64 string into the original sequence of bytes.

See also: encodeBase64

Returns: false on invalid base-64 string passed as input, true on success.

Definition at line 87 of file base64.cpp.

References alphabet, mrpt::format(), and mrpt::utils::round().

Referenced by TEST().

◆ decodeUTF8()

void mrpt::system::decodeUTF8	(	const std::string &	strUTF8,
		vector_word &	out_uniStr
	)

Decodes a UTF-8 string into an UNICODE string.

See http://en.wikipedia.org/wiki/UTF-8 and http://www.codeguru.com/cpp/misc/misc/multi-lingualsupport/article.php/c10451/.

Definition at line 99 of file string_utils.cpp.

References MASK2BYTES, MASK3BYTES, MASKBITS, and MASKBYTE.

Referenced by mrpt::utils::CCanvas::textOut().

◆ encodeBase64()

void mrpt::system::encodeBase64	(	const vector_byte &	inputData,
		std::string &	outString
	)

Encode a sequence of bytes as a string in base-64.

See also: decodeBase64

Definition at line 27 of file base64.cpp.

References alphabet, and mrpt::utils::round().

Referenced by mrpt::utils::net::http_request(), mrpt::hwdrivers::CNTRIPClient::private_ntrip_thread(), and TEST().

◆ encodeUTF8()

void mrpt::system::encodeUTF8	(	const vector_word &	input,
		std::string &	output
	)

Encodes a 2-bytes UNICODE string into a UTF-8 string.

See http://en.wikipedia.org/wiki/UTF-8 and http://www.codeguru.com/cpp/misc/misc/multi-lingualsupport/article.php/c10451/.

Definition at line 66 of file string_utils.cpp.

References MASK2BYTES, MASKBITS, and MASKBYTE.

◆ lowerCase()

string mrpt::system::lowerCase ( const std::string & str )

Returns an lower-case version of a string.

See also: upperCase

Definition at line 28 of file string_utils.cpp.

Referenced by mrpt::obs::carmen_log_parse_line(), mrpt::hwdrivers::CCameraSensor::initialize(), mrpt::graphslam::CWindowObserver::OnEvent(), mrpt::utils::CConfigFileBase::read_bool(), and run_test_pf_localization().

◆ num2str()

template<typename T >

std::string mrpt::system::num2str ( T const & value )

Convert number instance to string.

Definition at line 140 of file string_utils.h.

Referenced by mrpt::utils::net::Ping().

◆ rightPad()

std::string mrpt::system::rightPad	(	const std::string &	str,
		const size_t	total_len,
		bool	truncate_if_larger = `false`
	)

Enlarge the string with spaces up to the given length.

Definition at line 271 of file string_utils.cpp.

Referenced by aux_format_string_multilines().

◆ sprintf_container()

template<typename T >

std::string mrpt::system::sprintf_container	(	const char *	fmt,
		const T &	V
	)

Generates a string for a container in the format [A,B,C,...], and the fmt string for each vector element.

Definition at line 109 of file string_utils.h.

References mrpt::format().

Referenced by mrpt::nav::CHolonomicFullEval::TOptions::saveToConfigFile().

◆ str2num()

template<typename T >

T mrpt::system::str2num ( std::string const & value )

Original code snippet found in http://stackoverflow.com/a/30357710.

Convert string instance to number

Definition at line 129 of file string_utils.h.

◆ strCmp()

bool mrpt::system::strCmp	(	const std::string &	s1,
		const std::string &	s2
	)

Return true if the two strings are equal (case sensitive)

See also: strCmpI; StrCmpI

Definition at line 280 of file string_utils.cpp.

References mrpt::system::os::_strcmp().

Referenced by mrpt::hwdrivers::CGPSInterface::legacy_topcon_setup_commands(), and mrpt::maps::CHeightGridMap2D::TInsertionOptions::loadFromConfigFile().

◆ strCmpI()

bool mrpt::system::strCmpI	(	const std::string &	s1,
		const std::string &	s2
	)

Return true if the two strings are equal (case insensitive)

See also: strCmp; StrCmp

Definition at line 286 of file string_utils.cpp.

References mrpt::system::os::_strcmpi().

Referenced by mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::_execGraphSlamStep(), mrpt::graphslam::apps::TUserOptionsChecker< GRAPH_T >::checkOptimizerExists(), mrpt::graphslam::apps::TUserOptionsChecker< GRAPH_T >::checkRegistrationDeciderExists(), mrpt::graphslam::apps::TUserOptionsChecker< GRAPH_T >::dumpRegistrarsToConsole(), mrpt::utils::CMHPropertiesValuesList::getElemental(), mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::initClass(), mrpt::obs::CObservation3DRangeScan::load(), mrpt::graphs::detail::graph_ops< graph_t >::load_graph_of_poses_from_text_file(), mrpt::hwdrivers::CNationalInstrumentsDAQ::loadConfig_sensorSpecific(), mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::TRGBDInfoFileParams::parseFile(), mrpt::utils::CMHPropertiesValuesList::setElemental(), and mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::~CGraphSlamEngine().

◆ strStarts()

bool mrpt::system::strStarts	(	const std::string &	s1,
		const std::string &	s2
	)

Return true if "str" starts with "subStr" (case sensitive)

See also: strStartsI

Definition at line 292 of file string_utils.cpp.

References mrpt::system::os::_strncmp().

Referenced by mrpt::utils::CTextFileLinesParser::getNextLine().

◆ strStartsI()

bool mrpt::system::strStartsI	(	const std::string &	s1,
		const std::string &	s2
	)

Return true if "str" starts with "subStr" (case insensitive)

See also: strStarts

Definition at line 298 of file string_utils.cpp.

References mrpt::system::os::_strnicmp().

Referenced by mrpt::obs::carmen_log_parse_line().

◆ strtok()

char * mrpt::system::strtok	(	char *	str,
		const char *	strDelimit,
		char **	context
	)

An OS-independent method for tokenizing a string.

The extra parameter "context" must be a pointer to a "char*" variable, which needs no initialization and is used to save information between calls to strtok.

See also: system::tokenize

Definition at line 172 of file string_utils.cpp.

Referenced by mrpt::hwdrivers::CLMS100Eth::decodeScan(), mrpt::hwdrivers::CImpinjRFID::getObservation(), mrpt::hwdrivers::CWirelessPower::GetPower(), mrpt::hwdrivers::CWirelessPower::ListInterfaces(), mrpt::hwdrivers::CWirelessPower::ListNetworks(), and mrpt::hwdrivers::CTuMicos::radQuerry().

◆ tokenize() [1/2]

void mrpt::system::tokenize	(	const std::string &	inString,
		const std::string &	inDelimiters,
		std::deque< std::string > &	outTokens,
		bool	skipBlankTokens = `true`
	)

Tokenizes a string according to a set of delimiting characters.

Example:

std::vector<std::string> tokens;

tokenize(" - Pepe-Er Muo"," -",tokens);

Will generate 3 tokens:

"Pepe"
"Er"
"Muo"
Parameters

[in] skipBlankTokens If true, consecutive "delimiters" will be considered one single delimiters. If false, a blank token will be returned between each pair of delimiters.

Definition at line 231 of file string_utils.cpp.

References my_tokenize().

Referenced by mrpt::utils::CTypeSelector::CTypeSelector(), mrpt::hwdrivers::CGillAnemometer::doProcess(), mrpt::hwdrivers::CGyroKVHDSP3000::doProcess(), mrpt::maps::internal::TMetricMapTypesRegistry::doRegister(), mrpt::utils::CListOfClasses::fromString(), get_words(), mrpt::system::getCurrentThreadTimes(), mrpt::utils::net::http_request(), mrpt::hwdrivers::CNationalInstrumentsDAQ::loadConfig_sensorSpecific(), mrpt::nav::CNavigatorManualSequence::loadConfigFile(), mrpt::nav::CMultiObjectiveMotionOptimizerBase::TParamsBase::loadFromConfigFile(), mrpt::hmtslam::CHMTSLAM::TOptions::loadFromConfigFile(), mrpt::hmtslam::CHierarchicalMHMap::loadFromXMLfile(), mrpt::hwdrivers::TCaptureOptions_FlyCapture2::loadOptionsFrom(), mrpt::hwdrivers::CGPSInterface::parse_NMEA(), mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::TRGBDInfoFileParams::parseFile(), mrpt::utils::CConfigFileBase::read_string_first_word(), mrpt::utils::CConfigFileBase::read_vector(), mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::readGTFile(), mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::readGTFileRGBD_TUM(), mrpt::hwdrivers::CNTRIPClient::retrieveListOfMountpoints(), and mrpt::utils::CStringList::setText().

◆ tokenize() [2/2]

void mrpt::system::tokenize	(	const std::string &	inString,
		const std::string &	inDelimiters,
		std::vector< std::string > &	outTokens,
		bool	skipBlankTokens = `true`
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 240 of file string_utils.cpp.

References my_tokenize().

◆ trim()

std::string mrpt::system::trim ( const std::string & str )

Removes leading and trailing spaces.

Definition at line 252 of file string_utils.cpp.

Referenced by add_comment(), add_obj_info(), mrpt::obs::carmen_log_parse_line(), mrpt::nav::CParameterizedTrajectoryGenerator::CreatePTG(), mrpt::utils::CTextFileLinesParser::getNextLine(), mrpt::hwdrivers::CSwissRanger3DCamera::getNextObservation(), mrpt::hwdrivers::CCameraSensor::initialize(), CGraphSlamHandler< GRAPH_T >::initOutputDir(), mrpt::hwdrivers::CNTRIPEmitter::loadConfig_sensorSpecific(), mrpt::hwdrivers::CSwissRanger3DCamera::loadConfig_sensorSpecific(), mrpt::hwdrivers::CGPSInterface::loadConfig_sensorSpecific(), mrpt::hwdrivers::CCameraSensor::loadConfig_sensorSpecific(), mrpt::vision::TSequenceFeatureObservations::loadFromTextFile(), mrpt::hwdrivers::CGPSInterface::parse_NMEA(), mrpt::utils::simpleini::MRPT_IniFileParser::parse_process_var_eval(), mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::TRGBDInfoFileParams::parseFile(), mrpt::utils::CConfigFileBase::read_bool(), mrpt::utils::CConfigFileBase::read_string(), and mrpt::hwdrivers::CCameraSensor::thread_save_images().

◆ unitsFormat()

std::string mrpt::system::unitsFormat	(	const double	val,
		int	nDecimalDigits = `2`,
		bool	middle_space = `true`
	)

This function implements formatting with the appropriate SI metric unit prefix: 1e-12->'p', 1e-9->'n', 1e-6->'u', 1e-3->'m', 1->'', 1e3->'K', 1e6->'M', 1e9->'G', 1e12->'T'.

See also: intervalFormat

Definition at line 137 of file string_utils.cpp.

References mrpt::format(), and val.

Referenced by mrpt::utils::CTimeLogger::getStatsAsText().

◆ upperCase()

string mrpt::system::upperCase ( const std::string & str )

Returns a upper-case version of a string.

See also: lowerCase

Definition at line 42 of file string_utils.cpp.

Referenced by mrpt::graphslam::apps::TUserOptionsChecker< GRAPH_T >::dumpRegistrarsToConsole(), mrpt::hwdrivers::CPtuDPerception::echoModeQ(), mrpt::hwdrivers::CPtuDPerception::enableLimitsQ(), mrpt::hwdrivers::CCameraSensor::initialize(), mrpt::hwdrivers::CCameraSensor::loadConfig_sensorSpecific(), mrpt::graphslam::CGraphSlamEngine< GRAPH_T >::pauseExec(), mrpt::hwdrivers::CPtuDPerception::powerModeQ(), and mrpt::graphslam::CWindowObserver::registerKeystroke().

Detailed Description

Functions

Function Documentation

◆ decodeBase64()

◆ decodeUTF8()

◆ encodeBase64()

◆ encodeUTF8()

◆ lowerCase()

◆ num2str()

◆ rightPad()

◆ sprintf_container()

◆ str2num()

◆ strCmp()

◆ strCmpI()

◆ strStarts()

◆ strStartsI()

◆ strtok()

◆ tokenize() [1/2]

◆ tokenize() [2/2]

◆ trim()

◆ unitsFormat()

◆ upperCase()