pfc::string

#include <stringNew.h>

Data Structures
class	_comparatorCommon
class	comparatorCaseInsensitive
class	comparatorCaseInsensitiveASCII
class	comparatorCaseSensitive

Public Types
typedef rcptr_t< string_base const >	t_data
typedef rcptr_t< string8 >	t_dataImpl

Public Member Functions
	string ()
	string (const char *p_source)
	string (const char *p_source, t_size p_sourceLen)
	string (char *p_source)
	string (char *p_source, t_size p_sourceLen)
	string (t_data const &p_source)
	string (string_part_ref source)
template<typename TSource >
	string (const TSource &p_source)
	string (const string &other)
	string (string &&other)
t_data	_content () const
const char *	c_str () const
string	clone () const
bool	contains (char c) const
bool	contains (stringp s) const
bool	containsAnyChar (stringp s) const
bool	endsWith (char c) const
bool	endsWith (string s) const
char	firstChar () const
t_size	get_length () const
const char *	get_ptr () const
t_size	indexOf (char c, t_size base=0) const
t_size	indexOf (stringp s, t_size base=0) const
t_size	indexOfAnyChar (stringp s, t_size base=0) const
bool	isEmpty () const
char	lastChar () const
t_size	lastIndexOf (char c, t_size base=~0) const
t_size	lastIndexOf (stringp s, t_size base=~0) const
t_size	lastIndexOfAnyChar (stringp s, t_size base=~0) const
t_size	length () const
bool	operator!= (const string &p_other) const
string	operator+ (const string &p_item2) const
string	operator+ (const char *p_item2) const
template<typename TSource >
string	operator+ (const TSource &p_item2) const
template<typename TSource >
const string &	operator+= (const TSource &p_item)
bool	operator< (const string &p_other) const
bool	operator<= (const string &p_other) const
const string &	operator= (const string &other)
const string &	operator= (string &&other)
bool	operator== (const string &p_other) const
bool	operator> (const string &p_other) const
bool	operator>= (const string &p_other) const
char	operator[] (t_size p_index) const
const char *	ptr () const
string	replace (stringp strOld, stringp strNew) const
void	set_string (const char *ptr, t_size len=~0)
bool	startsWith (char c) const
bool	startsWith (string s) const
string	subString (t_size base) const
string	subString (t_size base, t_size count) const
string	toLower () const
string const &	toString () const
string	toUpper () const

Static Public Member Functions
static int	g_compare (const string &p_item1, const string &p_item2)
static string	g_concatenateRaw (const char *item1, t_size len1, const char *item2, t_size len2)
static bool	g_equals (const string &p_item1, const string &p_item2)
static bool	g_equalsCaseInsensitive (const string &p_item1, const string &p_item2)
static bool	isNonTextChar (char c)

Private Attributes
t_data	m_content

Detailed Description

New EXPERIMENTAL string class, allowing efficient copies and returning from functions.
Does not implement the string_base interface so you still need string8 in many cases.
Safe to pass between DLLs, but since a reference is used, objects possibly created by other DLLs must be released before owning DLLs are unloaded.

Definition at line 19 of file stringNew.h.

Member Typedef Documentation

typedef rcptr_t<string_base const> pfc::string::t_data

Definition at line 21 of file stringNew.h.

typedef rcptr_t<string8> pfc::string::t_dataImpl

Definition at line 22 of file stringNew.h.

Constructor & Destructor Documentation

pfc::string::string ( )

inline

Definition at line 24 of file stringNew.h.

: m_content(rcnew_t<__stringEmpty>()) {}

pfc::string::string ( const char *  p_source )

inline

Definition at line 25 of file stringNew.h.

: m_content(rcnew_t<string8>(p_source)) {}

pfc::string::string ( const char *  p_source, t_size  p_sourceLen  )

inline

Definition at line 26 of file stringNew.h.

: m_content(rcnew_t<string8>(p_source,p_sourceLen)) {}

pfc::string::string ( char *  p_source )

inline

Definition at line 27 of file stringNew.h.

: m_content(rcnew_t<string8>(p_source)) {}

pfc::string::string ( char *  p_source, t_size  p_sourceLen  )

inline

Definition at line 28 of file stringNew.h.

: m_content(rcnew_t<string8>(p_source,p_sourceLen)) {}

pfc::string::string ( t_data const &  p_source )

inline

Definition at line 29 of file stringNew.h.

: m_content(p_source) {}

pfc::string::string ( string_part_ref  source )

inline

Definition at line 30 of file stringNew.h.

: m_content(rcnew_t<string8>(source)) {}

template<typename TSource >

pfc::string::string

(

const TSource &

p_source

)

Definition at line 216 of file stringNew.h.

                                                                      {
        *this = pfc::toString(p_source);
    }

pfc::string::string ( const string &  other )

inline

Definition at line 33 of file stringNew.h.

: m_content(other.m_content) {}

pfc::string::string ( string &&  other )

inline

Definition at line 34 of file stringNew.h.

: m_content(std::move(other.m_content)) {}

Member Function Documentation

t_data pfc::string::_content ( ) const

