TStringToken Class Reference

Provides iteration through tokens of a given string.

• fFullStr stores the string to be split. It is never modified.
• fSplitRe is the perl-re that is used to separate the tokens.
• fReturnVoid if true, empty strings will be returned.

Current token is stored in the TString base-class. During construction no match is done, use NextToken() to get the first and all subsequent tokens.

Definition at line 149 of file TPRegexp.h.

Public Member Functions
	TStringToken (const TString &fullStr, const TString &splitRe, Bool_t retVoid=kFALSE)
	Constructor. More...
virtual	~TStringToken ()
Bool_t	AtEnd () const
Bool_t	NextToken ()
	Get the next token, it is stored in this TString. More...
Public Member Functions inherited from TString
	TString ()
	TString default ctor. More...
	TString (Ssiz_t ic)
	Create TString able to contain ic characters. More...
	TString (const TString &s)
	Copy constructor. More...
	TString (TString &&s)
	Move constructor. More...
	TString (const char *s)
	Create TString and initialize it with string cs. More...
	TString (const char *s, Ssiz_t n)
	Create TString and initialize it with the first n characters of cs. More...
	TString (const std::string &s)
	Create TString and initialize it with string cs. More...
	TString (char c)
	Initialize a string with a single character. More...
	TString (char c, Ssiz_t s)
	Initialize the first n locations of a TString with character c. More...
	TString (const std::string_view &sub)
	TString (const TSubString &sub)
	Copy a TSubString in a TString. More...
virtual	~TString ()
	Delete a TString. More...
TString &	Append (const char *cs)
TString &	Append (const char *cs, Ssiz_t n)
TString &	Append (const TString &s)
TString &	Append (const TString &s, Ssiz_t n)
TString &	Append (char c, Ssiz_t rep=1)
	Append character c rep times to string. More...
Double_t	Atof () const
	Return floating-point value contained in string. More...
Int_t	Atoi () const
	Return integer value of string. More...
Long64_t	Atoll () const
	Return long long value of string. More...
Bool_t	BeginsWith (const char *s, ECaseCompare cmp=kExact) const
Bool_t	BeginsWith (const TString &pat, ECaseCompare cmp=kExact) const
Ssiz_t	Capacity () const
Ssiz_t	Capacity (Ssiz_t n)
	Return string capacity. More...
TString &	Chop ()
void	Clear ()
	Clear string without changing its capacity. More...
int	CompareTo (const char *cs, ECaseCompare cmp=kExact) const
	Compare a string to char *cs2. More...
int	CompareTo (const TString &st, ECaseCompare cmp=kExact) const
	Compare a string to another string. More...
Bool_t	Contains (const char *pat, ECaseCompare cmp=kExact) const
Bool_t	Contains (const TString &pat, ECaseCompare cmp=kExact) const
Bool_t	Contains (const TRegexp &pat) const
Bool_t	Contains (TPRegexp &pat) const
TString	Copy () const
	Copy a string. More...
Int_t	CountChar (Int_t c) const
	Return number of times character c occurs in the string. More...
const char *	Data () const
Bool_t	EndsWith (const char *pat, ECaseCompare cmp=kExact) const
	Return true if string ends with the specified string. More...
Bool_t	EqualTo (const char *cs, ECaseCompare cmp=kExact) const
Bool_t	EqualTo (const TString &st, ECaseCompare cmp=kExact) const
virtual void	FillBuffer (char *&buffer) const
	Copy string into I/O buffer. More...
Ssiz_t	First (char c) const
	Find first occurrence of a character c. More...
Ssiz_t	First (const char *cs) const
	Find first occurrence of a character in cs. More...
void	Form (const char *fmt,...)
	Formats a string using a printf style format descriptor. More...
Bool_t	Gets (FILE *fp, Bool_t chop=kTRUE)
	Read one line from the stream, including the , or until EOF. More...
UInt_t	Hash (ECaseCompare cmp=kExact) const
	Return hash value. More...
