src/tools/tString.cpp File Reference

#include "tMemManager.h"
#include "tString.h"
#include "tLocale.h"
#include "tConfiguration.h"
#include "tException.h"
#include <ctype.h>
#include <string>
#include <iostream>

Include dependency graph for tString.cpp:

Go to the source code of this file.

Classes
class	tCharacterFilter
Functions
static bool	st_ReadEscapeSequence (char &c, char &c2, std::istream &s)
static bool	st_ReadEscapeSequence (char &c, std::istream &s)
std::istream &	operator>> (std::istream &s, tString &x)
	stream reading operator honoring escape sequences and quoting
template<class T>
void	ToT (tString const &source, T &target, tString::size_type pos, char const *name)
static int	GetInt (const tString &s, int &pos)
static int	RemoveTrailingColor (tString &s, int maxLen=-1)
static int	RTC (REAL x)
static char	int_to_hex (int i)
tColoredString &	operator<< (tColoredString &s, const tColoredStringProxy &colorCode)
	string building streaming operator
std::stringstream &	operator<< (std::stringstream &s, const tString &t)
bool	tIsInList (tString const &list_, tString const &item)
	check whether item is in a comma or whitespace separated list
void	tToLower (tString &toTransform)
	converts a string to lowercase
void	tToUpper (tString &toTransform)
	converts a string to uppercase
Variables
static tString	delimiters ("!?.:;_()-, ")
static tConfItemLine	st_wordDelimiters ("WORD_DELIMITERS", delimiters)
bool	st_colorStrings = true
static tConfItem< bool >	cs ("COLOR_STRINGS", st_colorStrings)
static char	hex_array [] = "0123456789abcdef"

---

Function Documentation

static int GetInt	(	const tString &	s,
		int &	pos
	)			[static]

Definition at line 833 of file tString.cpp.

References tString::Len().

Referenced by tString::CompareAlphaNumerical().

