Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ticc_string(1)		    General Commands Manual		ticc_string(1)

NAME
       ticc_string - A collection of C++ string	manipulating utilities.

SYNOPSIS
       #include	ticcutils/StringOps.h

       using namespace TiCC;

DESCRIPTION
       Ticc  String  Utilities provides	a few convenient functions for manipu-
       lating C++ 'string' objects. These functions are	 widely	 used  in  the
       TiCC software stack , but are of	general	use too.

List of	Functions
       string trim( const string& in, const string& filter= " \t\r\n" );
	      Remove  from  in	all  leading  and trailing characters that are
	      present in filter.

	      Embedded characters are retained.

       string trim_front( const	string&	in, const string& filter =  "  \t\r\n"
       );
	      Remove  from  in all leading characters that are present in fil-
	      ter.

	      Embedded characters are retained.

       string trim_back( const string& in, const string& filter	= " \t\r\n" );
	      Remove from in all trailing characters that are present in  fil-
	      ter.

	      Embedded characters are retained.

       void to_lower( string& s	);
	      convert all characters in	s to lowercase filter.

       void to_upper( string& s	);
	      convert all characters in	s to uppercase filter.

       string lowercase( const string& in );
	      Return a string that contains the	lowercase of the characters in
	      in.

       string uppercase( const string& in );
	      Return a string that contains the	uppercase of the characters in
	      in.

       size_t  split_at(  const	 string& s, vector<string>& vec, const string&
       sep, bool exact=false );
	      split the	input string s at every	position of the	string sep and
	      return the parts in the string vector vec.

	      consecutive  occurrences	of  sep	 are  all skipped, so vec will
	      never contain empty strings, except when exact is	set to true.

	      return value: The	size of	vec.

       size_t split_at_first_of( const string& s, vector<string>&  vec,	 const
       string& filter, bool exact=false	);
	      split the	input string s at every	occurrence of one of the char-
	      acters from filter and return the	parts  in  the	string	vector
	      vec.

	      consecutive occurrences of filter	characters are all skipped, so
	      vec will never contain empty strings, except when	exact  is  set
	      to true.

	      return value: The	size of	vec.

       inline  size_t  split(  const  string& s, vector<string>& vec, bool ex-
       act=false return	split_at_first_of( s, vec, " \t\r\n" );	}
	      split the	input string s at every	 occurrence  of	 a  whitespace
	      character, and return the	parts in the string vector vec

	      consecutive occurrences of filter	characters are all skipped, so
	      vec will never contain empty strings, except when	exact  is  set
	      to true.

	      return value: The	size of	vec

       bool match_front( const string& s, const	string&	f );
	      does the string s	start with the string f	?

       bool match_back(	const string& s, const string& b );
	      does the string s	end with the string b ?

       template< typename T > T	stringTo( const	std::string& s )
	      convert the string s into	a value	of type	T

	      Might throw when the conversion fails.

       template< typename T > bool stringTo( const std::string&	s, T& result )
	      convert  the string s into a result value	of type	T return false
	      when the conversion fails, otherwise returns true

       template<> bool stringTo( const std::string& s )
	      convert the string s into	a value	of type	bool

	      The string values: YES , TRUE , 1	yield true (case  insensitive)
	      The string values: NO , FALSE , 0	yield false (case insensitive)

	      Will throw when conversion fails.

       template< typename T > string toString (	const T& obj );
	      convert the obj of type T	to a string. It	uses the << output op-
	      erator for obj so	it will	fail if	that operator is unavailable

       string basename(	const string& f	);
	      returns the basename for filename	f.  The	basename is defined as
	      the  string after	the last / in f.  If there is no / present, it
	      will return the input string f.

       string dirname( const string& f );
	      returns the pathname for filename	f.  The	pathname is defined as
	      the string before	the last / in f.  If there is no / present, it
	      will return ..

       string format_nonascii( const string& s );
	      given a string s with possibly unprintable  (non-ascii)  charac-
	      ters,  produce  a	string where these are replaced	by hexadecimal
	      representations.	Useful for debugging Unicode stuff.

AUTHORS
       Ko van der Sloot	lamasoftware@science.ru.nl

			       2015 November 26			ticc_string(1)

NAME | SYNOPSIS | DESCRIPTION | List of Functions | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ticc_string&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help