Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
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 143 of file TPRegexp.h.

Public Member Functions

 TStringToken (const TString &fullStr, const TString &splitRe, Bool_t retVoid=kFALSE)
 Constructor.
 
virtual ~TStringToken ()
 
Bool_t AtEnd () const
 
TClassIsA () const override
 
Bool_t NextToken ()
 Get the next token, it is stored in this TString.
 
void Streamer (TBuffer &) override
 Stream a string object.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
- Public Member Functions inherited from TString
 TString ()
 TString default ctor.
 
 TString (char c)
 Initialize a string with a single character.
 
 TString (char c, Ssiz_t s)
 Initialize the first n locations of a TString with character c.
 
 TString (const char *s)
 Create TString and initialize it with string cs.
 
 TString (const char *s, Ssiz_t n)
 Create TString and initialize it with the first n characters of cs.
 
 TString (const std::string &s)
 Create TString and initialize it with string cs.
 
 TString (const std::string_view &sub)
 Copy a std::string_view in a TString.
 
 TString (const TString &s)
 Copy constructor.
 
 TString (const TSubString &sub)
 Copy a TSubString in a TString.
 
 TString (Ssiz_t ic)
 Create TString able to contain ic characters.
 
 TString (TString &&s) noexcept
 Move constructor.
 
virtual ~TString ()
 Delete a TString.
 
TStringAppend (char c, Ssiz_t rep=1)
 Append character c rep times to string.
 
TStringAppend (const char *cs)
 
TStringAppend (const char *cs, Ssiz_t n)
 
TStringAppend (const TString &s)
 
TStringAppend (const TString &s, Ssiz_t n)
 
Double_t Atof () const
 Return floating-point value contained in string.
 
Int_t Atoi () const
 Return integer value of string.
 
Long64_t Atoll () const
 Return long long value of string.
 
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.
 
TStringChop ()
 
void Clear ()
 Clear string without changing its capacity.
 
int CompareTo (const char *cs, ECaseCompare cmp=kExact) const
 Compare a string to char *cs2.
 
int CompareTo (const TString &st, ECaseCompare cmp=kExact) const
 Compare a string to another string.
 
Bool_t Contains (const char *pat, ECaseCompare cmp=kExact) const
 
Bool_t Contains (const TRegexp &pat) const
 Returns whether the string matches the input TRegexp.
 
Bool_t Contains (const TString &pat, ECaseCompare cmp=kExact) const
 
Bool_t Contains (TPRegexp &pat) const
 
TString Copy () const
 Copy a string.
 
Int_t CountChar (Int_t c) const
 Return number of times character c occurs in the string.
 
const char * Data () const
 
Bool_t EndsWith (const char *pat, ECaseCompare cmp=kExact) const
 Return true if string ends with the specified string.
 
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.
 
Ssiz_t First (char c) const
 Find first occurrence of a character c.
 
Ssiz_t First (const char *cs) const
 Find first occurrence of a character in cs.
 
void Form (const char *fmt,...)
 Formats a string using a printf style format descriptor.
 
Bool_t Gets (FILE *fp, Bool_t chop=kTRUE)
 Read one line from the stream, including the \n, or until EOF.
 
UInt_t Hash (ECaseCompare cmp=kExact) const
 Return hash value.
 
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.
 
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.
 
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.
 
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.
 
Ssiz_t Index (TPRegexp &pat, Ssiz_t i=0) const
 Find the first occurrence of the regexp in string and return the position.
 
TStringInsert (Ssiz_t pos, const char *s)
 
TStringInsert (Ssiz_t pos, const char *s, Ssiz_t extent)
 
TStringInsert (Ssiz_t pos, const TString &s)
 
TStringInsert (Ssiz_t pos, const TString &s, Ssiz_t extent)
 
Bool_t IsAlnum () const
 Returns true if all characters in string are alphanumeric.
 
Bool_t IsAlpha () const
 Returns true if all characters in string are alphabetic.
 
Bool_t IsAscii () const
 Returns true if all characters in string are ascii.
 