Ssiz_t	Index (const char *pat, Ssiz_t i=0, ECaseCompare cmp=kExact) const
Ssiz_t	Index (const TString &s, Ssiz_t i=0, ECaseCompare cmp=kExact) const
Ssiz_t	Index (const char *pat, Ssiz_t patlen, Ssiz_t i, ECaseCompare cmp) const
	Search for a string in the TString. More...
Ssiz_t	Index (const TString &s, Ssiz_t patlen, Ssiz_t i, ECaseCompare cmp) const
Ssiz_t	Index (const TRegexp &pat, Ssiz_t i=0) const
	Find the first occurrence of the regexp in string and return the position, or -1 if there is no match. More...
Ssiz_t	Index (const TRegexp &pat, Ssiz_t *ext, Ssiz_t i=0) const
	Find the first occurrence of the regexp in string and return the position, or -1 if there is no match. More...
Ssiz_t	Index (TPRegexp &pat, Ssiz_t i=0) const
	Find the first occurrence of the regexp in string and return the position. More...
Ssiz_t	Index (TPRegexp &pat, Ssiz_t *ext, Ssiz_t i=0) const
	Find the first occurrence of the regexp in string and return the position. More...
TString &	Insert (Ssiz_t pos, const char *s)
TString &	Insert (Ssiz_t pos, const char *s, Ssiz_t extent)
TString &	Insert (Ssiz_t pos, const TString &s)
TString &	Insert (Ssiz_t pos, const TString &s, Ssiz_t extent)
Bool_t	IsAlnum () const
	Returns true if all characters in string are alphanumeric. More...
Bool_t	IsAlpha () const
	Returns true if all characters in string are alphabetic. More...
Bool_t	IsAscii () const
	Returns true if all characters in string are ascii. More...
Bool_t	IsBin () const
	Returns true if all characters in string are binary digits (0,1). More...
Bool_t	IsDec () const
	Returns true if all characters in string are decimal digits (0-9). More...
Bool_t	IsDigit () const
	Returns true if all characters in string are digits (0-9) or white spaces, i.e. More...
Bool_t	IsFloat () const
	Returns kTRUE if string contains a floating point or integer number. More...
Bool_t	IsHex () const
	Returns true if all characters in string are hexadecimal digits (0-9,a-f,A-F). More...
Bool_t	IsInBaseN (Int_t base) const
	Returns true if all characters in string are expressed in the base specified (range=2-36), i.e. More...
Bool_t	IsNull () const
Bool_t	IsOct () const
	Returns true if all characters in string are octal digits (0-7). More...
Bool_t	IsWhitespace () const
Ssiz_t	Last (char c) const
	Find last occurrence of a character c. More...
Ssiz_t	Length () const
Bool_t	MaybeRegexp () const
	Returns true if string contains one of the regexp characters "^$.[]*+?". More...
Bool_t	MaybeWildcard () const
	Returns true if string contains one of the wildcard characters "[]*?". More...
TString	MD5 () const
	Return the MD5 digest for this string, in a string representation. More...
	operator const char * () const
	operator std::string_view () const
char &	operator() (Ssiz_t i)
char	operator() (Ssiz_t i) const
TSubString	operator() (Ssiz_t start, Ssiz_t len) const
	Return sub-string of string starting at start with length len. More...
TSubString	operator() (const TRegexp &re) const
	Return the substring found by applying the regexp. More...
TSubString	operator() (const TRegexp &re, Ssiz_t start) const
	Return the substring found by applying the regexp starting at start. More...
TSubString	operator() (TPRegexp &re) const
	Return the substring found by applying the regexp. More...
TSubString	operator() (TPRegexp &re, Ssiz_t start) const
	Return the substring found by applying the regexp starting at start. More...
TString &	operator+= (const char *s)
TString &	operator+= (const TString &s)
TString &	operator+= (char c)
TString &	operator+= (Short_t i)
TString &	operator+= (UShort_t i)
TString &	operator+= (Int_t i)
TString &	operator+= (UInt_t i)
TString &	operator+= (Long_t i)
TString &	operator+= (ULong_t i)
TString &	operator+= (Float_t f)
TString &	operator+= (Double_t f)
TString &	operator+= (Long64_t i)
TString &	operator+= (ULong64_t i)
TString &	operator= (char s)
	Assign character c to TString. More...
