TStringLong Class Reference

ATTENTION: this class is obsolete.

It's functionality has been taken over by TString.

The long string class (unlimited number of chars in I/O).

This class redefines only the I/O member functions of TString. It uses 4 bytes to store the string length (1 byte only for TString).

Definition at line 30 of file TStringLong.h.

Public Member Functions
	TStringLong ()
	constructor
	TStringLong (char c)
	constructor from a char
	TStringLong (char c, Ssiz_t s)
	constructor from a char
	TStringLong (const char *s)
	copy constructor
	TStringLong (const char *s, Ssiz_t n)
	constructor from a char*
	TStringLong (const TString &s)
	copy constructor
	TStringLong (const TSubString &sub)
	constructor from a substring
	TStringLong (Ssiz_t ic)
	constructor
virtual	~TStringLong ()
	destructor
void	FillBuffer (char *&buffer) const override
	Fill buffer.
TClass *	IsA () const override
void	ReadBuffer (char *&buffer) override
	Read this string from the buffer.
Int_t	Sizeof () const override
	Return the sizeof the string.
void	Streamer (TBuffer &) override
	Stream a long (>255 characters) 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.
TString &	Append (char c, Ssiz_t rep=1)
	Append character c rep times to string.
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.
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.
TString &	Chop ()
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
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.
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.
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.
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.
TString &	operator= (const char *s)
	Assign string cs to TString.
TString &	operator= (const std::string &s)
	Assign std::string s to TString.
TString &	operator= (const std::string_view &s)
	Assign std::string s to TString.
TString &	operator= (const TString &s)
	Assignment operator.
TString &	operator= (const TSubString &s)
	Assign a TSubString substr to TString.
TString &	operator= (TString &&s) noexcept
	Move-Assignment operator.
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.
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.
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.
TString &	Remove (EStripType s, char c)
	Remove char c at begin and/or end of string (like Strip()) but modifies directly the string.
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.
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.
TString &	ReplaceAll (const TString &s1, const char *s2)
TString &	ReplaceAll (const TString &s1, const TString &s2)
TString &	ReplaceSpecialCppChars ()
	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.
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.
TString &	Swap (TString &other)
TObjArray *	Tokenize (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 TClass *	Class ()
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 TClass *	Class ()
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 TString *	ReadString (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.

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

#include <TStringLong.h>

Inheritance diagram for TStringLong:

Constructor & Destructor Documentation

TStringLong() [1/8]

TStringLong::TStringLong

(

)

constructor

Definition at line 33 of file TStringLong.cxx.

TStringLong() [2/8]

TStringLong::TStringLong

(

Ssiz_t

ic

)

constructor

Definition at line 40 of file TStringLong.cxx.

TStringLong() [3/8]

TStringLong::TStringLong

(

const TString &

s

)

copy constructor

Definition at line 47 of file TStringLong.cxx.

TStringLong() [4/8]

TStringLong::TStringLong

(

const char *

s

)

copy constructor

Definition at line 54 of file TStringLong.cxx.

TStringLong() [5/8]

TStringLong::TStringLong	(	const char *	s,
		Ssiz_t	n
	)

constructor from a char*

Definition at line 61 of file TStringLong.cxx.

TStringLong() [6/8]

TStringLong::TStringLong

(

char

c

)

constructor from a char

Definition at line 68 of file TStringLong.cxx.

TStringLong() [7/8]

TStringLong::TStringLong	(	char	c,
		Ssiz_t	s
	)

constructor from a char

Definition at line 75 of file TStringLong.cxx.

TStringLong() [8/8]

TStringLong::TStringLong

(

const TSubString &

sub

)

constructor from a substring

Definition at line 82 of file TStringLong.cxx.

~TStringLong()

TStringLong::~TStringLong ( )

virtual

destructor

Definition at line 89 of file TStringLong.cxx.

Member Function Documentation

Class()

static TClass * TStringLong::Class ( )

static

Returns

TClass describing this class

Class_Name()

static const char * TStringLong::Class_Name ( )

static

Returns

Name of this class

Class_Version()

static constexpr Version_t TStringLong::Class_Version ( )

inlinestaticconstexpr

Returns

Version of this class

Definition at line 51 of file TStringLong.h.

DeclFileName()

static const char * TStringLong::DeclFileName ( )

inlinestatic

Returns

Name of the file containing the class declaration

Definition at line 51 of file TStringLong.h.

FillBuffer()

void TStringLong::FillBuffer ( char *&  buffer ) const

overridevirtual

Fill buffer.

Reimplemented from TString.

Definition at line 96 of file TStringLong.cxx.

IsA()

TClass * TStringLong::IsA ( ) const

inlineoverridevirtual

Returns

TClass describing current object

Reimplemented from TString.

Definition at line 51 of file TStringLong.h.

ReadBuffer()

void TStringLong::ReadBuffer ( char *&  buffer )

overridevirtual

Read this string from the buffer.

Reimplemented from TString.

Definition at line 108 of file TStringLong.cxx.

Sizeof()

Int_t TStringLong::Sizeof ( ) const

overridevirtual

Return the sizeof the string.

Reimplemented from TString.

Definition at line 124 of file TStringLong.cxx.

Streamer()

void TStringLong::Streamer ( TBuffer &  b )

overridevirtual

Stream a long (>255 characters) string object.

Reimplemented from TString.

Definition at line 132 of file TStringLong.cxx.

StreamerNVirtual()

void TStringLong::StreamerNVirtual ( TBuffer &  ClassDef_StreamerNVirtual_b )

inline

Definition at line 51 of file TStringLong.h.

Libraries for TStringLong:

---

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

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