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 143 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 (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 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 (const std::string_view &sub)
	Copy a std::string_view in a TString. More...

	TString (const TString &s)
	Copy constructor. More...

	TString (const TSubString &sub)
	Copy a TSubString in a TString. More...

	TString (Ssiz_t ic)
	Create TString able to contain ic characters. More...

	TString (TString &&s) noexcept
	Move constructor. More...

virtual	~TString ()
	Delete a TString. More...

TString &	Append (char c, Ssiz_t rep=1)
	Append character c rep times to string. 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)

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 TRegexp &pat) const

Bool_t	Contains (const TString &pat, ECaseCompare cmp=kExact) 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 char *pat, Ssiz_t patlen, Ssiz_t i, ECaseCompare cmp) const
	Search for a string in the TString. 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 (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 TString &s, Ssiz_t i=0, ECaseCompare cmp=kExact) const

Ssiz_t	Index (const TString &s, Ssiz_t patlen, Ssiz_t i, ECaseCompare cmp) const

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...

Ssiz_t	Index (TPRegexp &pat, 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 ROOT::Internal::TStringView () const

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...

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() (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+= (char c)

TString &	operator+= (const char *s)

TString &	operator+= (const TString &s)

template<class T >
std::enable_if< ROOT::TypeTraits::IsFloatNumeral< T >::value, TString >::type &	operator+= (T f)

template<class T >
std::enable_if< ROOT::TypeTraits::IsSignedNumeral< T >::value, TString >::type &	operator+= (T i)

template<class T >
std::enable_if< ROOT::TypeTraits::IsUnsignedNumeral< T >::value, TString >::type &	operator+= (T u)

TString &	operator= (char s)
	Assign character c to TString. More...

TString &	operator= (const char *s)
	Assign string cs to TString. 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 TString &s)
	Assignment operator. More...

TString &	operator= (const TSubString &s)
	Assign a TSubString substr to TString. More...

TString &	operator= (TString &&s) noexcept
	Move-Assignment operator. More...

char &	operator[] (Ssiz_t i)

char	operator[] (Ssiz_t i) const

TString &	Prepend (char c, Ssiz_t rep=1)
	Prepend character c rep times to string. More...

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)

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 (EStripType s, char c)
	Remove char c at begin and/or end of string (like Strip()) but modifies directly the string. More...

TString &	Remove (Ssiz_t pos)

TString &	Remove (Ssiz_t pos, Ssiz_t n)

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 char s1, const char s2)

TString &	ReplaceAll (const char *s1, const TString &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...

TString &	ReplaceAll (const TString &s1, const char *s2)

TString &	ReplaceAll (const TString &s1, const TString &s2)

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...

std::string_view	View () const

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:

[legend]

Constructor & Destructor Documentation

◆ TStringToken()

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

Constructor.

Definition at line 965 of file TPRegexp.cxx.

◆ ~TStringToken()

virtual TStringToken::~TStringToken ( )

inlinevirtual

Definition at line 153 of file TPRegexp.h.

Member Function Documentation

◆ AtEnd()

Bool_t TStringToken::AtEnd ( ) const

inline

Definition at line 156 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 977 of file TPRegexp.cxx.

Member Data Documentation

◆ fFullStr

const TString TStringToken::fFullStr

protected

Definition at line 146 of file TPRegexp.h.

◆ fPos

Int_t TStringToken::fPos

protected

Definition at line 149 of file TPRegexp.h.

◆ fReturnVoid

Bool_t TStringToken::fReturnVoid

protected

Definition at line 148 of file TPRegexp.h.

◆ fSplitRe

TPRegexp TStringToken::fSplitRe

protected

Definition at line 147 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

Public Member Functions

Protected Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ TStringToken()

◆ ~TStringToken()

Member Function Documentation

◆ AtEnd()

◆ NextToken()

Member Data Documentation

◆ fFullStr

◆ fPos

◆ fReturnVoid

◆ fSplitRe