TString &	operator= (const char *s)
	Assign string cs to TString. More...
TString &	operator= (const TString &s)
	Assignment operator. More...
TString &	operator= (const std::string &s)
	Assign std::string s to TString. More...
TString &	operator= (const std::string_view &s)
	Assign std::string s to TString. More...
TString &	operator= (const TSubString &s)
	Assign a TSubString substr to TString. More...
char &	operator[] (Ssiz_t i)
char	operator[] (Ssiz_t i) const
TString &	Prepend (const char *cs)
TString &	Prepend (const char *cs, Ssiz_t n)
TString &	Prepend (const TString &s)
TString &	Prepend (const TString &s, Ssiz_t n)
TString &	Prepend (char c, Ssiz_t rep=1)
	Prepend character c rep times to string. More...
void	Puts (FILE *fp)
	Write string to the stream. More...
virtual void	ReadBuffer (char *&buffer)
	Read string from I/O buffer. More...
std::istream &	ReadFile (std::istream &str)
	Replace string with the contents of strm, stopping at an EOF. More...
std::istream &	ReadLine (std::istream &str, Bool_t skipWhite=kTRUE)
	Read a line from stream upto newline skipping any whitespace. More...
std::istream &	ReadString (std::istream &str)
	Read a line from stream upto \0, including any newline. More...
std::istream &	ReadToDelim (std::istream &str, char delim='\n')
	Read up to an EOF, or a delimiting character, whichever comes first. More...
std::istream &	ReadToken (std::istream &str)
	Read a token, delimited by whitespace, from the input stream. More...
TString &	Remove (Ssiz_t pos)
TString &	Remove (Ssiz_t pos, Ssiz_t n)
TString &	Remove (EStripType s, char c)
	Remove char c at begin and/or end of string (like Strip()) but modifies directly the string. More...
TString &	Replace (Ssiz_t pos, Ssiz_t n, const char *s)
TString &	Replace (Ssiz_t pos, Ssiz_t n, const char *s, Ssiz_t ns)
	Remove at most n1 characters from self beginning at pos, and replace them with the first n2 characters of cs. More...
TString &	Replace (Ssiz_t pos, Ssiz_t n, const TString &s)
TString &	Replace (Ssiz_t pos, Ssiz_t n1, const TString &s, Ssiz_t n2)
TString &	ReplaceAll (const TString &s1, const TString &s2)
TString &	ReplaceAll (const TString &s1, const char *s2)
TString &	ReplaceAll (const char *s1, const TString &s2)
TString &	ReplaceAll (const char *s1, const char *s2)
TString &	ReplaceAll (const char *s1, Ssiz_t ls1, const char *s2, Ssiz_t ls2)
	Find & Replace ls1 symbols of s1 with ls2 symbols of s2 if any. More...
void	Resize (Ssiz_t n)
	Resize the string. Truncate or add blanks as necessary. More...
virtual Int_t	Sizeof () const
	Returns size string will occupy on I/O buffer. More...
TSubString	Strip (EStripType s=kTrailing, char c=' ') const
	Return a substring of self stripped at beginning and/or end. More...
TSubString	SubString (const char *pat, Ssiz_t start=0, ECaseCompare cmp=kExact) const
	Returns a substring matching "pattern", or the null substring if there is no such match. More...
TString &	Swap (TString &other)
TObjArray *	Tokenize (const TString &delim) const
	This function is used to isolate sequential tokens in a TString. More...
Bool_t	Tokenize (TString &tok, Ssiz_t &from, const char *delim=" ") const
	Search for tokens delimited by regular expression 'delim' (default " ") in this string; search starts at 'from' and the token is returned in 'tok'. More...
void	ToLower ()
	Change string to lower-case. More...
void	ToUpper ()
	Change string to upper case. More...

Protected Attributes
const TString	fFullStr
Int_t	fPos
Bool_t	fReturnVoid
TPRegexp	fSplitRe
Protected Attributes inherited from TString
Rep_t	fRep