{
    int ret = 0;
    int digit = 0;
    while ( pos < s.Len() && digit >= 0 && digit <= 9 )
    {
        ret = ret*10 + digit;
        digit = s[pos] - '0';
        pos++;
    }

    if ( ret > 0 )
    {
        return ret + 0x10000;
    }
    else
    {
        return digit + '0';
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

static char int_to_hex

(

int

i

)

[static]

Definition at line 1675 of file tString.cpp.

                             {
    if (i<0 || i >15)
        return 'Q';
    else
        return hex_array[i];
}

std::stringstream& operator<<	(	std::stringstream &	s,
		const tString &	t
	)

Definition at line 1852 of file tString.cpp.

{
    static_cast<std::ostream&>(s) << static_cast<const char *>(t);
    return s;
}

tColoredString& operator<<	(	tColoredString &	s,
		const tColoredStringProxy &	colorCode
	)

string building streaming operator

Appends a color code to a colored string

Parameters:

	s	the string to append to
	colorCode	the colorcode to append

Definition at line 1694 of file tString.cpp.

References tColoredStringProxy::b_, cs, tColoredStringProxy::g_, int_to_hex(), tColoredStringProxy::r_, and RTC().

{
    if (st_colorStrings)
    {
        char cs[9];
        cs[0]='0';
        cs[1]='x';

        int RGB[3];
        RGB[0]=RTC(colorCode.r_);
        RGB[1]=RTC(colorCode.g_);
        RGB[2]=RTC(colorCode.b_);

        for(int i=0;i<3;i++){
            int lp=RGB[i]%16;
            int hp=(RGB[i]-lp)/16;
            cs[2+2*i]=int_to_hex(hp);
            cs[2+2*i+1]=int_to_hex(lp);
        }
        cs[8]=0;

        s << cs;
    }

    return s;
}

Here is the call graph for this function:

std::istream& operator>>	(	std::istream &	s,
		tString &	x
	)

stream reading operator honoring escape sequences and quoting

Todo:

write symmetric stream writing operator

Parameters:

	s	stream to read from
	x	string to read to

Returns:

reference to stream for chaining

Definition at line 111 of file tString.cpp.

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

{
    x.Clear();

    std::ws(s);

    char c=s.get();

    // check if the string is quoted
    bool quoted = false;
    char quoteChar = c;   // if it applies, this is the quoting character
    if ( c == '"' || c == '\'' )
    {
        // yes, it is
        quoted = true;
        c = s.get();
    }

    while((quoted || !( isblank(c) || c == '\n' || c == '\r' ) ) && s.good() && !s.eof()){
        x += c;
        c=s.get();

        // read and interpret escape sequences
        if ( !st_ReadEscapeSequence( c, s) )
        {
            // interpret special characters
            if ( quoted && c == quoteChar )
            {
                // this marks the end of a quoted string; abort.
                c = s.get();
                break;
            }
        }
        else if ( isblank( c ) )
        {
            // include escaped spaces
            x += c;
            c=s.get();
        }

    }
    s.putback(c);
    return s;
}

Here is the call graph for this function:

static int RemoveTrailingColor	(	tString &	s,
		int	maxLen = -1
	)			[static]

Definition at line 1562 of file tString.cpp.

References tString::SetSize(), and tString::Size().

{
    // count bytes lost to color codes
    int posDisplacement = 0;
    int len = 0;

    // walk through string
    for ( size_t g=0; g+1 < s.Size(); g++)
    {
        if (s(g) == '0' && s(g+1) == 'x')
        {
            // test if the code is legal ( not so far at the end that it overlaps )
            if ( s.Size() >= g + 8 )
            {
                // everything is in order, record color code usage and advance
                posDisplacement+=8;
                g+=7;
            }
            else
            {
                // illegal code! Remove it.
                s.SetSize( g );
                // s[g]=0;
            }
        }
        else if ( maxLen > 0 )
        {
            if ( ++len >= maxLen )
            {
                // maximal end reached, cut it off
                s.SetSize( g-1 );
                // s[g]=0;
            }
        }
    }

    return posDisplacement;
}

Here is the call graph for this function:

static int RTC

(

REAL

x

)

[static]

Definition at line 1664 of file tString.cpp.

Referenced by operator<<().

                      {
    int ret=int(x*255);
    if (ret<0)
        ret=0;
    if (ret>255)
        ret=255;
    return ret;
}

Here is the caller graph for this function:

static bool st_ReadEscapeSequence	(	char &	c,
		std::istream &	s
	)			[static]

Definition at line 89 of file tString.cpp.

References st_ReadEscapeSequence().

{
    char c2 = '\0';
    bool ret = st_ReadEscapeSequence( c, c2, s );
    if ( c2 )
        s.putback( c2 );
    return ret;
}

Here is the call graph for this function:

static bool st_ReadEscapeSequence	(	char &	c,
		char &	c2,
		std::istream &	s
	)			[static]

Definition at line 47 of file tString.cpp.

Referenced by operator>>(), tString::ReadLine(), and st_ReadEscapeSequence().

{
    c2 = '\0';

    // detect escaping
    if ( c == '\\' && !s.eof() && s.good() )
    {
        c2 = s.get();

        // nothing useful read?
        if ( s.eof() )
        {
            c2 = 0;
            return false;
        }

        // interpret special escape sequences
        switch (c2)
        {
        case 'n':
            // turn \n into newline
            c = '\n';
            c2 = 0;
            return true;
        case '"':
        case ' ':
        case '\'':
        case '\n':
            // include quoting character as literal
            return true;
        default:
            // take the whole \x sequence as it appeared.
            return false;
        }
    }

    return false;
}

Here is the caller graph for this function:

bool tIsInList	(	tString const &	list_,
		tString const &	item
	)

check whether item is in a comma or whitespace separated list

Parameters:

	list	The string representation of the list
	item	The item to look for

Returns:

true if the list contains the item

Example: tIsInList( "ab, cd", "ab" ) -> true

Definition at line 2166 of file tString.cpp.

References isblank(), tString::Len(), pos, tString::StrPos(), and tString::SubStr().

Referenced by sn_BothHave(), and sn_GetSupportedMethods().

{
    tString list = list_;

    while( list != "" )
    {
        // find the item
        int pos = list.StrPos( item );

        // no traditional match? shoot.
        if ( pos < 0 )
        {
            return false;
        }

        // check whether the match is a true list match
        if ( 
            ( pos == 0 || list[pos-1] == ',' || isblank(list[pos-1]) )
            &&
            ( pos + item.Len() >= list.Len() || list[pos+item.Len()-1] == ',' || isblank(list[pos+item.Len()-1]) )
            )
        {
            return true;
        }
        else
        {
            // no? truncate the list and go on.
            list = list.SubStr( pos + 1 );
        }
    }
    
    return false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

template<class T>

void ToT	(	tString const &	source,
		T &	target,
		tString::size_type	pos,
		char const *	name
	)			[inline]

Definition at line 775 of file tString.cpp.

References tString::Convert(), and tString::Size().

Referenced by tString::ToFloat(), and tString::ToInt().

{
    if ( pos > source.Size() )
        pos = source.Size();

    if ( !source.Convert( target, pos ) )
    {
        std::ostringstream message;

        if ( pos > 0 )
        {
            message << "Expected an " << name << " at position " << pos << " of string \"" << source << "\", but got \"" << static_cast<tString::CHAR const *>(source) + pos << "\".";
        }
        else
        {
            message << "Expected an " << name << ", but got \"" << source << "\".";
        }
        throw tGenericException( message.str().c_str(), "Conversion Error" );
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tToLower

(

tString &

toTransform

)

converts a string to lowercase

Parameters:

toTransform

The string to transform

Definition at line 2209 of file tString.cpp.

References tString::Len().

Referenced by eVoter::HandleChat(), nKrawall::nMethod::nMethod(), tConfItemBase::tConfItemBase(), and uAction::uAction().

{
    for( int i = toTransform.Len()-2; i >= 0; --i )
    {
        toTransform[i] = tolower( toTransform[i] );
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void tToUpper

(

tString &

toTransform

)

converts a string to uppercase

Parameters:

toTransform

The string to transform

Definition at line 2226 of file tString.cpp.

References tString::Len().

Referenced by tConfItemBase::LoadLine(), and s_Veto().

{
    for( int i = toTransform.Len()-2; i >= 0; --i )
    {
        toTransform[i] = toupper( toTransform[i] );
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

---

Variable Documentation

tConfItem<bool> cs("COLOR_STRINGS", st_colorStrings) [static]

tString delimiters("!?.:;_()-, ") [static]

Referenced by tString::PosWordRight().

char hex_array[] = "0123456789abcdef" [static]

Definition at line 1673 of file tString.cpp.

bool st_colorStrings = true

Definition at line 1660 of file tString.cpp.

tConfItemLine st_wordDelimiters("WORD_DELIMITERS", delimiters) [static]

---