inline

Definition at line 199 of file stringNew.h.

{return m_content;}

const char* pfc::string::c_str ( ) const

inline

Definition at line 126 of file stringNew.h.

{ return get_ptr(); }

string pfc::string::clone ( ) const

inline

Definition at line 86 of file stringNew.h.

{return string(ptr());}

bool pfc::string::contains

(

char

c

)

const

Definition at line 79 of file stringNew.cpp.

{return indexOf(c) != ~0;}

bool pfc::string::contains

(

stringp

s

)

const

Definition at line 80 of file stringNew.cpp.

{return indexOf(s) != ~0;}

bool pfc::string::containsAnyChar

(

stringp

s

)

const

Definition at line 81 of file stringNew.cpp.

{return indexOfAnyChar(s) != ~0;}

bool pfc::string::endsWith

(

char

c

)

const

Definition at line 47 of file stringNew.cpp.

                                  {
    const t_size len = length();
    if (len == 0) return false;
    return ptr()[len-1] == c;
}

bool pfc::string::endsWith

(

string

s

)

const

Definition at line 52 of file stringNew.cpp.

                                    {
    const t_size len = length(), subLen = s.length();
    if (subLen > len) return false;
    return subString(len - subLen) == s;
}

char pfc::string::firstChar

(

)

const

Definition at line 58 of file stringNew.cpp.

                             {
    return (*this)[0];
}

static int pfc::string::g_compare ( const string &  p_item1, const string &  p_item2  )

inlinestatic

Definition at line 116 of file stringNew.h.

{return strcmp(p_item1.ptr(),p_item2.ptr());}

static string pfc::string::g_concatenateRaw ( const char *  item1, t_size  len1, const char *  item2, t_size  len2  )

inlinestatic

Definition at line 43 of file stringNew.h.

                                                                                                         {
            t_dataImpl impl; impl.new_t();
            char * buffer = impl->lock_buffer(len1+len2);
            memcpy_t(buffer,item1,len1);
            memcpy_t(buffer+len1,item2,len2);
            impl->unlock_buffer();
            return string(t_data(impl));
        }

static bool pfc::string::g_equals ( const string &  p_item1, const string &  p_item2  )

inlinestatic

Definition at line 196 of file stringNew.h.

{return p_item1 == p_item2;}

static bool pfc::string::g_equalsCaseInsensitive ( const string &  p_item1, const string &  p_item2  )

inlinestatic

Definition at line 197 of file stringNew.h.

{return comparatorCaseInsensitive::compare(p_item1,p_item2) == 0;}

t_size pfc::string::get_length ( ) const

inline

Definition at line 128 of file stringNew.h.

{return m_content->get_length();}

const char* pfc::string::get_ptr ( ) const

inline

Definition at line 125 of file stringNew.h.

{return m_content->get_ptr();}

t_size pfc::string::indexOf	(	char	c,
		t_size	base = 0
	)		const

Returns

~0 if not found.

Definition at line 5 of file stringNew.cpp.

                                               {
    return pfc::string_find_first(ptr(),c,base);
}

t_size pfc::string::indexOf	(	stringp	s,
		t_size	base = 0
	)		const

Returns

~0 if not found.

Definition at line 11 of file stringNew.cpp.

                                                  {
    return pfc::string_find_first(ptr(),s.ptr(),base);
}

t_size pfc::string::indexOfAnyChar	(	stringp	s,
		t_size	base = 0
	)		const

Returns

~0 if not found.

Definition at line 17 of file stringNew.cpp.

                                                          {
    string s ( _s );
    const t_size len = length();
    const char* content = ptr();
    for(t_size walk = 0; walk < len; ++walk) {
        if (s.contains(content[walk])) return walk;
    }
    return ~0;
}

bool pfc::string::isEmpty ( ) const

inline

Definition at line 140 of file stringNew.h.

{return length() == 0;}

static bool pfc::string::isNonTextChar ( char  c )

inlinestatic

Definition at line 134 of file stringNew.h.

{return c >= 0 && c < 32;}

char pfc::string::lastChar

(

)

const

Definition at line 61 of file stringNew.cpp.

                            {
    const t_size len = length();
    return len > 0 ? (*this)[len-1] : (char)0;
}

t_size pfc::string::lastIndexOf	(	char	c,
		t_size	base = ~0
	)		const

Returns

~0 if not found.

Definition at line 8 of file stringNew.cpp.

                                                   {
    return pfc::string_find_last(ptr(),c,base);
}

t_size pfc::string::lastIndexOf	(	stringp	s,
		t_size	base = ~0
	)		const

Returns

~0 if not found.

Definition at line 14 of file stringNew.cpp.

                                                      {
    return pfc::string_find_last(ptr(),s.ptr(),base);   
}

t_size pfc::string::lastIndexOfAnyChar	(	stringp	s,
		t_size	base = ~0
	)		const

Returns

~0 if not found.

Definition at line 26 of file stringNew.cpp.

                                                              {
    string s ( _s );
    const char* content = ptr();
    for(t_size _walk = length(); _walk > 0; --_walk) {
        const t_size walk = _walk-1;
        if (s.contains(content[walk])) return walk;
    }
    return ~0;
}

