tString Class Reference

string class: standard string with some extras More...

#include <tString.h>

Inheritance diagram for tString:

[legend]

List of all members.

Public Types
typedef tString	THISCLASS
	typedef for this class
typedef std::string	BASE
	typedef for base clase
typedef BASE::value_type	CHAR
	the character class
Public Member Functions
	tString ()
	default constructor
	tString (const BASE &)
	pseudo copy constructor
	tString (const tString &)
	copy constructor
	tString (const CHAR *)
	conversion from C string
template<typename T>
	tString (T begin, T end)
	initialisation by iterators
	WRAP_OPERATOR_ALLTYPES (+) WRAP_MUTATING_OPERATOR_ALLTYPES(+
	assignment from output collector
size_type	Size () const
	Returns the size of the string in characters.
template<class T>
bool	Convert (T &target, size_type startPos=0) const
	Converts the string to an arbitrary type, starting at the given position.
void	ReadLine (std::istream &s, bool enableEscapeSequences=false)
	read a whole line from a stream into this string
void	Clear ()
	clears the string
void	SetPos (int len, bool cut)
	makes this string exactly of length len.
bool	StartsWith (const tString &other) const
	determines whether this string starts with the argument string
bool	StartsWith (const CHAR *other) const
	determines whether this string starts with the argument string
bool	EndsWith (const tString &other) const
	determines whether this string ends with the argument string
bool	EndsWith (const CHAR *other) const
	determines whether this string ends with the argument string
tString	LTrim () const
	returns a copy with leading whitespace removed
tString	RTrim () const
	returns a copy with trailing whitespace removed
tString	Trim () const
	returns a copy with leading and trailing whitespace removed
int	StrPos (const tString &tofind) const
	Get the position of a substring within this string.
int	StrPos (int start, const tString &tofind) const
	Get the position of a substring within this string.
int	StrPos (const CHAR *tofind) const
	Get the position of a substring within this string.
int	StrPos (int start, const CHAR *tofind) const
	Get the position of a substring within this string.
tString	SubStr (int start, int len) const
	Get an arbitrary substring within this string.
tString	SubStr (int start) const
	Get a substring within this string from the end.
int	ToInt (size_type pos=0) const
	Returns the string converted to an integer.
REAL	ToFloat (size_type pos=0) const
	Returns the string converted to a float.
tString	StripWhitespace (void) const
	Strips all whitespace from a string.
tString	ToLower (void) const
	Converts the string to lowercase.
tString	ToUpper (void) const
	Converts the string to uppercase.
int	PosWordRight (int start) const
	Computes the position of the next delimiter relative to start.
int	PosWordLeft (int start) const
	Computes the position of the previous delimiter relative to start.
int	RemoveWordRight (int start)
	Remove word right according to the delimiters.
int	RemoveWordLeft (int start)
	Remove word left according to the delimiters.
void	RemoveSubStr (int start, int length)
	Remove a substring, in-place.
tString	GetFileMimeExtension () const
	Gets the lowercased file extension, as in a MIME type.
tString	Reverse () const
	Reverses strings.
tString	Truncate (int truncateAt) const
	Returns a truncated string (copy of this with excess chars replaced by "...").
CHAR	operator[] (size_t i) const
CHAR &	operator[] (size_t i)
CHAR	operator[] (int i) const
CHAR &	operator[] (int i)
void	SetSize (unsigned int size)
	sets the string length by cutting or appending spaces
CHAR	operator() (size_t i) const
CHAR &	operator() (size_t i)
CHAR	operator() (int i) const
CHAR &	operator() (int i)
int	Compare (const CHAR *other) const
	Compares two strings lexicographically.
int	Compare (const CHAR *other, bool ignoreCase) const
	Compares two strings lexicographically, ignoring case differences if second argument is true.
	operator const CHAR * () const
int	Count (CHAR what) const
	Counts the number of a certain character within the string.
int	LongestLine () const
	the length of the longest line
int	Len () const
	returns the lenghth PLUS ONE (the allocated length)
void	SetLen (int len)
	sets the allocated length
void	NetFilter ()
	filters strings from the net for strange things like newlines
Static Public Member Functions
static int	CompareAlphaNumerical (const tString &a, const tString &b)
	Compares two strings alphanumerically.

---

Detailed Description

string class: standard string with some extras

Definition at line 61 of file tString.h.

---

Member Typedef Documentation

typedef tString tString::THISCLASS

typedef for this class

Reimplemented in tColoredString.

Definition at line 64 of file tString.h.

typedef std::string tString::BASE

typedef for base clase

Reimplemented in tColoredString.

Definition at line 65 of file tString.h.

typedef BASE::value_type tString::CHAR

the character class

Definition at line 66 of file tString.h.

---

Constructor & Destructor Documentation

tString::tString

(

void

)

default constructor

Definition at line 302 of file tString.cpp.

Referenced by GetFileMimeExtension(), and SubStr().

{
}

Here is the caller graph for this function:

tString::tString

(

const BASE &

other

)

pseudo copy constructor

Parameters:

other

source of copy operation

Definition at line 316 of file tString.cpp.

        : string( other )
{
}

tString::tString

(

const tString &

other

)

copy constructor

Parameters:

other

source of copy operation

Definition at line 331 of file tString.cpp.

        : string( other )
{
}

tString::tString

(

const CHAR *

other

)

[explicit]

conversion from C string

Parameters:

other

source of copy operation

Definition at line 346 of file tString.cpp.

        : string( other ? other : "" )
{
    // tASSERT( other );
}

template<typename T>

tString::tString	(	T	begin,
		T	end
	)			[inline]

initialisation by iterators

Definition at line 73 of file tString.h.

---

Member Function Documentation

tString::WRAP_OPERATOR_ALLTYPES

(

+

)

assignment from output collector

tString::size_type tString::Size

(

void

)

const

Returns the size of the string in characters.

Returns:

the size of the string in characters NOT including the trailing 0.

Definition at line 395 of file tString.cpp.

Referenced by FilterLine(), ePlayerNetID::FilterName(), rTextField::FlushLine(), GetParent(), tLocaleItem::Load(), tConfItemBase::LoadAll(), nServerInfoBase::NetReadThis(), operator>>(), tConsole::Print(), RemoveTrailingColor(), se_StripMatchingEnds(), and ToT().

{
    return size();
}

Here is the caller graph for this function:

template<class T>

bool tString::Convert	(	T &	target,
		size_type	startPos = 0
	)			const [inline]

Converts the string to an arbitrary type, starting at the given position.

Parameters:

	target	the variable to write the conversion result to
	startPos	the position to start the conversion at

Returns:

true on success

Definition at line 276 of file tString.h.

Referenced by cWidget::WithDataFunctions::ProcessDataSource(), and ToT().

{
    // generate string stream and advance it to the start position
    std::istringstream s(*this);
    s.seekg(startPos);

    // read it
    s >> target;

    // return failure condition
    return !s.fail() && s.eof() || isspace(s.get());
}

Here is the caller graph for this function:

void tString::ReadLine	(	std::istream &	s,
		bool	enableEscapeSequences = false
	)

read a whole line from a stream into this string

Parameters:

	s	stream to read from
	enableEscapeSequences	set to true if escape sequences ( ) shall be respected

Definition at line 411 of file tString.cpp.

References c, Clear(), isblank(), and st_ReadEscapeSequence().

Referenced by tStatFile::flushWrites(), tTextFileRecorder::GetLine(), eVoter::HandleChat(), gAICharacter::Load(), tLocaleItem::Load(), nServerInfo::Load(), tConfItemBase::LoadAll(), tIniFile::LoadFile(), tConfItemBase::LoadLine(), tPlayList::LoadPlaylist(), nKrawall::nMethod::nMethod(), operator>>(), tStatFile::read(), tSettingRotation::ReadVal(), tConfItemLine::ReadVal(), nConfItemLine::ReadVal(), tConfItemPassword::ReadVal(), se_ChatMe(), se_ChatMsg(), se_ChatShuffle(), se_ChatTeam(), se_NeedsServer(), and st_Dummy().

{
    char c=' ';
    Clear();
    while(c!='\n' && c!='\r' && isblank(c) &&  s.good() && !s.eof()){
        c=s.get();
    }

    s.putback(c);
    c='x';

    while( true )
    {
        c=s.get();

        // notice end of line or file
        if ( c=='\n' || c=='\r' || !s.good() || s.eof())
            break;

        if ( enableEscapeSequences )
        {
            char c2 = '\0';
            if ( st_ReadEscapeSequence( c, c2, s ) )
            {
                *this += c;
                c = 'x';
                continue;
            }
            else if ( c2 )
            {
                *this += c;
                *this += c2;
                c = 'x';
                continue;
            }
        }

        *this += c;
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tString::Clear

(

void

)

clears the string

Definition at line 461 of file tString.cpp.

Referenced by nServerInfo::DeleteAll(), eMenuItemKick::eMenuItemKick(), ePlayer::ePlayer(), nServerInfo::GetFromLAN(), nServerInfo::GetFromLANContinuously(), nAddress::GetHostname(), tLocale::Load(), tLocaleItem::Load(), tLanguage::Load(), lowlevel_sr_InitDisplay(), nServerInfo::NetReadThis(), tOutput::operator const char *(), tLocaleItem::operator const char *(), operator>>(), PasswordCallback(), ReadLine(), SetPos(), ePlayerNetID::UpdateName(), and rTextField::WriteChar().

{
#ifdef _MSC_VER
    *this = "";
#else
    string::clear();
#endif
}

Here is the caller graph for this function:

void tString::SetPos	(	int	l,
		bool	cut
	)

makes this string exactly of length len.

Parameters:

	len	the target length
	cut	if set, the string may be cut back if its current length is bigger than length

Reimplemented in tColoredString.

Definition at line 481 of file tString.cpp.

References Clear(), Len(), and SetSize().

Referenced by tConfItemBase::DocAll(), tStatFile::flushWrites(), tConfItemBase::LoadLine(), nServerInfo::NetReadThis(), eTeam::Ranking(), ePlayerNetID::Ranking(), and tColoredString::SetPos().

                                   {
    int i;
    if ( l < Len() )
    {
        if ( cut )
        {
            if ( l > 0 )
            {
                SetSize( l-1 );
                operator+=(' ');
            }
            else
            {
                Clear();
            }
        }
        else
        {
            operator+=(' ');
        }
    }
    for(i=Len();i<l;i++)
        operator+=(' ');
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool tString::StartsWith

(

const tString &

other

)

const

determines whether this string starts with the argument string

Parameters:

other

the string to compare the start with

Returns:

true if this starts with other

Definition at line 522 of file tString.cpp.

References Len().

Referenced by EndsWith(), ExtractConnectionInformation(), tConfItemBase::LoadAll(), tIniFile::LoadFile(), tPlayList::LoadPlaylist(), s_Veto(), tXmlParserNamespace::sg_IgnoreRequest(), and st_RelocatePath().

{
    // const tString & rmhxt = *this;
    // rmhxt.RemoveHex();
    // *this = rmhxt;
    // other.RemoveHex();
    if (other.Len() > Len()) {
        return false;
    }
    for (int i=0; i<other.Len()-1; i++) {
        if (other[i] != (*this)[i]) {
            return false;
        }
    }

    return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool tString::StartsWith

(

const CHAR *

other

)

const

determines whether this string starts with the argument string

bool tString::EndsWith

(

const tString &

other

)

const

determines whether this string ends with the argument string

Parameters:

other

the string to compare the end with

Returns:

true if this ends with other

Definition at line 571 of file tString.cpp.

References Len(), Reverse(), and StartsWith().

Referenced by tXmlParserNamespace::sg_IgnoreRequest().

{
    if (other.Len() > Len()) {
        return false;
    }
    tString thisString = Reverse();
    tString otherString(other);
    otherString = otherString.Reverse();

    // Haha, just use StartsWith to do the comparison :)
    return thisString.StartsWith(otherString);
    //return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

bool tString::EndsWith

(

const CHAR *

other

)

const

determines whether this string ends with the argument string

tString tString::LTrim

(

void

)

const

returns a copy with leading whitespace removed

Returns:

the trimmed string

Definition at line 606 of file tString.cpp.

References isblank().

Referenced by RTrim(), and Trim().

{
    tString toReturn;
    bool trim = true;

    for( size_t i = 0; i<size(); i++ )
    {
        if( !isblank((*this)[i]) )
            trim = false;
        if( !trim)
            toReturn << (*this)[i];
    }
    return toReturn;
}

Here is the call graph for this function:

Here is the caller graph for this function:

tString tString::RTrim

(

void

)

const

returns a copy with trailing whitespace removed

Returns:

the trimmed string

Definition at line 631 of file tString.cpp.

References LTrim(), and Reverse().

Referenced by Trim().

{
    tString toReturn;
    toReturn = Reverse();

    toReturn = toReturn.LTrim();
    return toReturn.Reverse();
}

Here is the call graph for this function:

Here is the caller graph for this function:

tString tString::Trim

(

void

)

const

returns a copy with leading and trailing whitespace removed

Returns:

the trimmed string

Definition at line 650 of file tString.cpp.

References LTrim(), and RTrim().

Referenced by tIniFile::LoadFile(), and tPlayList::LoadPlaylist().

{
    return LTrim().RTrim();
}

Here is the call graph for this function:

Here is the caller graph for this function:

int tString::StrPos

(

const tString &

tofind

)

const

Get the position of a substring within this string.

Parameters:

tofind

the string to find

Returns:

position of the start of the string or negative if not found

Definition at line 666 of file tString.cpp.

References Len().

Referenced by nAddress::FromString(), tIniFile::LoadFile(), tSettingRotation::ReadVal(), StrPos(), tIsInList(), and gServerMenu::Update().

{
    if (tofind.Len() > Len()) {
        return -1;
    }
    for (int i=0; i<Len()-1; i++) {
        if ((*this)(i) == tofind(0)) {
            bool found = true;
            for (int j=0; j<tofind.Len()-1; j++) {
                if ((*this)(i+j) != tofind(j))
                    found = false;
            }
            if (found == true)
                return i;
        }
    }

    return -1;
}

Here is the call graph for this function:

Here is the caller graph for this function:

int tString::StrPos	(	int	start,
		const tString &	tofind
	)			const

Get the position of a substring within this string.

Definition at line 686 of file tString.cpp.

References Len().

{
    if (tofind.Len() > Len()) {
        return -1;
    }
    for (int i = start; i<Len()-1; i++) {
        if ((*this)(i) == tofind(0)) {
            bool found = true;
            for (int j=0; j<tofind.Len()-1; j++) {
                if ((*this)(i+j) != tofind(j))
                    found = false;
            }
            if (found == true)
                return i;
        }
    }

    return -1;
}

Here is the call graph for this function:

int tString::StrPos

(

const CHAR *

tofind

)

const

Get the position of a substring within this string.

Parameters:

tofind

the string to find

Returns:

position of the start of the string or negative if not found

Definition at line 717 of file tString.cpp.

References StrPos().

{
    return StrPos( tString ( tofind ) );
}

Here is the call graph for this function:

int tString::StrPos	(	int	start,
		const CHAR *	tofind
	)			const

Get the position of a substring within this string.

Definition at line 722 of file tString.cpp.

References StrPos().

{
    return StrPos( start, tString ( tofind ) );
}

Here is the call graph for this function:

tString tString::SubStr	(	int	start,
		int	len
	)			const

Get an arbitrary substring within this string.

Parameters:

	start	start of string to extract
	len	length of string to extract

Returns:

the substring

Definition at line 739 of file tString.cpp.

References Len(), tASSERT, and tString().

Referenced by uMenuItemString::Event(), ExtractConnectionInformation(), FilterLine(), rTextField::FlushLine(), nAddress::FromString(), GeneratePrefix(), eSoundMixer::GetCurrentSong(), GetFileMimeExtension(), tConfItemBase::LoadAll(), tIniFile::LoadFile(), vValue::Registry::Registration::match(), uMenu::Message(), nServerInfoBase::NetReadThis(), PosWordRight(), tSettingRotation::ReadVal(), RemoveSubStr(), reparseforbiddencallbacks(), se_DisplayChatLocallyClient(), se_StripMatchingEnds(), SetLen(), SetSize(), st_RelocatePath(), SubStr(), tIsInList(), Truncate(), and ePlayerNetID::UpdateName().

{
    tASSERT( start >= 0 );

    if (start > Len())
        return tString("");

    //if len < 0 or too long, take the whole string
    if ( (len + start) >= Len() ||  len < 0)
        len = Len() - start - 1;

    tString toReturn("");

    for (int i=start; i<(len + start); i++) {
        toReturn << (*this)(i);
    }
    return  toReturn;
}

Here is the call graph for this function:

Here is the caller graph for this function:

tString tString::SubStr

(

int

start

)

const

Get a substring within this string from the end.

Parameters:

start

start of string to extract

Returns:

the substring from start to the end of this string

Definition at line 769 of file tString.cpp.

References Len(), and SubStr().

{
    return SubStr (start, Len()-start-1 );
}

Here is the call graph for this function:

int tString::ToInt

(

size_type

pos = 0

)

const

Returns the string converted to an integer.

Parameters:

pos

position to start looking at for a number

Returns:

the number

Definition at line 807 of file tString.cpp.

References ToT().

Referenced by gCommandLineJumpStartAnalyzer::Connect(), AAURLHandler::connectToServer:, nAddress::FromString(), and se_ChatShuffle().

{
    int ret = 0;
    ToT( *this, ret, pos, "integer" );
    return ret;
}

Here is the call graph for this function:

Here is the caller graph for this function:

REAL tString::ToFloat

(

size_type

pos = 0

)

const

Returns the string converted to a float.

Parameters:

pos

position to start looking at for a number

Returns:

the number

Definition at line 825 of file tString.cpp.

References REAL, and ToT().

{
    REAL ret = 0;
    ToT( *this, ret, pos, "float" );
    return ret;
}

Here is the call graph for this function:

int tString::CompareAlphaNumerical	(	const tString &	a,
		const tString &	b
	)			[static]

Compares two strings alphanumerically.

Parameters:

	a	first string to compare
	b	second string to compare

Returns:

-1 if b is bigger than a, +1 if a is bigger than b, 0 if they are equal

Definition at line 866 of file tString.cpp.

References GetInt(), and Len().

{
    int apos = 0;
    int bpos = 0;

    while ( apos < a.Len() && bpos < b.Len() )
    {
        int adigit = GetInt( a,apos );
        int bdigit = GetInt( b,bpos );
        if ( adigit < bdigit )
            return 1;
        else if ( adigit > bdigit )
            return -1;
    }

    if ( a.Len() - apos < b.Len() - bpos )
        return 1;
    else if ( a.Len() - apos > b.Len() - bpos )
        return 1;
    else
        return 0;
}

Here is the call graph for this function:

tString tString::StripWhitespace

(

void

)

const

Strips all whitespace from a string.

Returns:

a string with all whitespace removed. "hi everyone " -> "hieveryone"

Definition at line 899 of file tString.cpp.

References isblank(), and Len().

Referenced by tIniFile::LoadFile().

{
    tString toReturn;

    for( int i = 0; i<=Len()-2; i++ )
    {
        if( !isblank((*this)(i)) )
            toReturn << (*this)(i);
    }
    return toReturn;
}

Here is the call graph for this function:

Here is the caller graph for this function:

tString tString::ToLower

(

void

)

const

Converts the string to lowercase.

Returns:

a string where all characters are converted to lowercase. "Hello World!" -> "hello world!"

Definition at line 912 of file tString.cpp.

Referenced by tConfItemBase::GetCommands(), and cWidget::WithDataFunctions::ProcessDataSource().

                                   {
    tString ret(*this);
    for(iterator iter=ret.begin(); iter!=ret.end(); ++iter) {
        *iter = tolower(*iter);
    }
    return ret;
}

Here is the caller graph for this function:

tString tString::ToUpper

(

void

)

const

Converts the string to uppercase.

Returns:

a string where all characters are converted to uppercase. "Hello World!" -> "HELLO WORLD!"

Definition at line 921 of file tString.cpp.

Referenced by tConfItemBase::FindConfigItem().

                                   {
    tString ret(*this);
    for(iterator iter=ret.begin(); iter!=ret.end(); ++iter) {
        *iter = toupper(*iter);
    }
    return ret;
}

Here is the caller graph for this function:

int tString::PosWordRight

(

int

start

)

const

Computes the position of the next delimiter relative to start.

Parameters:

start

The location of right to search

Returns:

Position relative from start to the delimiter to the right.

Definition at line 955 of file tString.cpp.

References delimiters, Len(), and SubStr().

Referenced by uMenuItemString::Event(), PosWordLeft(), and RemoveWordRight().

                                           {
    int nextDelimiter = strcspn( SubStr( start, Len() ), delimiters );
    int toMove = nextDelimiter;

    // A delimter in our immediate path
    if ( toMove == 0 ) {
        // Move over delimiters
        while ( nextDelimiter == 0 && start + 1 < Len() ) {
            toMove++;
            start++;
            nextDelimiter = strcspn( SubStr( start, Len() ), delimiters );
        }
        // Skip over the word if not multiple delimiters
        if ( toMove == 1 ) {
            toMove += nextDelimiter;
        }
    }

    return toMove;
}

Here is the call graph for this function:

Here is the caller graph for this function:

int tString::PosWordLeft

(

int

start

)

const

Computes the position of the previous delimiter relative to start.

Parameters:

start

The location of left to search

Returns:

Position relative from start to the delimiter to the left.

Definition at line 987 of file tString.cpp.

References Len(), PosWordRight(), and Reverse().

Referenced by uMenuItemString::Event(), and RemoveWordLeft().

                                          {
    return -1 * Reverse().PosWordRight( Len() - start - 1 );
}

Here is the call graph for this function:

Here is the caller graph for this function:

int tString::RemoveWordRight

(

int

start

)

Remove word right according to the delimiters.

Parameters:

start

The location to start removing from

Returns:

Number of characters removed and to which direction x > 0 right x < 0 left

Definition at line 1004 of file tString.cpp.

References PosWordRight(), and RemoveSubStr().

Referenced by uMenuItemString::Event().

                                        {
    int removed = PosWordRight( start );
    RemoveSubStr( start, removed );
    return removed;
}

Here is the call graph for this function:

Here is the caller graph for this function:

int tString::RemoveWordLeft

(

int

start

)

Remove word left according to the delimiters.

Parameters:

start

The location to start removing from

Returns:

Number of characters removed and to which direction x > 0 right x < 0 left

Definition at line 1023 of file tString.cpp.

References PosWordLeft(), and RemoveSubStr().

Referenced by uMenuItemString::Event().

                                       {
    int removed = PosWordLeft( start );
    RemoveSubStr( start, removed );
    return removed;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tString::RemoveSubStr	(	int	start,
		int	length
	)

Remove a substring, in-place.

Parameters:

	start	The position in the string
	length	How many characters to delete and the direction. x > 0 deletes right x < 0 deletes left

Definition at line 1042 of file tString.cpp.

References abs(), Len(), and SubStr().

Referenced by uMenuItemString::Event(), ExtractConnectionInformation(), RemoveWordLeft(), and RemoveWordRight().

                                                  {
    int strLen = Len()-1;
    if ( length < 0 ) {
        start += length;
        length = abs( length );
    }

    if ( start + length > strLen || start < 0 || length == 0 ) {
        return;
    }

    if ( start == 0 ) {
        if ( strLen - length == 0 ) {
            *this = ("");
        }
        else {
            *this = SubStr( start + length, strLen );
        }
    }
    else {
        *this = SubStr( 0, start ) + SubStr( start + length, strLen );
    }

    // SetSze(strLen+1-length);
}

Here is the call graph for this function:

Here is the caller graph for this function:

tString tString::GetFileMimeExtension

(

)

const

Gets the lowercased file extension, as in a MIME type.

Parameters:

none

Returns:

The extension of the filename represented by this string

Definition at line 1080 of file tString.cpp.

References Len(), Reverse(), SubStr(), and tString().

Referenced by eMusicTrack::LoadSong().

                                            {
    tString extension;
    int currentPosition = Len();

    bool goonie = true;

    if( currentPosition < 2 ) return tString("");

    while(goonie) {
        extension += SubStr(currentPosition,1);
        if( SubStr(currentPosition,1) == "." ) goonie = false;
        currentPosition--;
    }

    extension = extension.Reverse();
    if( extension == (*this) ) return tString("");

    for(size_t i=0; i<extension.size(); i++)
        extension[i] = tolower(extension[i]);
    return extension;
}

Here is the call graph for this function:

Here is the caller graph for this function:

tString tString::Reverse

(

)

const

Reverses strings.

Returns:

A copy of the string reversed

Definition at line 1112 of file tString.cpp.

References Len().

Referenced by EndsWith(), GetFileMimeExtension(), PosWordLeft(), and RTrim().

                               {
    tString reversed;
    for ( int index = Len() - 2; index >= 0; index-- ) {
        reversed << ( *this ) ( index );
    }

    return reversed;
}

Here is the call graph for this function:

Here is the caller graph for this function:

tString tString::Truncate

(

int

truncateAt

)

const

Returns a truncated string (copy of this with excess chars replaced by "...").

Parameters:

truncateAt

The postion to truncate at

Returns:

A new string with the truncated text and "..." concatenated

Example: tString("word").Truncate( 2 ) -> "wo..."

Definition at line 1134 of file tString.cpp.

References Len(), and SubStr().

{
    // The string does not need to be truncated
    if ( truncateAt >= Len() )
        return *this;

    return SubStr( 0, truncateAt ) + "...";
}

Here is the call graph for this function:

tString::CHAR tString::operator[]

(

size_t

i

)

const

Parameters:

i

position to look up

Returns:

character at given position

Definition at line 1154 of file tString.cpp.

References tASSERT.

Referenced by operator[]().

{
    tASSERT( i <= size() );
    return BASE::operator[]( i );
}

Here is the caller graph for this function:

tString::CHAR & tString::operator[]

(

size_t

i

)

Parameters:

i

position to look up

Returns:

character at given position

Definition at line 1171 of file tString.cpp.

References tERR_MESSAGE.

{
    while( i >= size() )
    {
        *this += ' ';
#ifdef DEBUG
        static bool warn = true;
        if( warn )
        {
            warn = false;
            tERR_MESSAGE("Auto-expanding string, this functionality will go away.");
        }
#endif
    }

    return BASE::operator[](i);
}

tString::CHAR tString::operator[]

(

int

i

)

const

Parameters:

i

position to look up

Returns:

character at given position

Definition at line 1200 of file tString.cpp.

References operator[]().

{
    return operator[]( size_t(i) );
}

Here is the call graph for this function:

tString::CHAR & tString::operator[]

(

int

i

)

Parameters:

i

position to look up

Returns:

character at given position

Definition at line 1216 of file tString.cpp.

References operator[]().

{
    return operator[]( size_t(i) );
}

Here is the call graph for this function:

void tString::SetSize

(

unsigned int

len

)

sets the string length by cutting or appending spaces

Parameters:

len

the desired length

Definition at line 1388 of file tString.cpp.

References SubStr(), and tASSERT.

Referenced by RemoveTrailingColor(), and SetPos().

{
    tASSERT(len < 268435456);

    while ( len > size() )
        *this += ' ';
    if ( len < size() )
        *this = SubStr( 0, len );

    tASSERT( size() == len );
}

Here is the call graph for this function:

Here is the caller graph for this function:

tString::CHAR tString::operator()

(

size_t

i

)

const

Parameters:

i

position to look up

Returns:

character at given position

Definition at line 1232 of file tString.cpp.

References tASSERT.

Referenced by operator()().

{
    tASSERT( i <= size() );
    return BASE::operator[]( i );
}

Here is the caller graph for this function:

tString::CHAR & tString::operator()

(

size_t

i

)

Parameters:

i

position to look up

Returns:

character at given position

Definition at line 1249 of file tString.cpp.

References tASSERT.

{
    tASSERT( i < size() );
    return BASE::operator[]( i );
}

tString::CHAR tString::operator()

(

int

i

)

const

Parameters:

i

position to look up

Returns:

character at given position

Definition at line 1266 of file tString.cpp.

References operator()().

{
    return operator()( size_t(i) );
}

Here is the call graph for this function:

tString::CHAR & tString::operator()

(

int

i

)

Parameters:

i

position to look up

Returns:

character at given position

Definition at line 1282 of file tString.cpp.

References operator()().

{
    return operator()( size_t(i) );
}

Here is the call graph for this function:

int tString::Compare

(

const CHAR *

other

)

const

Compares two strings lexicographically.

Referenced by vValue::Registry::Registration::match().

Here is the caller graph for this function:

int tString::Compare	(	const CHAR *	other,
		bool	ignoreCase
	)			const

Compares two strings lexicographically, ignoring case differences if second argument is true.

tString::operator const tString::CHAR *

(

void

)

const

Returns:

the C string version of this string

Definition at line 1338 of file tString.cpp.

{
    return c_str();
}

int tString::Count

(

CHAR

what

)

const

Counts the number of a certain character within the string.

Parameters:

what

the character that is searched for

Returns:

the number of matching characters in the string, 0 if none

Definition at line 931 of file tString.cpp.

Referenced by rConsole::Render().

                                  {
    int ret = 0;
    for(const_iterator iter=begin(); iter!=end(); ++iter) {
        if (*iter == what)
            ret++;
    }
    return ret;
}

Here is the caller graph for this function:

int tString::LongestLine

(

void

)

const

the length of the longest line

Returns:

the length of the longest line

Reimplemented in tColoredString.

Definition at line 1359 of file tString.cpp.

References pos.

                                     {
    unsigned longest = 0;
    unsigned pos = 0;
    int l;
    while ((l=find_first_of('\n', pos)) != -1) {
        if(l-pos > longest)
            longest = l-pos;
        pos = l+1;
    }
    if(size() - pos > longest)
        longest = size() - pos;
    return longest;
}

int tString::Len

(

void

)

const

returns the lenghth PLUS ONE (the allocated length)

Returns:

the length including the trailing \0

Definition at line 1353 of file tString.cpp.

Referenced by tCommandLineData::Analyse(), nKrawall::BrokenScramblePassword(), CompareAlphaNumerical(), ConnectToServerCore(), EndsWith(), ePlayer::ePlayer(), uMenuItemString::Event(), ExtractConnectionInformation(), tStatFile::flushWrites(), GeneratePrefix(), tPathResource::GetDirPath(), GetFileMimeExtension(), tDirectories::GetFiles(), GetInt(), nQueryMessageStats::GetIP(), GetMyHostName(), nServerInfo::GetSmallServerInfo(), IsLegalPlayerName(), tLanguage::Load(), eWavData::Load(), tConfItemBase::LoadAll(), tIniFile::LoadFile(), tPlayList::LoadPlaylist(), uMenu::Message(), eVoter::Name(), NetFilter(), nServerInfo::NetReadThis(), nServerInfoBase::NetReadThis(), tResourceManager::openResource(), tLocaleItem::operator const char *(), operator<<(), PasswordCallback(), tPathResource::Paths(), tPathScreenshot::Paths(), tPathVar::Paths(), tPathData::Paths(), tPathConfig::Paths(), PosWordLeft(), PosWordRight(), RemoveSubStr(), gServerMenuItem::RenderBackground(), ReplacePath(), Reverse(), nServerInfo::Save(), se_AppendChat(), se_ChatShuffle(), se_EscapeName(), se_IsNameTaken(), se_ListPlayers(), se_OptionalNameFilters(), se_RequestLogin(), se_StripMatchingEnds(), se_VoteKickUser(), SetLen(), SetPos(), sg_NetworkError(), tXmlParserNamespace::st_ErrorFunc(), st_RelocatePath(), StartsWith(), StripWhitespace(), StrPos(), SubStr(), tIsInList(), Truncate(), tStringLessThan(), tToLower(), tToUpper(), uMenuItemString::uMenuItemString(), gServerMenu::Update(), eTeam::UpdateAppearance(), ePlayerNetID::UpdateName(), tConfItemLine::WriteVal(), and uMenuItemStringWithHistory::~uMenuItemStringWithHistory().

{
    return size() + 1;
}

void tString::SetLen

(

int

len

)

sets the allocated length

Legacy function, don't use.

Parameters:

len

the desired length (including the trailing )

Definition at line 1411 of file tString.cpp.

References Len(), st_Breakpoint(), SubStr(), and tASSERT.

Referenced by se_AppendChat().

{
    // legacy function, don't use
    st_Breakpoint();

    while ( len > Len() )
        *this += ' ';
    if ( len < Len() )
        *this = SubStr( 0, len );

    tASSERT( Len() == len );
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tString::NetFilter

(

void

)

filters strings from the net for strange things like newlines

Definition at line 1646 of file tString.cpp.

References tCharacterFilter::Filter(), filter(), and Len().

Referenced by nServerInfo::DoGetFrom(), nAuthentication::HandlePasswordRequest(), ePlayerNetID::SetName(), and sn_ReadFiltered().

{
    static tCharacterFilter filter;

    // run through string
    for( int i = Len()-2; i>=0; --i )
    {
        // character to filter
        char & my = (*this)(i);

        my = filter.Filter(my);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• src/tools/tString.h
• src/tools/tString.cpp

---