Additional Inherited Members
Public Types inherited from TString
enum	ECaseCompare { kExact, kIgnoreCase }
enum	EStripType { kLeading = 0x1, kTrailing = 0x2, kBoth = 0x3 }
Static Public Member Functions inherited from TString
static TString	BaseConvert (const TString &s_in, Int_t base_in, Int_t base_out)
	Converts string from base base_in to base base_out. More...
static TString	Format (const char *fmt,...)
	Static method which formats a string using a printf style format descriptor and return a TString. More...
static Ssiz_t	GetInitialCapacity ()
static Ssiz_t	GetMaxWaste ()
static Ssiz_t	GetResizeIncrement ()
static UInt_t	Hash (const void *txt, Int_t ntxt)
	Calculates hash index from any char string. More...
static Ssiz_t	InitialCapacity (Ssiz_t ic=15)
	Set default initial capacity for all TStrings. Default is 15. More...
static TString	Itoa (Int_t value, Int_t base)
	Converts an Int_t to a TString with respect to the base specified (2-36). More...
static TString	LLtoa (Long64_t value, Int_t base)
	Converts a Long64_t to a TString with respect to the base specified (2-36). More...
static Ssiz_t	MaxWaste (Ssiz_t mw=15)
	Set maximum space that may be wasted in a string before doing a resize. More...
static TString *	ReadString (TBuffer &b, const TClass *clReq)
	Read TString object from buffer. More...
static Ssiz_t	ResizeIncrement (Ssiz_t ri=16)
	Set default resize increment for all TStrings. Default is 16. More...
static TString	UItoa (UInt_t value, Int_t base)
	Converts a UInt_t (twice the range of an Int_t) to a TString with respect to the base specified (2-36). More...
static TString	ULLtoa (ULong64_t value, Int_t base)
	Converts a ULong64_t (twice the range of an Long64_t) to a TString with respect to the base specified (2-36). More...
static void	WriteString (TBuffer &b, const TString *a)
	Write TString object to buffer. More...
Static Public Attributes inherited from TString
static const Ssiz_t	kNPOS = ::kNPOS
Protected Types inherited from TString
enum	{ kAlignment = 16 }
Protected Member Functions inherited from TString
	TString (const char *a1, Ssiz_t n1, const char *a2, Ssiz_t n2)
	String data. More...
void	AssertElement (Ssiz_t nc) const
	Check to make sure a string index is in range. More...
void	Clobber (Ssiz_t nc)
	Clear string and make sure it has a capacity of nc. More...
void	InitChar (char c)
	Initialize a string with a single character. More...
Static Protected Member Functions inherited from TString
static Ssiz_t	AdjustCapacity (Ssiz_t oldCap, Ssiz_t newCap)
	Calculate a nice capacity greater than or equal to newCap. More...
static Ssiz_t	Align (Ssiz_t s)
static Ssiz_t	Recommend (Ssiz_t s)

#include <TPRegexp.h>

Inheritance diagram for TStringToken:

Constructor & Destructor Documentation

TStringToken()

TStringToken::TStringToken	(	const TString &	fullStr,
		const TString &	splitRe,
		Bool_t	retVoid = kFALSE
	)

Constructor.

Definition at line 962 of file TPRegexp.cxx.

~TStringToken()

virtual TStringToken::~TStringToken ( )

inlinevirtual

Definition at line 159 of file TPRegexp.h.

Member Function Documentation

AtEnd()

Bool_t TStringToken::AtEnd ( ) const

inline

Definition at line 162 of file TPRegexp.h.

NextToken()

Bool_t TStringToken::NextToken

(

)

Get the next token, it is stored in this TString.

Returns true if new token is available, false otherwise.

Definition at line 974 of file TPRegexp.cxx.

Member Data Documentation

fFullStr

const TString TStringToken::fFullStr

protected

Definition at line 152 of file TPRegexp.h.

fPos

Int_t TStringToken::fPos

protected

Definition at line 155 of file TPRegexp.h.

fReturnVoid

Bool_t TStringToken::fReturnVoid

protected

Definition at line 154 of file TPRegexp.h.

fSplitRe

TPRegexp TStringToken::fSplitRe

protected

Definition at line 153 of file TPRegexp.h.

---

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

• core/base/inc/TPRegexp.h
• core/base/src/TPRegexp.cxx