t_size pfc::string::length ( ) const

inline

Definition at line 127 of file stringNew.h.

{return m_content->get_length();}

bool pfc::string::operator!= ( const string &  p_other ) const

inline

Definition at line 118 of file stringNew.h.

{return g_compare(*this,p_other) != 0;}

string pfc::string::operator+ ( const string &  p_item2 ) const

inline

Definition at line 52 of file stringNew.h.

                                                      {
            return g_concatenateRaw(ptr(),length(),p_item2.ptr(),p_item2.length());
        }

string pfc::string::operator+ ( const char *  p_item2 ) const

inline

Definition at line 55 of file stringNew.h.

                                                     {
            return g_concatenateRaw(ptr(),length(),p_item2,strlen(p_item2));
        }

template<typename TSource >

string pfc::string::operator+

(

const TSource &

p_item2

)

const

Definition at line 219 of file stringNew.h.

                                                                                     {
        return *this + pfc::toString(p_item2);
    }

template<typename TSource >

const string& pfc::string::operator+= ( const TSource &  p_item )

inline

Definition at line 62 of file stringNew.h.

                                                          {
            *this = *this + p_item;
            return *this;
        }

bool pfc::string::operator< ( const string &  p_other ) const

inline

Definition at line 119 of file stringNew.h.

{return g_compare(*this,p_other) < 0;}

bool pfc::string::operator<= ( const string &  p_other ) const

inline

Definition at line 121 of file stringNew.h.

{return g_compare(*this,p_other) <= 0;}

const string& pfc::string::operator= ( const string &  other )

inline

Definition at line 36 of file stringNew.h.

{m_content = other.m_content; return *this;}

const string& pfc::string::operator= ( string &&  other )

inline

Definition at line 37 of file stringNew.h.

{m_content = std::move(other.m_content); return *this;}

bool pfc::string::operator== ( const string &  p_other ) const

inline

Definition at line 117 of file stringNew.h.

{return g_compare(*this,p_other) == 0;}

bool pfc::string::operator> ( const string &  p_other ) const

inline

Definition at line 120 of file stringNew.h.

{return g_compare(*this,p_other) > 0;}

bool pfc::string::operator>= ( const string &  p_other ) const

inline

Definition at line 122 of file stringNew.h.

{return g_compare(*this,p_other) >= 0;}

char pfc::string::operator[] ( t_size  p_index ) const

inline

Definition at line 136 of file stringNew.h.

                                              {
            PFC_ASSERT(p_index <= length());
            return ptr()[p_index];
        }

const char* pfc::string::ptr ( ) const

inline

Definition at line 124 of file stringNew.h.

{return m_content->get_ptr();}

string pfc::string::replace	(	stringp	strOld,
		stringp	strNew
	)		const

Definition at line 66 of file stringNew.cpp.

                                                           {
    t_size walk = 0;
    string ret;
    for(;;) {
        t_size next = indexOf(strOld, walk);
        if (next == ~0) {
            ret += subString(walk); break;
        }
        ret += subString(walk,next-walk) + strNew;
        walk = next + strOld.length();
    }
    return ret;
}

void pfc::string::set_string ( const char *  ptr, t_size  len = ~0  )

inline

Definition at line 130 of file stringNew.h.

                                                           {
            *this = string(ptr, len);
        }

bool pfc::string::startsWith

(

char

c

)

const

Definition at line 35 of file stringNew.cpp.

                                    {
    return (*this)[0] == c;
}

bool pfc::string::startsWith

(

string

s

)

const

Definition at line 38 of file stringNew.cpp.

                                      {
    const char * walk = ptr();
    const char * subWalk = s.ptr();
    for(;;) {
        if (*subWalk == 0) return true;
        if (*walk != *subWalk) return false;
        walk++; subWalk++;
    }
}

string pfc::string::subString ( t_size  base ) const

inline

Definition at line 67 of file stringNew.h.

                                            {
            if (base > length()) throw exception_overflow();
            return string(ptr() + base);
        }

string pfc::string::subString ( t_size  base, t_size  count  ) const

inline

Definition at line 71 of file stringNew.h.

                                                          {
            return string(ptr() + base,count);
        }

string pfc::string::toLower ( ) const

inline

Definition at line 75 of file stringNew.h.

                               {
            string8_fastalloc temp; temp.prealloc(128);
            stringToLowerAppend(temp,ptr(),~0);
            return string(temp.get_ptr());
        }

string const& pfc::string::toString ( ) const

inline

Definition at line 40 of file stringNew.h.

{return *this;}

string pfc::string::toUpper ( ) const

inline

Definition at line 80 of file stringNew.h.

                               {
            string8_fastalloc temp; temp.prealloc(128);
            stringToUpperAppend(temp,ptr(),~0);
            return string(temp.get_ptr());
        }

Field Documentation

t_data pfc::string::m_content

private

Definition at line 201 of file stringNew.h.

---

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

• pfc/stringNew.h
• pfc/stringNew.cpp