Text String Manipulation Tools

Classes
class	StringException
	This is thrown instread of a std::exception when a gpstk::StringUtils function fails. More...
class	HexDumpDataConfig
	Class for configuring the appearance of hexDumpData() output. More...
Functions
void	gpstk::StringUtils::hexDumpData (std::ostream &s, const std::string &data, unsigned indent=0, HexDumpDataConfig cfg=HexDumpDataConfig())
	Perform a formatted hex-dump of the (potentially) binary data to the given stream.
void	gpstk::StringUtils::hexDumpData (std::ostream &s, const std::string &data, const std::string &tag, HexDumpDataConfig cfg=HexDumpDataConfig())
	Perform a formatted hex-dump of the (potentially) binary data to the given stream.
std::string &	gpstk::StringUtils::stripLeading (std::string &s, const std::string &aString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the beginning of another string.
std::string	gpstk::StringUtils::stripLeading (const std::string &s, const std::string &aString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the beginning of another string const version.
std::string &	gpstk::StringUtils::stripLeading (std::string &s, const char *pString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the beginning of another string.
std::string	gpstk::StringUtils::stripLeading (const std::string &s, const char *pString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the beginning of another string const version.
std::string &	gpstk::StringUtils::stripLeading (std::string &s, const char aCharacter, std::string::size_type num=std::string::npos) throw (StringException)
	Strip character(s) from the beginning of a string.
std::string	gpstk::StringUtils::stripLeading (const std::string &s, const char aCharacter, std::string::size_type num=std::string::npos) throw (StringException)
	Strip character(s) from the beginning of a string const version.
std::string &	gpstk::StringUtils::stripLeading (std::string &s, std::string::size_type num=std::string::npos) throw (StringException)
	Strip blanks from the beginning of a string.
std::string	gpstk::StringUtils::stripLeading (const std::string &s, std::string::size_type num=std::string::npos) throw (StringException)
	Strip blanks from the beginning of a string const version.
std::string &	gpstk::StringUtils::stripTrailing (std::string &s, const std::string &aString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the end of another string.
std::string	gpstk::StringUtils::stripTrailing (const std::string &s, const std::string &aString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the end of another string const version.
std::string &	gpstk::StringUtils::stripTrailing (std::string &s, const char *pString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the end of another string.
std::string	gpstk::StringUtils::stripTrailing (const std::string &s, const char *pString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the end of another string const version.
std::string &	gpstk::StringUtils::stripTrailing (std::string &s, const char aCharacter, std::string::size_type num=std::string::npos) throw (StringException)
	Strip character(s) from the end of a string.
std::string	gpstk::StringUtils::stripTrailing (const std::string &s, const char aCharacter, std::string::size_type num=std::string::npos) throw (StringException)
	Strip character(s) from the end of a string const version.
std::string &	gpstk::StringUtils::stripTrailing (std::string &s, std::string::size_type num=std::string::npos) throw (StringException)
	Strip blanks from the end of a string.
std::string	gpstk::StringUtils::stripTrailing (const std::string &s, std::string::size_type num=std::string::npos) throw (StringException)
	Strip blanks from the end of a string const version.
std::string &	gpstk::StringUtils::strip (std::string &s, const std::string &aString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the beginning and end of another string.
std::string	gpstk::StringUtils::strip (const std::string &s, const std::string &aString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the beginning and end of another string const version.
std::string &	gpstk::StringUtils::strip (std::string &s, const char *pString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the beginning and end of another string.
std::string	gpstk::StringUtils::strip (const std::string &s, const char *pString, std::string::size_type num=std::string::npos) throw (StringException)
	Remove a string from the beginning and end of another string cosnt version.
std::string &	gpstk::StringUtils::strip (std::string &s, const char aCharacter, std::string::size_type num=std::string::npos) throw (StringException)
	Strip character(s) from the beginning and end of a string.
std::string	gpstk::StringUtils::strip (const std::string &s, const char aCharacter, std::string::size_type num=std::string::npos) throw (StringException)
	Strip character(s) from the beginning and end of a string const version.
std::string &	gpstk::StringUtils::strip (std::string &s, std::string::size_type num=std::string::npos) throw (StringException)
	Strip blanks from the beginning and end of a string.
std::string	gpstk::StringUtils::strip (const std::string &s, std::string::size_type num=std::string::npos) throw (StringException)
	Strip blanks from the beginning and end of a string const version.
std::string	gpstk::StringUtils::translate (const std::string &aString, const std::string &inputChars, const std::string &outputChars, const char pad= ' ')
	Converts all of the receiver's characters that are in the first specified string to the corresponding character in the second specified string.
std::string	gpstk::StringUtils::change (const std::string &aString, const std::string &inputString, const std::string &outputString, std::string::size_type startPos=0, unsigned numChanges=(std::numeric_limits< unsigned >::max)())
	Changes occurrences of a specified pattern to a specified replacement string.
std::string &	gpstk::StringUtils::change (std::string &aString, const std::string &inputString, const std::string &outputString, std::string::size_type startPos=0, unsigned numChanges=(std::numeric_limits< unsigned >::max)())
	Changes occurrences of a specified pattern to a specified replacement string.
std::string &	gpstk::StringUtils::rightJustify (std::string &s, const std::string::size_type length, const char pad= ' ') throw (StringException)
	Right-justifies the receiver in a string of the specified length.
std::string	gpstk::StringUtils::rightJustify (const std::string &s, const std::string::size_type length, const char pad= ' ') throw (StringException)
	Right-justifies the receiver in a string of the specified length (const version).
std::string &	gpstk::StringUtils::leftJustify (std::string &s, const std::string::size_type length, const char pad= ' ') throw (StringException)
	Left-justifies the receiver in a string of the specified length.
std::string	gpstk::StringUtils::leftJustify (const std::string &s, const std::string::size_type length, const char pad= ' ') throw (StringException)
	Left-justifies the receiver in a string of the specified length (const version).
std::string &	gpstk::StringUtils::center (std::string &s, const std::string::size_type length, const char pad= ' ') throw (StringException)
	Change the length of a string by adding to the beginning and end.
std::string	gpstk::StringUtils::center (const std::string &s, const std::string::size_type length, const char pad= ' ') throw (StringException)
	Change the length of a string by adding to the beginning and end (const version).
double	gpstk::StringUtils::asDouble (const std::string &s)
	Convert a string to a double precision floating point number.
long	gpstk::StringUtils::asInt (const std::string &s)
	Convert a string to an integer.
unsigned long	gpstk::StringUtils::asUnsigned (const std::string &s)
	Convert a string to an unsigned integer.
float	gpstk::StringUtils::asFloat (const std::string &s) throw (StringException)
	Convert a string to a single precision floating point number.
long double	gpstk::StringUtils::asLongDouble (const std::string &s) throw (StringException)
	Convert a string to a big precision floating point number.
template<class X>
X	gpstk::StringUtils::asData (const std::string &s) throw (StringException)
	Convert a value in a string to a type specified by the template class.
std::string	gpstk::StringUtils::asString (const long double x, const std::string::size_type precision=21)
	Convert a long double to a string in fixed notation.
std::string	gpstk::StringUtils::asString (const double x, const std::string::size_type precision=17)
	Convert a double to a string in fixed notation.
template<class X>
std::string	gpstk::StringUtils::asString (const X x)
	Convert any old object to a string.
std::string &	gpstk::StringUtils::d2x (std::string &s) throw (StringException)
	Convert a decimal string to a hexadecimal string.
std::string	gpstk::StringUtils::d2x (const std::string &s) throw (StringException)
	Convert a decimal string to a hexadecimal string.
std::string &	gpstk::StringUtils::x2d (std::string &s) throw (StringException)
std::string	gpstk::StringUtils::x2d (const std::string &s) throw (StringException)
	Convert a hexadecimal string to a decimal string.
std::string &	gpstk::StringUtils::c2x (std::string &s) throw (StringException)
	Convert a character string to a hexadecimal string.
std::string	gpstk::StringUtils::c2x (const std::string &s) throw (StringException)
	Convert a character string to a hexadecimal string.
unsigned int	gpstk::StringUtils::x2int (const std::string &s) throw (StringException)
std::string	gpstk::StringUtils::int2x (const unsigned int &i) throw (StringException)
	Convert an int to a string.
std::string &	gpstk::StringUtils::replaceAll (std::string &s, const std::string &oldString, const std::string &newString) throw (StringException)
	Replace all instances of oldString with newString in s.
bool	gpstk::StringUtils::isDigitString (const std::string &s)
	isDigitString is exactly like the C function isDigit except it checks all the characters of string s to see if they are all digits.
bool	gpstk::StringUtils::isDecimalString (const std::string &s)
	isDecimalString is like isDigitString() except it allows a single period ('.') character in the string.
bool	gpstk::StringUtils::isScientificString (const std::string &s)
	isScientificString extends isDecimalString() to allow a single exponent (E,e,D,d) character between a decimal string and a (possibly empty) digit string.
bool	gpstk::StringUtils::isAlphaString (const std::string &s)
	isAlphaString is exactly like the C function isAlpha except it checks all the characters of string s to see if they are all alphabet characters.
std::string	gpstk::StringUtils::matches (const std::string &s, const std::string &aPattern, const char zeroOrMore= '*', const char oneOrMore= '+', const char anyChar= '.') throw (StringException)
	Perform pattern matching on strings.
bool	gpstk::StringUtils::isLike (const std::string &s, const std::string &aPattern, const char zeroOrMore= '*', const char oneOrMore= '+', const char anyChar= '.') throw (StringException)
	Perform pattern matching on strings.
bool	gpstk::StringUtils::isLike (const std::string &s, const char *pPattern, const char zeroOrMore= '*', const char oneOrMore= '+', const char anyChar= '.') throw (StringException)
	Perform pattern matching on strings.
template<class T>
std::string	gpstk::StringUtils::formattedPrint (const std::string &fmt, const std::string &pat, const std::string &rep, T to) throw (StringException)
	Work-horse method for printf.
std::string	gpstk::StringUtils::subString (const std::string &s, const std::string::size_type startPos=0, const std::string::size_type length=std::string::npos, const char pad= ' ') throw (StringException)
	Get a substring of a string.
std::string &	gpstk::StringUtils::lowerCase (std::string &s)
	Change all upper-case letters in a string to lower-case.
std::string	gpstk::StringUtils::lowerCase (const std::string &s)
	Change all upper-case letters in a string to lower-case.
std::string &	gpstk::StringUtils::upperCase (std::string &s)
	Change all lower-case letters in a string to upper-case.
std::string	gpstk::StringUtils::upperCase (const std::string &s)
	Change all lower-case letters in a string to upper-case.
std::string	gpstk::StringUtils::memToString (const void *p, const std::string::size_type size)
	Make a string from a void pointer.
std::string	gpstk::StringUtils::firstWord (const std::string &s, const char delimiter= ' ') throw (StringException)
	Returns the first word in string s without modifying the string.
int	gpstk::StringUtils::numWords (const std::string &s, const char delimiter= ' ') throw (StringException)
	Counts the number of words in s and returns it.
std::string	gpstk::StringUtils::words (const std::string &s, const std::string::size_type firstWord=0, const std::string::size_type numWords=std::string::npos, const char delimiter= ' ') throw (StringException)
	Returns numWords words starting with firstWord from s (if any).
std::string	gpstk::StringUtils::word (const std::string &s, const std::string::size_type wordNum=0, const char delimiter= ' ') throw (StringException)
	Returns word number wordNum from s (if any).
std::string	gpstk::StringUtils::stripFirstWord (std::string &s, const char delimiter= ' ') throw (StringException)
	Removes the first word off string s and returns it.
std::string &	gpstk::StringUtils::removeWords (std::string &s, const std::string::size_type first=0, const std::string::size_type wordsToReplace=std::string::npos, const char delimiter= ' ') throw (StringException)
	Removes indicated words from the string s.
std::string	gpstk::StringUtils::doub2sci (const double &d, const std::string::size_type length, const std::string::size_type expLen, const bool showSign=true, const bool checkSwitch=true)
	Convert a double to a scientific notation number.
std::string &	gpstk::StringUtils::sci2for (std::string &aStr, const std::string::size_type startPos=0, const std::string::size_type length=std::string::npos, const std::string::size_type expLen=3, const bool checkSwitch=true) throw (StringException)
	Convert scientific notation to FORTRAN notation.
std::string	gpstk::StringUtils::doub2for (const double &d, const std::string::size_type length, const std::string::size_type expLen, const bool checkSwitch=true) throw (StringException)
	Convert double precision floating point to a string containing the number in FORTRAN notation.
double	gpstk::StringUtils::for2doub (const std::string &aStr, const std::string::size_type startPos=0, const std::string::size_type length=std::string::npos)
	Convert FORTRAN representation of a double precision floating point in a string to a number.
std::string	gpstk::StringUtils::printable (const std::string &aStr) throw (StringException)
	Change a string into printable characters.
std::string &	gpstk::StringUtils::prettyPrint (std::string &aStr, const std::string &lineDelim="\n", const std::string &indent="", const std::string &firstIndent=" ", const std::string::size_type len=80, const char wordDelim= ' ') throw (StringException)
	Nicely expands the input string into several lines, non-const version.
std::string	gpstk::StringUtils::prettyPrint (const std::string &aStr, const std::string &lineDelim="\n", const std::string &indent="", const std::string &firstIndent=" ", const std::string::size_type len=80, const char wordDelim= ' ') throw (StringException)
	Const version of prettyPrint, which nicely expands the input string into several lines.
std::vector< std::string >	gpstk::StringUtils::split (const std::string &aStr, const std::string &theDelimiters=" ", bool trimWhitespace=false, bool ignoreEmpty=true)
	Split a string by some delimiters.

---

Function Documentation

X asData (  const std::string &  s  )  throw (StringException) [inline]

Convert a value in a string to a type specified by the template class. The template class type must have stream operators defined. Parameters: x  object to turn into the templatized type. Returns: the template object of x. Definition at line 1705 of file StringUtils.hpp.

double asDouble (  const std::string &  s  )  [inline]

Convert a string to a double precision floating point number. Parameters: s  string containing a number. Returns: double representation of string. Definition at line 716 of file StringUtils.hpp. Referenced by EOPStore::addIERSFile(), ConfDataReader::fetchListValueAsDouble(), ConfDataReader::getValueAsDouble(), ObsEphReaderFramework::initialize(), EOPPrediction::loadFile(), SatOrbitStore::loadGNV1BFile(), EOPDataStore::loadIERSFile(), EOPDataStore::loadSTKFile(), EarthOceanTide::loadTideFile(), main(), gpstk::mixedScanTime(), ConfDataItem::parse(), IonexHeader::ParseDcbRecord(), RinexObsHeader::ParseHeaderRecord(), IonexHeader::ParseHeaderRecord(), AntexHeader::ParseHeaderRecord(), gpstk::parseTime(), YumaData::reallyGetRecord(), SP3Header::reallyGetRecord(), SP3Data::reallyGetRecord(), SMODFData::reallyGetRecord(), SEMData::reallyGetRecord(), RinexObsData::reallyGetRecord(), RinexNavHeader::reallyGetRecord(), RinexMetHeader::reallyGetRecord(), RinexGloNavHeader::reallyGetRecord(), MSCData::reallyGetRecord(), IonexData::reallyGetRecord(), gpstk::scanTime(), gpstk::StringUtils::sci2for(), YDSTime::setFromInfo(), GPSWeekSecond::setFromInfo(), CivilTime::setFromInfo(), GDCconfiguration::setParameter(), Position::setToString(), and DayTime::setToString().

float asFloat (  const std::string &  s  )  throw (StringException) [inline]

Convert a string to a single precision floating point number. Parameters: s  string containing a number. Returns: single representation of string. Definition at line 1670 of file StringUtils.hpp. Referenced by main().

long asInt (  const std::string &  s  )  [inline]

Convert a string to an integer. Parameters: s  string containing a number. Returns: long integer representation of string. Definition at line 724 of file StringUtils.hpp. Referenced by SVExclusionList::addFile(), EOPStore::addIERSFile(), AshtechEPB::decode(), CommandOptionParser::displayUsage(), ConfDataReader::fetchListValueAsInt(), TimeTag::getInfo(), ConfDataReader::getValueAsInt(), Application::handleDefaultOptions(), FileSpec::init(), EOPPrediction::loadFile(), SatOrbitStore::loadGNV1BFile(), EOPDataStore::loadSTKFile(), EarthOceanTide::loadTideFile(), main(), gpstk::mixedScanTime(), Test::otherTest(), ConfDataItem::parse(), IonexHeader::ParseDcbRecord(), RinexObsHeader::ParseHeaderRecord(), IonexHeader::ParseHeaderRecord(), gpstk::parseTime(), SolarSystem::readASCIIdata(), PlanetEphemeris::readASCIIdata(), SolarSystem::readASCIIheader(), PlanetEphemeris::readASCIIheader(), YumaData::reallyGetRecord(), SP3Header::reallyGetRecord(), SP3Data::reallyGetRecord(), SMODFData::reallyGetRecord(), SEMHeader::reallyGetRecord(), SEMData::reallyGetRecord(), RinexObsData::reallyGetRecord(), RinexNavHeader::reallyGetRecord(), RinexMetHeader::reallyGetRecord(), RinexGloNavHeader::reallyGetRecord(), MSCData::reallyGetRecord(), IonexData::reallyGetRecord(), FICData::reallyGetRecord(), gpstk::scanTime(), gpstk::StringUtils::sci2for(), YDSTime::setFromInfo(), UnixTime::setFromInfo(), GPSWeekZcount::setFromInfo(), GPSWeekSecond::setFromInfo(), GPSWeek::setFromInfo(), CivilTime::setFromInfo(), ANSITime::setFromInfo(), Position::setToString(), and DayTime::setToString().

long double asLongDouble (  const std::string &  s  )  throw (StringException) [inline]

Convert a string to a big precision floating point number. Parameters: s  string containing a number. Returns: long double representation of string. Definition at line 1687 of file StringUtils.hpp. Referenced by main(), gpstk::mixedScanTime(), MJD::setFromInfo(), and JulianDate::setFromInfo().

std::string asString (  const X  x  )  [inline]

Convert any old object to a string. The class must have stream operators defined. Parameters: x  object to turn into a string. Returns: string representation of x. Definition at line 1737 of file StringUtils.hpp.

std::string asString (  const double  x, const std::string::size_type  precision = 17 )  [inline]

Convert a double to a string in fixed notation. Parameters: x  double. precision  the number of decimal places you want displayed. Returns: string representation of x. Definition at line 1729 of file StringUtils.hpp.

std::string asString (  const long double  x, const std::string::size_type  precision = 21 )  [inline]

Convert a long double to a string in fixed notation. Parameters: x  long double. precision  the number of decimal places you want displayed. Returns: string representation of x. Definition at line 1722 of file StringUtils.hpp.

unsigned long asUnsigned (  const std::string &  s  )  [inline]

Convert a string to an unsigned integer. Parameters: s  string containing a number. Returns: unsigned long integer representation of string. Definition at line 732 of file StringUtils.hpp. Referenced by MSCStore::findMSC(), and ObsEphReaderFramework::initialize().

std::string c2x (  const std::string &  s  )  throw (StringException) [inline]

Convert a character string to a hexadecimal string. Parameters: s  string containing an integer. Returns: string containing a sequence of hexadecimal numbers. Definition at line 852 of file StringUtils.hpp.

std::string & c2x (  std::string &  s  )  throw (StringException) [inline]

Convert a character string to a hexadecimal string. Modify the string such that the character string is now represented as series of hexadecimal digits. Parameters: s  string to convert. Returns: reference to modified s. Definition at line 1778 of file StringUtils.hpp.

std::string center (  const std::string &  s, const std::string::size_type  length, const char  pad = ' ' )  throw (StringException) [inline]

Change the length of a string by adding to the beginning and end (const version). The string s is modified to the specified length. If the string is shorter than length, then the string is truncated with the left-most length characters remaining. Otherwise, characters are added to the beginning and end of the string until the string is the specified length, where the number of characters added to the beginning and the end does not differ by more than one so the original string is centered. Parameters: s  string to be modified. length  new desired length of string. pad  character to pad string with (blank by default). Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 705 of file StringUtils.hpp. Referenced by gpstk::StringUtils::leftJustify(), and main().

std::string & center (  std::string &  s, const std::string::size_type  length, const char  pad = ' ' )  throw (StringException) [inline]

Change the length of a string by adding to the beginning and end. The string s is modified to the specified length. If the string is shorter than length, then the string is truncated with the left-most length characters remaining. Otherwise, characters are added to the beginning and end of the string until the string is the specified length, where the number of characters added to the beginning and the end does not differ by more than one so the original string is centered. Parameters: s  string to be modified. length  new desired length of string. pad  character to pad string with (blank by default). Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 1640 of file StringUtils.hpp. References gpstk::StringUtils::leftJustify(), and gpstk::StringUtils::rightJustify(). Referenced by SolarSystem::computeState(), PlanetEphemeris::computeState(), ReferenceFrames::getECEFPosition(), and ReferenceFrames::getECEFVelocity().

std::string & change (  std::string &  aString, const std::string &  inputString, const std::string &  outputString, std::string::size_type  startPos = 0, unsigned  numChanges = (std::numeric_limits< unsigned >::max)() )  [inline]

Changes occurrences of a specified pattern to a specified replacement string. You can specify the number of changes to perform. The default is to change all occurrences of the pattern. You can also specify the position in the receiver at which to begin. Parameters: aString  string to perform translation on. inputString  The pattern string as a reference to an object of type string. The library searches for the pattern string within the receiver's data. outputString  The replacement string as a reference to an object of type string. It replaces the occurrences of the pattern string in the receiver's data. startPos  The position to start the search at within the receiver's data. The default is 0. numChanges  the number of patterns to search for and change. The default is to change all occurrences of the pattern. Definition at line 1563 of file StringUtils.hpp. Referenced by ObsEphReaderFramework::initialize().

std::string change (  const std::string &  aString, const std::string &  inputString, const std::string &  outputString, std::string::size_type  startPos = 0, unsigned  numChanges = (std::numeric_limits< unsigned >::max)() )  [inline]

Changes occurrences of a specified pattern to a specified replacement string. You can specify the number of changes to perform. The default is to change all occurrences of the pattern. You can also specify the position in the receiver at which to begin. Parameters: aString  string to perform translation on. inputString  The pattern string as a reference to an object of type string. The library searches for the pattern string within the receiver's data. outputString  The replacement string as a reference to an object of type string. It replaces the occurrences of the pattern string in the receiver's data. startPos  The position to start the search at within the receiver's data. The default is 0. numChanges  the number of patterns to search for and change. The default is to change all occurrences of the pattern. Definition at line 1554 of file StringUtils.hpp.

std::string d2x (  const std::string &  s  )  throw (StringException) [inline]

Convert a decimal string to a hexadecimal string. Given a string containing a decimal integer, convert the integer from base 10 to base 16 and return the result. No prefix is added. Only the first decimal encountered is changed; the rest of the string is unmodified. Parameters: s  string containing an integer. Returns: string containing a hexadecimal number. Definition at line 809 of file StringUtils.hpp. Referenced by main().

std::string & d2x (  std::string &  s  )  throw (StringException) [inline]

Convert a decimal string to a hexadecimal string. Modify the string such that the decimal integer is now represented as hexadecimal. Only the first decimal encountered is changed; the rest of the string is unmodified. Parameters: s  string containing an integer. Returns: reference to modified s. Definition at line 1745 of file StringUtils.hpp.

std::string doub2for (  const double &  d, const std::string::size_type  length, const std::string::size_type  expLen, const bool  checkSwitch = true )  throw (StringException) [inline]

Convert double precision floating point to a string containing the number in FORTRAN notation. As an example, the number 156360 becomes ".15636D6". Parameters: d  number to convert. length  length (in characters) of number, including exponent. expLen  length (in characters of exponent, including sign. checkSwitch  if true, keeps the exponential sanity check for exponentials above three characters in length. If false, it removes that check. Returns: a string containing d in FORTRAN notation. Definition at line 2463 of file StringUtils.hpp. References gpstk::StringUtils::doub2sci(), GPSTK_RETHROW, GPSTK_THROW, and gpstk::StringUtils::sci2for(). Referenced by SMODFData::reallyPutRecord(), SEMData::reallyPutRecord(), RinexNavHeader::reallyPutRecord(), RinexGloNavHeader::reallyPutRecord(), FICData::reallyPutRecord(), SolarSystem::writeASCIIdata(), PlanetEphemeris::writeASCIIdata(), SolarSystem::writeASCIIheader(), and PlanetEphemeris::writeASCIIheader().

std::string doub2sci (  const double &  d, const std::string::size_type  length, const std::string::size_type  expLen, const bool  showSign = true, const bool  checkSwitch = true )  [inline]

Convert a double to a scientific notation number. Parameters: d  the double to convert length  length (in characters) of output, including exponent expLen  length (in characters) of the exponent, with sign showSign  if true, reserves 1 character for +/- sign checkSwitch  if true, keeps the exponential sanity check for exponentials above three characters in length. If false, it removes that check. Definition at line 2326 of file StringUtils.hpp. Referenced by gpstk::StringUtils::doub2for(), and SMODFData::doub2funny().

std::string firstWord (  const std::string &  s, const char  delimiter = ' ' )  throw (StringException) [inline]

Returns the first word in string s without modifying the string. Parameters: s  the string to count the words from. delimiter  the character that marks the start and end of a word. Returns: the first word from s; Definition at line 2141 of file StringUtils.hpp. Referenced by main(), gpstk::mixedScanTime(), gpstk::StringUtils::numWords(), ConfDataItem::parse(), gpstk::StringUtils::prettyPrint(), gpstk::StringUtils::removeWords(), gpstk::scanTime(), DayTime::setToString(), gpstk::StringUtils::stripFirstWord(), and gpstk::StringUtils::words().

double for2doub (  const std::string &  aStr, const std::string::size_type  startPos = 0, const std::string::size_type  length = std::string::npos )  [inline]

Convert FORTRAN representation of a double precision floating point in a string to a number. As an example, the number ".15636D6" becomes 156360. Parameters: aStr  string containing FORTRAN representation of number. startPos  beginning of number in string. length  length (in characters) of number, including exponent. Returns: value of the number. Definition at line 2494 of file StringUtils.hpp. Referenced by SolarSystem::readASCIIdata(), PlanetEphemeris::readASCIIdata(), SolarSystem::readASCIIheader(), PlanetEphemeris::readASCIIheader(), SMODFData::reallyGetRecord(), RinexNavHeader::reallyGetRecord(), RinexGloNavHeader::reallyGetRecord(), and FICData::reallyGetRecord().

std::string formattedPrint (  const std::string &  fmt, const std::string &  pat, const std::string &  rep, T  to )  throw (StringException) [inline]

Work-horse method for printf. Substitutes patterns matching pat with rep. Use only one pattern/token at a time! This used to be DayTime::iprint(). Parameters: fmt  format to use for this time. pat  regular expression pattern to match. rep  sprintf token replacement. First character is token character used in fmt, remainder is sprintf token to use. For example, with fmt="%15S", pat="%[ 0-]?[[:digit:]]*S", and rep="Sd", the fmt will be translated to "%15d" before using it in a sprintf call like printf("%15d"), to. to  the value to stuff into the string. Returns: fmt with pat replaced by to. If there is no match, fmt is returned unchanged. Definition at line 2050 of file StringUtils.hpp. References GPSTK_THROW, and gpstk::StringUtils::replaceAll(). Referenced by YDSTime::printError(), UnixTime::printError(), MJD::printError(), JulianDate::printError(), GPSWeekZcount::printError(), GPSWeekSecond::printError(), GPSWeek::printError(), CivilTime::printError(), ANSITime::printError(), YDSTime::printf(), UnixTime::printf(), Position::printf(), MJD::printf(), JulianDate::printf(), GPSWeekZcount::printf(), GPSWeekSecond::printf(), GPSWeek::printf(), DayTime::printf(), CivilTime::printf(), and ANSITime::printf().

void hexDumpData (  std::ostream &  s, const std::string &  data, const std::string &  tag, HexDumpDataConfig  cfg = HexDumpDataConfig() )  [inline]

Perform a formatted hex-dump of the (potentially) binary data to the given stream. Parameters: s  stream to dump data to. data  data to hex-dump. tag  string to put at the beginning of each line of output. cfg  formatting configuration. Definition at line 1330 of file StringUtils.hpp. References cfg. Referenced by EngAlmanac::dump(), main(), AshtechData::readBody(), MDPHeader::readHeader(), AshtechData::readHeader(), MDPHeader::reallyGetRecord(), ATSData::reallyGetRecord(), MDPHeader::reallyPutRecord(), and ATSData::reallyPutRecord().

void hexDumpData (  std::ostream &  s, const std::string &  data, unsigned  indent = 0, HexDumpDataConfig  cfg = HexDumpDataConfig() )  [inline]

Perform a formatted hex-dump of the (potentially) binary data to the given stream. Parameters: s  stream to dump data to. data  data to hex-dump. indent  indents the string by that many spaces. cfg  formatting configuration. Definition at line 1323 of file StringUtils.hpp.

std::string int2x (  const unsigned int &  i  )  throw (StringException) [inline]

Convert an int to a string. Parameters: i  the integer to convert Returns: a string with the hex equivalent of i Definition at line 1885 of file StringUtils.hpp.

bool isAlphaString (  const std::string &  s  )  [inline]

isAlphaString is exactly like the C function isAlpha except it checks all the characters of string s to see if they are all alphabet characters. Parameters: s  the string to check the characters in. Returns: true if s is all digits, false otherwise. Definition at line 1979 of file StringUtils.hpp. References index(). Referenced by CommandOptionWithStringArg::checkArguments().

bool isDecimalString (  const std::string &  s  )  [inline]

isDecimalString is like isDigitString() except it allows a single period ('.') character in the string. Parameters: s  the string to check. Returns: true if s is a valid fixed-point number. Definition at line 1942 of file StringUtils.hpp. References index().

bool isDigitString (  const std::string &  s  )  [inline]

isDigitString is exactly like the C function isDigit except it checks all the characters of string s to see if they are all digits. Parameters: s  the string to check the digits in. Returns: true if s is all digits, false otherwise. Definition at line 1928 of file StringUtils.hpp. References index(). Referenced by CommandOptionWithNumberArg::checkArguments(), MSCStore::findMSC(), EOPDataStore::loadSTKFile(), and ConfDataItem::parse().

bool isLike (  const std::string &  s, const char *  pPattern, const char  zeroOrMore = '*', const char  oneOrMore = '+', const char  anyChar = '.' )  throw (StringException) [inline]

Perform pattern matching on strings. Looks for a pattern in a string. Wildcards are allowed. Uses POSIX regular expressions. Parameters: s  string to search. pPattern  pattern to search for. This is a POSIX regular expression. zeroOrMore  character representing wildcards matching strings of zero or more characters (default '*'). oneOrMore  character representing plus sign matching strings of one or more characters (default '+'). anyChar  character representing wildcards matching a single arbitrary character (default '.'). Returns: t if a match is found, f if not. Definition at line 984 of file StringUtils.hpp. References gpstk::StringUtils::matches(). Referenced by main(), gpstk::mixedScanTime(), gpstk::scanTime(), FileHunter::searchHelper(), CivilTime::setFromInfo(), and DayTime::setToString().

bool isLike (  const std::string &  s, const std::string &  aPattern, const char  zeroOrMore = '*', const char  oneOrMore = '+', const char  anyChar = '.' )  throw (StringException) [inline]

Perform pattern matching on strings. Looks for a pattern in a string. Wildcards are allowed. Uses POSIX regular expressions. Parameters: s  string to search. aPattern  pattern to search for. This is a POSIX regular expression. zeroOrMore  character representing wildcards matching strings of zero or more characters (default '*'). oneOrMore  character representing plus sign matching strings of one or more characters (default '+'). anyChar  character representing wildcards matching a single arbitrary character (default '.'). Returns: t if a match is found, f if not. Definition at line 959 of file StringUtils.hpp. References gpstk::StringUtils::matches().

bool isScientificString (  const std::string &  s  )  [inline]

isScientificString extends isDecimalString() to allow a single exponent (E,e,D,d) character between a decimal string and a (possibly empty) digit string. Parameters: s  the string to check. Returns: true if s is a valid scientific-notation number. Definition at line 1965 of file StringUtils.hpp.

std::string leftJustify (  const std::string &  s, const std::string::size_type  length, const char  pad = ' ' )  throw (StringException) [inline]

Left-justifies the receiver in a string of the specified length (const version). If the new length (length) is larger than the current length, the string is extended by the pad character (pad). The default pad character is a blank. Parameters: s  string to be modified. length  new desired length of string. pad  character to pad string with (blank by default). Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 659 of file StringUtils.hpp. References gpstk::StringUtils::center(). Referenced by gpstk::StringUtils::center(), gpstk::DisplayExtendedRinexObsTypes(), GDCconfiguration::DisplayParameterUsage(), gpstk::DisplayStandardRinexObsTypes(), CommandOptionParser::displayUsage(), dtft(), gpstk::dumpGnssDataMap(), main(), gpstk::operator<<(), SolarSystem::readASCIIdata(), PlanetEphemeris::readASCIIdata(), SP3Data::reallyGetRecord(), SP3Header::reallyPutRecord(), SEMHeader::reallyPutRecord(), RinexNavHeader::reallyPutRecord(), RinexMetHeader::reallyPutRecord(), RinexGloNavHeader::reallyPutRecord(), MSCData::reallyPutRecord(), IonexData::reallyPutRecord(), FICHeader::reallyPutRecord(), AntexData::reallyPutRecord(), gpstk::StringUtils::rightJustify(), gpstk::StringUtils::subString(), SolarSystem::writeASCIIdata(), PlanetEphemeris::writeASCIIdata(), SolarSystem::writeASCIIheader(), PlanetEphemeris::writeASCIIheader(), SolarSystem::writeBinaryFile(), PlanetEphemeris::writeBinaryFile(), RinexObsHeader::WriteHeaderRecords(), IonexHeader::WriteHeaderRecords(), AntexHeader::WriteHeaderRecords(), ConfDataWriter::writeVariable(), and ConfDataWriter::writeVariableList().

std::string & leftJustify (  std::string &  s, const std::string::size_type  length, const char  pad = ' ' )  throw (StringException) [inline]

Left-justifies the receiver in a string of the specified length. If the new length (length) is larger than the current length, the string is extended by the pad character (pad). The default pad character is a blank. Parameters: s  string to be modified. length  new desired length of string. pad  character to pad string with (blank by default). Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 1614 of file StringUtils.hpp.

std::string lowerCase (  const std::string &  s  )  [inline]

Change all upper-case letters in a string to lower-case. Does not modify the original string. Parameters: s  a string containing upper-case characters. Returns: a copy of the original string, all in lower-case. Definition at line 1041 of file StringUtils.hpp. Referenced by SatOrbitStore::loadGNV1BFile(), gpstk::mixedScanTime(), gpstk::scanTime(), CivilTime::setFromInfo(), and DayTime::setToString().

std::string & lowerCase (  std::string &  s  )  [inline]

Change all upper-case letters in a string to lower-case. s is modified as a result. Parameters: s  string to change to lower case. Returns: a copy of the original string, all in lower-case. Definition at line 2111 of file StringUtils.hpp.

std::string matches (  const std::string &  s, const std::string &  aPattern, const char  zeroOrMore = '*', const char  oneOrMore = '+', const char  anyChar = '.' )  throw (StringException) [inline]

Perform pattern matching on strings. Looks for a pattern in a string. Wildcards are allowed. Uses POSIX regular expressions. Parameters: s  string to search. aPattern  pattern to search for. This is a POSIX regular expression. zeroOrMore  character representing wildcards matching strings of zero or more characters (default '*'). oneOrMore  character representing plus sign matching strings of one or more characters (default '+'). anyChar  character representing wildcards matching a single arbitrary character (default '.'). Returns: string representing the first match of aPattern in s. Returns a null string if no match is found. Definition at line 1991 of file StringUtils.hpp. References GPSTK_THROW, and gpstk::StringUtils::replaceAll(). Referenced by EOPStore::addFile(), gpstk::StringUtils::isLike(), and main().

std::string memToString (  const void *  p, const std::string::size_type  size )  [inline]

Make a string from a void pointer. This function should not be used. Instead, use the string constructor as follows: string((char*)p, size); Parameters: p  pointer to memory. size  length of the data to turn into a string. Returns: string object containing the contents of p. Definition at line 2129 of file StringUtils.hpp.

int numWords (  const std::string &  s, const char  delimiter = ' ' )  throw (StringException) [inline]

Counts the number of words in s and returns it. Parameters: s  the string to count the words from. delimiter  the character that marks the start and end of a word. Returns: the number of words in s. Definition at line 2175 of file StringUtils.hpp. References gpstk::StringUtils::firstWord(), gpstk::StringUtils::stripLeading(), and gpstk::StringUtils::stripTrailing(). Referenced by ConfDataReader::getNumItem(), CommandOptionWithSimpleTimeArg::getTimeSpec(), ObsEphReaderFramework::initialize(), and main().

std::string prettyPrint (  const std::string &  aStr, const std::string &  lineDelim = "\n", const std::string &  indent = "", const std::string &  firstIndent = "     ", const std::string::size_type  len = 80, const char  wordDelim = ' ' )  throw (StringException) [inline]

Const version of prettyPrint, which nicely expands the input string into several lines. Parameters: aStr  the string to be modified. lineDelim  a string to put between every line. indent  an indentataion string used on all but the first line firstIndent  is the indentation used on the first line. len  the maximum length of string to put on a line. wordDelim  the character that separates each word. Returns: the string nicely formatted. Definition at line 1266 of file StringUtils.hpp. Referenced by CommandOptionParser::displayUsage(), CommandOption::getDescription(), and main().

std::string & prettyPrint (  std::string &  aStr, const std::string &  lineDelim = "\n", const std::string &  indent = "", const std::string &  firstIndent = "     ", const std::string::size_type  len = 80, const char  wordDelim = ' ' )  throw (StringException) [inline]

Nicely expands the input string into several lines, non-const version. Parameters: aStr  the string to be modified. lineDelim  a string to put between every line. indent  an indentataion string used on all but the first line firstIndent  is the indentation used on the first line. len  the maximum length of string to put on a line. wordDelim  the character that separates each word. Returns: the string nicely formatted. Definition at line 2565 of file StringUtils.hpp. References gpstk::StringUtils::firstWord(), GPSTK_RETHROW, GPSTK_THROW, and gpstk::StringUtils::stripLeading().

std::string printable (  const std::string &  aStr  )  throw (StringException) [inline]

Change a string into printable characters. Control characters (0-26) are changed to ^@, ^A, etc. Other non-printable characters are changed to hex sequences enclosed in <>. Parameters: aStr  the string to make printable. Definition at line 2527 of file StringUtils.hpp. Referenced by main().

std::string & removeWords (  std::string &  s, const std::string::size_type  first = 0, const std::string::size_type  wordsToReplace = std::string::npos, const char  delimiter = ' ' )  throw (StringException) [inline]

Removes indicated words from the string s. s is modified as a result. Parameters: s  a string with the words you want removed. first  the first word to be removed (the first word is 0). wordsToReplace  the number of words you want removed. delimiter  the character that marks the start and end of a word. Returns: a reference to string s with the words removed. Definition at line 2273 of file StringUtils.hpp. References gpstk::StringUtils::firstWord(), GPSTK_RETHROW, GPSTK_THROW, and gpstk::StringUtils::stripLeading(). Referenced by main().

std::string & replaceAll (  std::string &  s, const std::string &  oldString, const std::string &  newString )  throw (StringException) [inline]

Replace all instances of oldString with newString in s. Parameters: s  the string whose contents will be modified. oldString  the string to search for in s. newString  the string to replace oldString in s. Returns: a reference to the modified string. Definition at line 1905 of file StringUtils.hpp. Referenced by gpstk::StringUtils::formattedPrint(), main(), and gpstk::StringUtils::matches().

std::string rightJustify (  const std::string &  s, const std::string::size_type  length, const char  pad = ' ' )  throw (StringException) [inline]

Right-justifies the receiver in a string of the specified length (const version). If the receiver's data is shorter than the requested length (length), it is padded on the left with the pad character (pad). The default pad character is a blank. Parameters: s  string to be modified. length  new desired length of string. pad  character to pad string with (blank by default). Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 626 of file StringUtils.hpp. References gpstk::StringUtils::leftJustify(). Referenced by gpstk::StringUtils::center(), FileHunter::filterHelper(), main(), gpstk::operator<<(), SP3Header::reallyPutRecord(), SP3Data::reallyPutRecord(), SMODFData::reallyPutRecord(), SEMHeader::reallyPutRecord(), SEMData::reallyPutRecord(), RinexObsData::reallyPutRecord(), RinexNavHeader::reallyPutRecord(), RinexMetHeader::reallyPutRecord(), RinexMetData::reallyPutRecord(), RinexGloNavHeader::reallyPutRecord(), MSCData::reallyPutRecord(), IonexData::reallyPutRecord(), AntexData::reallyPutRecord(), gpstk::StringUtils::sci2for(), IonexHeader::DCB::toString(), FileSpec::toString(), SolarSystem::writeASCIIheader(), PlanetEphemeris::writeASCIIheader(), RinexObsHeader::WriteHeaderRecords(), IonexHeader::WriteHeaderRecords(), and AntexHeader::WriteHeaderRecords().

std::string & rightJustify (  std::string &  s, const std::string::size_type  length, const char  pad = ' ' )  throw (StringException) [inline]

Right-justifies the receiver in a string of the specified length. If the receiver's data is shorter than the requested length (length), it is padded on the left with the pad character (pad). The default pad character is a blank. Parameters: s  string to be modified. length  new desired length of string. pad  character to pad string with (blank by default). Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 1588 of file StringUtils.hpp.

std::string & sci2for (  std::string &  aStr, const std::string::size_type  startPos = 0, const std::string::size_type  length = std::string::npos, const std::string::size_type  expLen = 3, const bool  checkSwitch = true )  throw (StringException) [inline]

Convert scientific notation to FORTRAN notation. As an example, the string "1.5636E5" becomes " .15636D6". Note that the first character of the string will be '-' if the number is negative or ' ' if the first character is positive. Parameters: aStr  string with number to convert startPos  start position of number in string length  length (in characters) of number, including exponent. expLen  length (in characters of exponent, not including sign. checkSwitch  will keep the method running as orignially programed when set to true. If false, the method will always resize exponentials, produce an exponential with an E instead of a D, and always have a leading zero. For example -> 0.87654E-0004 or -0.1234E00005. Exceptions: Exception  if the string is not a number in scientific notation Definition at line 2360 of file StringUtils.hpp. References gpstk::StringUtils::asDouble(), gpstk::StringUtils::asInt(), gpstk::StringUtils::asString(), GPSTK_RETHROW, GPSTK_THROW, and gpstk::StringUtils::rightJustify(). Referenced by gpstk::StringUtils::doub2for().

std::vector<std::string> split (  const std::string &  aStr, const std::string &  theDelimiters = " ", bool  trimWhitespace = false, bool  ignoreEmpty = true )  [inline]

Split a string by some delimiters. Parameters: aStr  the string to be splitted theDelimiters  the delimiters to split the string trimWhitespace  will trim the token string, default is false ignoreEmpty  will ignore the empty tokens, default is true Definition at line 1285 of file StringUtils.hpp. Referenced by SRI::reshape().

std::string strip (  const std::string &  s, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip blanks from the beginning and end of a string const version. Occurrences of the space character appearing at the beginning and end of the string s are removed. Parameters: s  string to be stripped (modified). num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 528 of file StringUtils.hpp. Referenced by ConfDataReader::fetchListValue(), ConfDataItem::format(), AntexReader::getAntenna(), AntexReader::getAntennaNoRadome(), SatOrbitStore::loadGNV1BFile(), ProblemSatFilter::loadSatelliteProblemFile(), main(), ConfDataItem::parse(), IonexHeader::ParseDcbRecord(), RinexObsHeader::ParseHeaderRecord(), IonexHeader::ParseHeaderRecord(), RinexNavHeader::reallyGetRecord(), RinexMetHeader::reallyGetRecord(), RinexGloNavHeader::reallyGetRecord(), and gpstk::StringUtils::strip().

std::string& strip (  std::string &  s, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip blanks from the beginning and end of a string. Occurrences of the space character appearing at the beginning and end of the string s are removed. Parameters: s  string to be stripped (modified). num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 514 of file StringUtils.hpp.

std::string strip (  const std::string &  s, const char  aCharacter, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip character(s) from the beginning and end of a string const version. Occurrences of the character aCharacter appearing at the beginning and end of the string s are removed. Parameters: s  string to be stripped (modified). aCharacter  character to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 499 of file StringUtils.hpp. References gpstk::StringUtils::strip().

std::string& strip (  std::string &  s, const char  aCharacter, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip character(s) from the beginning and end of a string. Occurrences of the character aCharacter appearing at the beginning and end of the string s are removed. Parameters: s  string to be stripped (modified). aCharacter  character to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 483 of file StringUtils.hpp. References gpstk::StringUtils::strip().

std::string strip (  const std::string &  s, const char *  pString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the beginning and end of another string cosnt version. Occurrences of the string pString appearing at the beginning and end of the string s are removed. Parameters: s  string to be stripped (modified). pString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 467 of file StringUtils.hpp. References gpstk::StringUtils::strip().

std::string& strip (  std::string &  s, const char *  pString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the beginning and end of another string. Occurrences of the string pString appearing at the beginning and end of the string s are removed. Parameters: s  string to be stripped (modified). pString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 451 of file StringUtils.hpp. References gpstk::StringUtils::strip().

std::string strip (  const std::string &  s, const std::string &  aString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the beginning and end of another string const version. Occurrences of the string aString appearing at the beginning and end of the string s are removed. Parameters: s  string to be stripped (modified). aString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 434 of file StringUtils.hpp. References gpstk::StringUtils::strip().

std::string & strip (  std::string &  s, const std::string &  aString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the beginning and end of another string. Occurrences of the string aString appearing at the beginning and end of the string s are removed. Parameters: s  string to be stripped (modified). aString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 1514 of file StringUtils.hpp.

std::string stripFirstWord (  std::string &  s, const char  delimiter = ' ' )  throw (StringException) [inline]

Removes the first word off string s and returns it. s is modified as a result. Parameters: s  a string with the word you want removed. delimiter  the character that marks the start and end of a word. Returns: the first word from s Definition at line 2250 of file StringUtils.hpp. References gpstk::StringUtils::firstWord(), and gpstk::StringUtils::stripLeading(). Referenced by main(), ConfDataItem::parse(), SolarSystem::readASCIIdata(), PlanetEphemeris::readASCIIdata(), SolarSystem::readASCIIheader(), and PlanetEphemeris::readASCIIheader().

std::string stripLeading (  const std::string &  s, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip blanks from the beginning of a string const version. Occurrences of the space character appearing at the beginning of the string s are removed. Parameters: s  string to be stripped (modified). num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 280 of file StringUtils.hpp. Referenced by MSCStore::addMSC(), MSCStore::findMSC(), TimeTag::getInfo(), FileSpec::init(), YumaData::lineParser(), ProblemSatFilter::loadSatelliteProblemFile(), main(), gpstk::StringUtils::numWords(), gpstk::StringUtils::prettyPrint(), SolarSystem::readASCIIheader(), PlanetEphemeris::readASCIIheader(), gpstk::StringUtils::removeWords(), Position::setToString(), DayTime::setToString(), gpstk::StringUtils::stripFirstWord(), and gpstk::StringUtils::stripLeading().

std::string& stripLeading (  std::string &  s, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip blanks from the beginning of a string. Occurrences of the space character appearing at the beginning of the string s are removed. Parameters: s  string to be stripped (modified). num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 266 of file StringUtils.hpp.

std::string stripLeading (  const std::string &  s, const char  aCharacter, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip character(s) from the beginning of a string const version. Occurrences of the character aCharacter appearing at the beginning of the string s are removed. Parameters: s  string to be stripped (modified). aCharacter  character to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 251 of file StringUtils.hpp. References gpstk::StringUtils::stripLeading().

std::string& stripLeading (  std::string &  s, const char  aCharacter, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip character(s) from the beginning of a string. Occurrences of the character aCharacter appearing at the beginning of the string s are removed. Parameters: s  string to be stripped (modified). aCharacter  character to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 235 of file StringUtils.hpp. References gpstk::StringUtils::stripLeading().

std::string stripLeading (  const std::string &  s, const char *  pString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the beginning of another string const version. Occurrences of the string pString appearing at the beginning of the string s are removed. Parameters: s  string to be stripped (modified). pString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 219 of file StringUtils.hpp. References gpstk::StringUtils::stripLeading().

std::string& stripLeading (  std::string &  s, const char *  pString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the beginning of another string. Occurrences of the string pString appearing at the beginning of the string s are removed. Parameters: s  string to be stripped (modified). pString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 203 of file StringUtils.hpp. References gpstk::StringUtils::stripLeading().

std::string stripLeading (  const std::string &  s, const std::string &  aString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the beginning of another string const version. Occurrences of the string aString appearing at the beginning of the string s are removed. Parameters: s  string to be stripped (modified). aString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 187 of file StringUtils.hpp. References gpstk::StringUtils::stripLeading().

std::string & stripLeading (  std::string &  s, const std::string &  aString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the beginning of another string. Occurrences of the string aString appearing at the beginning of the string s are removed. Parameters: s  string to be stripped (modified). aString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 1456 of file StringUtils.hpp.

std::string stripTrailing (  const std::string &  s, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip blanks from the end of a string const version. Occurrences of the space character appearing at the end of the string s are removed. Parameters: s  string to be stripped (modified). num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 403 of file StringUtils.hpp. Referenced by EOPStore::addIERSFile(), MSCStore::addMSC(), MSCStore::findMSC(), EOPPrediction::loadFile(), EOPDataStore::loadIERSFile(), EOPDataStore::loadIGSFile(), ProblemSatFilter::loadSatelliteProblemFile(), main(), gpstk::StringUtils::numWords(), AntexHeader::ParseHeaderRecord(), SolarSystem::readASCIIdata(), PlanetEphemeris::readASCIIdata(), SolarSystem::readASCIIheader(), PlanetEphemeris::readASCIIheader(), RinexObsHeader::reallyGetRecord(), RinexObsData::reallyGetRecord(), RinexNavHeader::reallyGetRecord(), RinexGloNavHeader::reallyGetRecord(), IonexHeader::reallyGetRecord(), IonexData::reallyGetRecord(), AntexHeader::reallyGetRecord(), AntexData::reallyGetRecord(), gpstk::RegisterExtendedRinexObsType(), Position::setToString(), and gpstk::StringUtils::stripTrailing().

std::string& stripTrailing (  std::string &  s, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip blanks from the end of a string. Occurrences of the space character appearing at the end of the string s are removed. Parameters: s  string to be stripped (modified). num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 389 of file StringUtils.hpp.

std::string stripTrailing (  const std::string &  s, const char  aCharacter, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip character(s) from the end of a string const version. Occurrences of the character aCharacter appearing at the end of the string s are removed. Parameters: s  string to be stripped (modified). aCharacter  character to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 374 of file StringUtils.hpp. References gpstk::StringUtils::stripTrailing().

std::string& stripTrailing (  std::string &  s, const char  aCharacter, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Strip character(s) from the end of a string. Occurrences of the character aCharacter appearing at the end of the string s are removed. Parameters: s  string to be stripped (modified). aCharacter  character to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 358 of file StringUtils.hpp. References gpstk::StringUtils::stripTrailing().

std::string stripTrailing (  const std::string &  s, const char *  pString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the end of another string const version. Occurrences of the string pString appearing at the end of the string s are removed. Parameters: s  string to be stripped (modified). pString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 342 of file StringUtils.hpp. References gpstk::StringUtils::stripTrailing().

std::string& stripTrailing (  std::string &  s, const char *  pString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the end of another string. Occurrences of the string pString appearing at the end of the string s are removed. Parameters: s  string to be stripped (modified). pString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 326 of file StringUtils.hpp. References gpstk::StringUtils::stripTrailing().

std::string stripTrailing (  const std::string &  s, const std::string &  aString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the end of another string const version. Occurrences of the string aString appearing at the end of the string s are removed. Parameters: s  string to be stripped (modified). aString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 310 of file StringUtils.hpp. References gpstk::StringUtils::stripTrailing().

std::string & stripTrailing (  std::string &  s, const std::string &  aString, std::string::size_type  num = std::string::npos )  throw (StringException) [inline]

Remove a string from the end of another string. Occurrences of the string aString appearing at the end of the string s are removed. Parameters: s  string to be stripped (modified). aString  string to remove. num  maximum number of occurrences to remove. Exceptions: StringException  if there's a std::exception thrown. Returns: a reference to s. Definition at line 1484 of file StringUtils.hpp. Referenced by FFTextStream::formattedGetLine().

std::string subString (  const std::string &  s, const std::string::size_type  startPos = 0, const std::string::size_type  length = std::string::npos, const char  pad = ' ' )  throw (StringException) [inline]

Get a substring of a string. Try to avoid using this, use the stl string's substr method instead (and leftJustify if needed). Definition at line 2085 of file StringUtils.hpp. References GPSTK_RETHROW, GPSTK_THROW, and gpstk::StringUtils::leftJustify().

std::string translate (  const std::string &  aString, const std::string &  inputChars, const std::string &  outputChars, const char  pad = ' ' )  [inline]

Converts all of the receiver's characters that are in the first specified string to the corresponding character in the second specified string. Parameters: aString  string to perform translation on. inputChars  characters in aString to translate from. outputChars  characters to translate to. pad  pad character in the event inputChars and outputChars are not equal length. The pad character will become the translated character. Definition at line 1524 of file StringUtils.hpp. Referenced by main(), gpstk::translate(), and gpstk::translateInPlace().

std::string upperCase (  const std::string &  s  )  [inline]

Change all lower-case letters in a string to upper-case. Does not modify the original string. Parameters: s  a string containing lower-case characters. Returns: a copy of the original string, all in upper-case. Definition at line 1058 of file StringUtils.hpp. Referenced by ConfDataReader::fetchListValue(), ConfDataReader::fetchListValueAsBoolean(), AntexReader::getAntenna(), AntexReader::getAntennaNoRadome(), ConfDataReader::getValue(), ConfDataReader::getValueAsBoolean(), ConfDataReader::getValueDescription(), ConfDataReader::getVariableDescription(), ConfDataReader::ifExist(), gnssConfData::keepOnly(), ConfDataItem::parse(), and Expression::set().

std::string & upperCase (  std::string &  s  )  [inline]

Change all lower-case letters in a string to upper-case. s is modified as a result. Parameters: s  string to change to upper case. Returns: a copy of the original string, all in upper-case. Definition at line 2120 of file StringUtils.hpp.

std::string word (  const std::string &  s, const std::string::size_type  wordNum = 0, const char  delimiter = ' ' )  throw (StringException) [inline]

Returns word number wordNum from s (if any). Parameters: s  a string with the word you want removed. wordNum  the number of the word you want from s. The first word is word 0. delimiter  the character that marks the start and end of a word. Returns: the first word from s or an empty string if there is no wordNum'th word. Definition at line 1123 of file StringUtils.hpp. Referenced by HelpFormatter::clearWord(), AshtechEPB::decode(), AshtechALB::decode(), AshtechEPB::dump(), HelpFormatter::formatText(), HelpFormatter::formatWord(), GDCreturn::GDCreturn(), FICData::getElementLabel(), ObsEphReaderFramework::initialize(), EOPPrediction::loadFile(), main(), SolarSystem::readASCIIheader(), and PlanetEphemeris::readASCIIheader().

std::string words (  const std::string &  s, const std::string::size_type  firstWord = 0, const std::string::size_type  numWords = std::string::npos, const char  delimiter = ' ' )  throw (StringException) [inline]

Returns numWords words starting with firstWord from s (if any). Parameters: s  a string with the word you want removed. firstWord  the number of the first word you want from s. The first word is word 0. numWords  number of words to get from s. delimiter  the character that marks the start and end of a word. Returns: the first word from s or an empty string if there is no wordNum'th word. Definition at line 2204 of file StringUtils.hpp. References gpstk::StringUtils::firstWord(), GPSTK_RETHROW, and GPSTK_THROW. Referenced by GDCreturn::GDCreturn(), and main().

std::string x2d (  const std::string &  s  )  throw (StringException) [inline]

Convert a hexadecimal string to a decimal string. Given a string containing a hexadecimal number, convert the integer from base 16 to base 10 and return the result. Only the first hex number encountered is changed; the rest of the string is unmodified. Parameters: s  string containing an integer. Returns: string containing a hexadecimal number. Definition at line 833 of file StringUtils.hpp. Referenced by main().

std::string & x2d (  std::string &  s  )  throw (StringException) [inline]

Modify the string such that the hexadecimal number is now represented as decimal. Only the first hex number encountered is changed; the rest of the string is unmodified. Parameters: s  string containing an integer. Returns: reference to modified s. Definition at line 1851 of file StringUtils.hpp.

unsigned int x2int (  const std::string &  s  )  throw (StringException) [inline]

Only the first hex number encountered is converted. Parameters: s  string containing a hex integer. Returns: a long holding the value of s. Definition at line 1812 of file StringUtils.hpp.

---