Logo ROOT  
Reference Guide
TGString Class Reference

TGString wraps a TString and adds some graphics routines like drawing, size of string on screen depending on font, etc.

Definition at line 20 of file TGString.h.

Public Member Functions

 TGString ()
 
 TGString (const char *s)
 
 TGString (const TGString *s)
 constructor More...
 
 TGString (Int_t number)
 
virtual ~TGString ()
 
virtual void Draw (Drawable_t id, GContext_t gc, Int_t x, Int_t y)
 Draw string. More...
 
virtual void DrawWrapped (Drawable_t id, GContext_t gc, Int_t x, Int_t y, UInt_t w, FontStruct_t font)
 Draw a string in a column with width w. More...
 
Int_t GetLength () const
 
virtual Int_t GetLines (FontStruct_t font, UInt_t w)
 Get number of lines of width w the string would take using a certain font. More...
 
const char * GetString () const
 
virtual void SetString (const char *s)
 
- 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...
 
TStringAppend (char c, Ssiz_t rep=1)
 Append character c rep times to string. More...
 
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. 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...
 
TStringChop ()
 
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...
 
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. 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...
 
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. More...
 
TStringoperator= (const char *s)
 Assign string cs to TString. More...
 
TStringoperator= (const std::string &s)
 Assign std::string s to TString. More...
 
TStringoperator= (const std::string_view &s)
 Assign std::string s to TString. More...
 
TStringoperator= (const TString &s)
 Assignment operator. More...
 
TStringoperator= (const TSubString &s)
 Assign a TSubString substr to TString. More...
 
TStringoperator= (TString &&s) noexcept
 Move-Assignment operator. More...
 
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. More...
 
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. 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...
 
TStringRemove (EStripType s, char c)
 Remove char c at begin and/or end of string (like Strip()) but modifies directly the string. More...
 
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. More...
 
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. More...
 
TStringReplaceAll (const TString &s1, const char *s2)
 
TStringReplaceAll (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...
 
TStringSwap (TString &other)
 
TObjArrayTokenize (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
 

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 TStringReadString (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)
 
- Protected Attributes inherited from TString
Rep_t fRep
 

#include <TGString.h>

Inheritance diagram for TGString:
[legend]

Constructor & Destructor Documentation

◆ TGString() [1/4]

TGString::TGString ( )
inline

Definition at line 23 of file TGString.h.

◆ TGString() [2/4]

TGString::TGString ( const char *  s)
inline

Definition at line 24 of file TGString.h.

◆ TGString() [3/4]

TGString::TGString ( Int_t  number)
inline

Definition at line 25 of file TGString.h.

◆ TGString() [4/4]

TGString::TGString ( const TGString s)

constructor

Definition at line 49 of file TGString.cxx.

◆ ~TGString()

virtual TGString::~TGString ( )
inlinevirtual

Definition at line 27 of file TGString.h.

Member Function Documentation

◆ Draw()

void TGString::Draw ( Drawable_t  id,
GContext_t  gc,
Int_t  x,
Int_t  y 
)
virtual

Draw string.

Reimplemented in TGHotString.

Definition at line 56 of file TGString.cxx.

◆ DrawWrapped()

void TGString::DrawWrapped ( Drawable_t  id,
GContext_t  gc,
Int_t  x,
Int_t  y,
UInt_t  w,
FontStruct_t  font 
)
virtual

Draw a string in a column with width w.

If string is longer than w wrap it to next line.

Reimplemented in TGHotString.

Definition at line 65 of file TGString.cxx.

◆ GetLength()

Int_t TGString::GetLength ( ) const
inline

Definition at line 29 of file TGString.h.

◆ GetLines()

Int_t TGString::GetLines ( FontStruct_t  font,
UInt_t  w 
)
virtual

Get number of lines of width w the string would take using a certain font.

Definition at line 107 of file TGString.cxx.

◆ GetString()

const char* TGString::GetString ( ) const
inline

Definition at line 30 of file TGString.h.

◆ SetString()

virtual void TGString::SetString ( const char *  s)
inlinevirtual

Definition at line 31 of file TGString.h.

Libraries for TGString:
[legend]

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