Bool_t IsBin () const
 Returns true if all characters in string are binary digits (0,1).
 
Bool_t IsDec () const
 Returns true if all characters in string are decimal digits (0-9).
 
Bool_t IsDigit () const
 Returns true if all characters in string are digits (0-9) or white spaces, i.e.
 
Bool_t IsFloat () const
 Returns kTRUE if string contains a floating point or integer number.
 
Bool_t IsHex () const
 Returns true if all characters in string are hexadecimal digits (0-9,a-f,A-F).
 
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.
 
Bool_t IsNull () const
 
Bool_t IsOct () const
 Returns true if all characters in string are octal digits (0-7).
 
Bool_t IsWhitespace () const
 
Ssiz_t Last (char c) const
 Find last occurrence of a character c.
 
Ssiz_t Length () const
 
Bool_t MaybeRegexp () const
 Returns true if string contains one of the regexp characters "^$.[]*+?".
 
Bool_t MaybeWildcard () const
 Returns true if string contains one of the wildcard characters "[]*?".
 
TString MD5 () const
 Return the MD5 digest for this string, in a string representation.
 
 operator const char * () const
 
TSubString operator() (const TRegexp &re) const
 Return the substring found by applying the regexp.
 
TSubString operator() (const TRegexp &re, Ssiz_t start) const
 Return the substring found by applying the regexp starting at start.
 
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.
 
TSubString operator() (TPRegexp &re) const
 Return the substring found by applying the regexp.
 
TSubString operator() (TPRegexp &re, Ssiz_t start) const
 Return the substring found by applying the regexp starting at start.
 
TStringoperator+= (char c)
 
TStringoperator+= (const char *s)
 
TStringoperator+= (const TString &s)
 
template<class T >
std::enable_if< ROOT::TypeTraits::IsFloatNumeral< T >::value, TString >::typeoperator+= (T f)
 
template<class T >
std::enable_if< ROOT::TypeTraits::IsSignedNumeral< T >::value, TString >::typeoperator+= (T i)
 
template<class T >
std::enable_if< ROOT::TypeTraits::IsUnsignedNumeral< T >::value, TString >::typeoperator+= (T u)
 
TStringoperator= (char s)
 Assign character c to TString.
 
TStringoperator= (const char *s)
 Assign string cs to TString.
 
TStringoperator= (const std::string &s)
 Assign std::string s to TString.
 
TStringoperator= (const std::string_view &s)
 Assign std::string s to TString.
 
TStringoperator= (const TString &s)
 Assignment operator.
 
TStringoperator= (const TSubString &s)
 Assign a TSubString substr to TString.
 
TStringoperator= (TString &&s) noexcept
 Move-Assignment operator.
 
char & operator[] (Ssiz_t i)
 
char operator[] (Ssiz_t i) const
 
TStringPrepend (char c, Ssiz_t rep=1)
 Prepend character c rep times to string.
 
TStringPrepend (const char *cs)
 
TStringPrepend (const char *cs, Ssiz_t n)
 
TStringPrepend (const TString &s)
 
TStringPrepend (const TString &s, Ssiz_t n)
 
void Puts (FILE *fp)
 Write string to the stream.
 
virtual void ReadBuffer (char *&buffer)
 Read string from I/O buffer.
 
std::istream & ReadFile (std::istream &str)
 Replace string with the contents of strm, stopping at an EOF.
 
std::istream & ReadLine (std::istream &str, Bool_t skipWhite=kTRUE)
 Read a line from stream upto newline skipping any whitespace.
 
std::istream & ReadString (std::istream &str)
 Read a line from stream upto \0, including any newline.
 
std::istream & ReadToDelim (std::istream &str, char delim='\n')
 Read up to an EOF, or a delimiting character, whichever comes first.
 
std::istream & ReadToken (std::istream &str)
 Read a token, delimited by whitespace, from the input stream.
 
TStringRemove (EStripType s, char c)
 Remove char c at begin and/or end of string (like Strip()) but modifies directly the string.
 
TStringRemove (Ssiz_t pos)
 
