Home You are here: Home > Support > Reference v1.0

Change language: German

XmString Class Reference

List of all members.

Detailed Description

String class especially used within the exom framework.

The exom framework provide its own string class, to be independent from any other library as well from the STL providing std::string. Its behavior (in time complexity) is similar to std::string.

The internal representation is realized with char* terminated with 0 accessible by cstr(). The terminating 0 will always set by the class when changing the size of the string.

The empty string "" is implementented internally by pointing to the prepared string define with

    const char emptyStr [] = "";                            
This enables construction of an empty string without memory allocation using malloc or new[].


Public Member Functions

int GetSize () const
 Return the number of characters including the terminating 0.
int GetCapacity () const
 Return the number of characters reserved by the container.
void SetGrowOnly (bool flag)
 Enable/disable the possibility to reduced its capacity.
bool GetGrowOnly () const
 Return true, if vector can't reduced its capacity.
char * cstr () const
 Return the pointer to the internal string representation.
 XmString ()
 Construct an empty string "".
 XmString (const XmString &a)
 Copy constructor for a string.
 ~XmString ()
 Destructor.
XmStringoperator= (const XmString &a)
 string assignment
void Reserve (int abs)
 Reserve the absolute number of charachters, if current GetCapacity() is smaller.
void SetSize (int iSize)
 Set the string size, without copying any characters.
void Resize (int iSize)
 Set the string size by adding or removing charcters at the end of the vector.
void AddSize (int iNum, int growSize)
 Change the string size by adding the specified number of characters.
 XmString (const char *str)
 Construct a string with given string.
int GetLen () const
 Return the string length without the terminating 0.
void AssignStr (const XmString &str)
 Assign another string to this string instance.
void AssignStr (const char *str)
 Assign the given 0 terminated string to this instance.
void AssignStr (const char *str, int len)
 Assign the given string using the specified length.
void Clear ()
 Clear the string to "".
void AppendStr (const XmString &str)
 Append the given string.
void AppendStr (const char *str)
 Append the given 0 terminated string.
void AppendStr (const char *str, int len)
 Append given string using the specified length.
void AppendChar (char c)
 Append a character.
bool TextSet () const
 Return true, if string is not empty (!= "").
bool operator== (const char *str) const
 Return true if strings are equal.
bool operator!= (const char *str) const
 Return true if strings are not equal.
bool operator== (const XmString &str) const
 Return true if strings are equal.
bool operator!= (const XmString &str) const
 Return true if strings are not equal.
xmUInt32 HashCode () const
 Return a hash code of the string.

Static Public Member Functions

static xmUInt32 StrHashCode (const char *str)
 Return a hash code of the given string.
static xmUInt32 StrHashCode (const char *str, int len)
 Return a hash code of the given string.


Member Function Documentation

int GetSize  )  const [inline]
 

Return the number of characters including the terminating 0.

Prefer using GetLen().


Copyright © 2006 Praetz Software Development - www.exomware.com