TStringRemove (Ssiz_t pos, Ssiz_t n)
 
TStringReplace (Ssiz_t pos, Ssiz_t n, const char *s)
 
TStringReplace (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.
 
TStringReplace (Ssiz_t pos, Ssiz_t n, const TString &s)
 
TStringReplace (Ssiz_t pos, Ssiz_t n1, const TString &s, Ssiz_t n2)
 
TStringReplaceAll (const char *s1, const char *s2)
 
TStringReplaceAll (const char *s1, const TString &s2)
 
TStringReplaceAll (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.
 
TStringReplaceAll (const TString &s1, const char *s2)
 
TStringReplaceAll (const TString &s1, const TString &s2)
 
TStringReplaceSpecialCppChars ()
 Find special characters which are typically used in printf() calls and replace them by appropriate escape sequences.
 
void Resize (Ssiz_t n)
 Resize the string. Truncate or add blanks as necessary.
 
virtual Int_t Sizeof () const
 Returns size string will occupy on I/O buffer.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
TSubString Strip (EStripType s=kTrailing, char c=' ') const
 Return a substring of self stripped at beginning and/or end.
 
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.
 
TStringSwap (TString &other)
 
TObjArrayTokenize (const TString &delim) const
 This function is used to isolate sequential tokens in a TString.
 
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'.
 
void ToLower ()
 Change string to lower-case.
 
void ToUpper ()
 Change string to upper case.
 
std::string_view View () const
 

Static Public Member Functions

static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- 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.
 
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static TString Format (const char *fmt,...)
 Static method which formats a string using a printf style format descriptor and return a TString.
 
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.
 
static Ssiz_t InitialCapacity (Ssiz_t ic=15)
 Set default initial capacity for all TStrings. Default is 15.
 
static TString Itoa (Int_t value, Int_t base)
 Converts an Int_t to a TString with respect to the base specified (2-36).
 
static TString LLtoa (Long64_t value, Int_t base)
 Converts a Long64_t to a TString with respect to the base specified (2-36).
 
static Ssiz_t MaxWaste (Ssiz_t mw=15)
 Set maximum space that may be wasted in a string before doing a resize.
 
static TStringReadString (TBuffer &b, const TClass *clReq)
 Read TString object from buffer.
 
static Ssiz_t ResizeIncrement (Ssiz_t ri=16)
 Set default resize increment for all TStrings. Default is 16.
 
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).
 
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).
 
static void WriteString (TBuffer &b, const TString *a)
 Write TString object to buffer.
 

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 }
 
using size_type = Ssiz_t
 
- Static Public Attributes inherited from TString
static constexpr 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.
 
void AssertElement (Ssiz_t nc) const
 Check to make sure a string index is in range.
 
Ssiz_t Clobber (Ssiz_t nc)
 Clear string and make sure it has a capacity of nc.
 
void InitChar (char c)
 Initialize a string with a single character.
 
- 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.
 
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 1054 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.

◆ Class()

static TClass * TStringToken::Class ( )
static
Returns
TClass describing this class

◆ Class_Name()

static const char * TStringToken::Class_Name ( )
static
Returns
Name of this class

◆ Class_Version()

static constexpr Version_t TStringToken::Class_Version ( )
inlinestaticconstexpr
Returns
Version of this class

Definition at line 158 of file TPRegexp.h.

◆ DeclFileName()

static const char * TStringToken::DeclFileName ( )
inlinestatic
Returns
Name of the file containing the class declaration

Definition at line 158 of file TPRegexp.h.

◆ IsA()

TClass * TStringToken::IsA ( ) const
inlineoverridevirtual
Returns
TClass describing current object

Reimplemented from TString.

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

◆ Streamer()

void TStringToken::Streamer ( TBuffer b)
overridevirtual

Stream a string object.

Reimplemented from TString.

◆ StreamerNVirtual()

void TStringToken::StreamerNVirtual ( TBuffer ClassDef_StreamerNVirtual_b)
inline

Definition at line 158 of file TPRegexp.h.

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.

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