让HGE支持中文(3) - HGE字符串处理

前面都已经讲了怎么请HGE支持并显示中文..

另外呢.我们还需要的一个处理字符串的类..

当然也可以不用.所以放到最后拿出来.

不过当对于UNICODE与非UNICODE之间切来切去的时候.

你不可能一直在那里改代码..

这个时候CString就可以用到了.

虽然CString可以放到HGE里使用.不过还是自己找一份比较好/

CString属于ATL的东西.自然会引入ATL的东西.编译时候会填加几十K上百K.

所有还是自己找一份或者自己定一份好..

为此我将Nebula2的nString给放到HGE里去了.

这样也便玩我们使用.

代码如下:仅一个H文件,所有代码都在里面:

// Add by ShowLong. 20070629
//  Add from nebula2

#include "hge.h"
#include <ctype.h>
#include <stdarg.h>
#include <cstdarg>
#include < string.h>
#include <assert.h>
#include <malloc.h>
#include <stdio.h>
#include <stdlib.h>

#define t_max(a,b)      (((a) > (b)) ? (a) : (b))
#define t_min(a,b)      (((a) < (b)) ? (a) : (b))

// ------------------------------------------------------------------------------
class hgeString
{
public:
     ///  constructor
    hgeString();
     ///  constructor 1
    hgeString( const  char* str);
     ///  copy constructor
    hgeString( const hgeString& rhs);
     ///  destructor
    ~hgeString();
     ///  = operator
    hgeString&  operator=( const hgeString& rhs);
     ///  = operator with string
    hgeString&  operator=( const  char* rhs);
     ///  += operator with char*
    hgeString&  operator+=( const  char* rhs);
     ///  += operator with string
    hgeString&  operator+=( const hgeString& rhs);
     ///  Is `a' equal to `b'?
    friend  bool  operator == ( const hgeString& a,  const hgeString& b);
     ///  Is `a' unequal to `b'?
    friend  bool  operator != ( const hgeString& a,  const hgeString& b);
     ///  Is `a' smaller than `b'?
    friend  bool  operator < ( const hgeString& a,  const hgeString& b);
     ///  Is `a' greater than `b'?
    friend  bool  operator > ( const hgeString& a,  const hgeString& b);
     ///  Is `a' smaller than or equal to `b'?
    friend  bool  operator <= ( const hgeString& a,  const hgeString& b);
     ///  Is `a' greater than or equal to `b'?
    friend  bool  operator >= ( const hgeString& a,  const hgeString& b);
     ///  Subscript operator (read only).
     char  operator[]( int i)  const;
     ///  Subscript operator (writable).
     char&  operator[]( int i);
     ///  set as char ptr, with explicit length
     void Set( const  char* ptr,  int length);
     ///  set as char ptr
     void Set( const  char* str);
     ///  set as int value
     void SetInt( int val);
     ///  set as float value
     void SetFloat( float val);
     ///  set as bool value
     void SetBool( bool val);
     ///  get string as char ptr
     const  char* Get()  const;
     ///  return contents as integer
     int AsInt()  const;
     ///  return contents as float
     float AsFloat()  const;
     ///  return contents as bool
     bool AsBool()  const;
     ///  return true if the content is a valid integer
     bool IsValidInt()  const;
     ///  return true if the content is a valid float
     bool IsValidFloat()  const;
     ///  return true if the content is a valid bool
     bool IsValidBool()  const;
     ///  return length of string
     int Length()  const;
     ///  clear the string
     void Clear();
     ///  return true if string object is empty
     bool IsEmpty()  const;
     ///  return true if string object is not empty
     bool IsValid()  const;
     ///  append character pointer
     void Append( const  char* str);
     ///  append string
     void Append( const hgeString& str);
     ///  append a range of characters
     void AppendRange( const  char* str, unsigned  int numChars);
     ///  append int value
     void AppendInt( int val);
     ///  append float value
     void AppendFloat( float val);
     ///  convert string to lower case
     void ToLower();
     ///  convert string to upper case
     void ToUpper();
     ///  *** OBSOLETE *** get first token (this will destroy the string)
     const  char* GetFirstToken( const  char* whiteSpace);
     ///  *** OBSOLETE *** get next token (this will destroy the string)
     const  char* GetNextToken( const  char* whiteSpace);
     ///  extract substring
    hgeString ExtractRange( int from,  int numChars)  const;
     ///  terminate string at first occurrence of character in set
     void Strip( const  char* charSet);
     ///  Index of first appearance of `v' starting from index `startIndex'.
     int FindStringIndex( const hgeString& v,  int startIndex)  const;
     ///  return index of character in string
     int FindCharIndex(unsigned  char c,  int startIndex)  const;
     ///  terminate string at given index
     void TerminateAtIndex( int index);
     ///  returns true if string contains character from set
     bool ContainsCharFromSet( const  char* charSet)  const;
     ///  strip slash at end of path, if exists
     void StripTrailingSlash();
     ///  delete characters from charset at left side of string
    hgeString TrimLeft( const  char* charSet)  const;
     ///  delete characters from charset at right side of string
    hgeString TrimRight( const  char* charSet)  const;
     ///  trim characters from charset at both sides of string
    hgeString Trim( const  char* charSet)  const;
     ///  substitute every occurrence of a string with another string
    hgeString Substitute( const  char* str,  const  char* substStr)  const;
     ///  substitute every occurrence of a character with another character
     void SubstituteCharacter( char c,  char subst);
     ///  convert string in place from UTF-8 to 8-bit ANSI
     void UTF8toANSI();
     ///  convert ANSI to UTF-8 in place
     void ANSItoUTF8();
     ///  get pointer to extension (without the dot)
     const  char* GetExtension()  const;
     ///  check if extension matches (no dot in the extension!)
     bool CheckExtension( const  char* ext)  const;
     ///  convert backslashes to slashes
     void ConvertBackslashes();
     ///  remove extension
     void StripExtension();
     ///  extract the part after the last directory separator
    hgeString ExtractFileName()  const;
     ///  extract the last directory of the path
    hgeString ExtractLastDirName()  const;
     ///  extract the part before the last directory separator
    hgeString ExtractDirName()  const;
     ///  extract path until last slash
    hgeString ExtractToLastSlash()  const;
     ///  format string printf-style
     void __cdecl Format( const  char* fmtString, ...);
             // __attribute__((format(printf,2,3)));
     ///  format string printf-style, taking a va_list
     void FormatWithArgs( const  char* fmtString, va_list args);
     ///  replace illegal filename characters
     void ReplaceIllegalFilenameChars( char replacement);
     ///  return true if string only contains characters from charSet argument
     bool CheckValidCharSet( const hgeString& charSet)  const;
     ///  replace characters within a string
     void ReplaceChars( const  char* charSet,  char replacement);
     ///  construct a string from an int
     static hgeString FromInt( int i);
     ///  construct a string from a float
     static hgeString FromFloat( float f);
     ///  construct a string from a bool
     static hgeString FromBool( bool b);

protected:
     ///  copy contents
     void Copy( const hgeString& src);
     ///  delete contents
     void Delete();
     ///  get pointer to last directory separator
     char* GetLastSlash()  const;
     ///  Set the length, accounting for the union.
     void SetLength(size_t);

     enum
    {
        LOCALSTRINGSIZE = 14,
    };
     char*  string;
    union
    {
         struct
        {
             char localString[LOCALSTRINGSIZE];
            unsigned  short localStrLen;
        };
        unsigned  int strLen;
    };
};

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString::hgeString() :
     string(0),
    strLen(0),
    localStrLen(0)
{
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::Delete()
{
     if ( this-> string)
    {
        delete [] this-> string;
         this-> string = 0;
    }
     this->localString[0] = 0;
     this->localStrLen = 0;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString::~hgeString()
{
     this->Delete();
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::Set( const  char* str,  int length)
{
     this->Delete();
     if (str)
    {
         if (length >= LOCALSTRINGSIZE)
        {
             this-> string =  new  char[length + 1];
            memcpy( this-> string, str, length);
             this-> string[length] = 0;
             this->strLen = length;
        }
         else
        {
            memcpy( this->localString, str, length);
             this->localString[length] = 0;
             this->localStrLen = (unsigned  short)length;
        }
    }
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::Set( const  char* str)
{
     int len = 0;
     if (str)
    {
        len = ( int) strlen(str);
    }
     this->Set(str, len);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::SetInt( int val)
{
     this->Format("%d", val);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::SetFloat( float val)
{
     this->Format("%.6f", val);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::SetBool( bool val)
{
     if (val)
    {
        * this = "true";
    }
     else
    {
        * this = "false";
    }
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::Copy( const hgeString& src)
{
    assert(0 ==  this-> string);
     const  char* str = src.Get();
     if (str)
    {
         this->Set(str);
    }
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString::hgeString( const  char* str) :
     string(0),
    strLen(0),
    localStrLen(0)
{
     this->Set(str);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString::hgeString( const hgeString& rhs) :
     string(0),
    strLen(0)
{
     this->localString[0] = 0;
     this->Copy(rhs);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
const  char*
hgeString::Get()  const
{
     if ( this-> string)
    {
         return  this-> string;
    }
     if ( this->localString[0])
    {
         return  this->localString;
    }
     return "";
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString&
hgeString:: operator=( const hgeString& rhs)
{
     if (&rhs !=  this)
    {
         this->Delete();
         this->Copy(rhs);
    }
     return * this;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString&
hgeString:: operator=( const  char* rhs)
{
     if (rhs !=  this->Get())
    {
         this->Set(rhs);
    }
     return * this;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::AppendRange( const  char* str, unsigned  int numChars)
{
    assert(str);
     if (numChars > 0)
    {
        unsigned  int rlen = numChars;
        unsigned  int tlen =  this->Length() + rlen;
         if ( this-> string)
        {
             char* ptr =  new  char[tlen + 1];
            strcpy(ptr,  this-> string);
            strncat(ptr, str, numChars);
            delete [] this-> string;
             this-> string = ptr;
             this->strLen = tlen;
        }
         else  if ( this->localString[0])
        {
             if (tlen >= LOCALSTRINGSIZE)
            {
                 char* ptr =  new  char[tlen + 1];
                strcpy(ptr,  this->localString);
                strncat(ptr, str, numChars);
                 this->localString[0] = 0;
                 this-> string = ptr;
                 this->strLen = tlen;
            }
             else
            {
                strncat( this->localString, str, numChars);
                 this->localStrLen = (unsigned  short)tlen;
            }
        }
         else
        {
             this->Set(str, numChars);
        }
    }
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::Append( const  char* str)
{
    assert(str);
    unsigned  int rlen = (unsigned  int)strlen(str);
     this->AppendRange(str, rlen);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::Append( const hgeString& str)
{
     this->Append(str.Get());
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::AppendInt( int val)
{
    hgeString str;
    str.SetInt(val);
     this->Append(str);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::AppendFloat( float val)
{
    hgeString str;
    str.SetFloat(val);
     this->Append(str);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString&
hgeString:: operator+=( const  char* rhs)
{
     this->Append(rhs);
     return * this;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString&
hgeString:: operator+=( const hgeString& rhs)
{
     this->Append(rhs.Get());
     return * this;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
operator == ( const hgeString& a,  const hgeString& b)
{
     return strcmp(a.Get(), b.Get()) == 0;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
operator != ( const hgeString& a,  const hgeString& b)
{
     return strcmp(a.Get(), b.Get()) != 0;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
operator < ( const hgeString& a,  const hgeString& b)
{
     return strcmp(a.Get(), b.Get()) < 0;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
operator > ( const hgeString& a,  const hgeString& b)
{
     return strcmp(a.Get(), b.Get()) > 0;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
operator <= ( const hgeString& a,  const hgeString& b)
{
     return strcmp(a.Get(), b.Get()) <= 0;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
operator >= ( const hgeString& a,  const hgeString& b)
{
     return strcmp(a.Get(), b.Get()) >= 0;
}

// ------------------------------------------------------------------------------
/* *
     - 21-Sep-04    Johannes        the '/0' is a valid part of the string
*/
inline
char
hgeString:: operator[]( int i)  const
{
    assert(0 <= i && i <=  this->Length());
     if ( this-> string != 0)
    {
         return  this-> string[i];
    }
     return  this->localString[i];
}

// ------------------------------------------------------------------------------
/* *
     - 21-Sep-04    Johannes        the '/0' is a valid part of the string
*/
inline
char&
hgeString:: operator[]( int i)
{
    assert(0 <= i && i <=  this->Length());
     if ( this-> string != 0)
    {
         return  this-> string[i];
    }
     else
    {
         return  this->localString[i];
    }
}

// ------------------------------------------------------------------------------
/* *
*/
inline
int
hgeString::Length()  const
{
     if ( this-> string != 0)
    {
         return  this->strLen;
    }
     return  this->localStrLen;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::Clear()
{
     this->Delete();
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
hgeString::IsEmpty()  const
{
     if ( this-> string && ( this-> string[0] != 0))
    {
         return  false;
    }
     if ( this->localString[0] != 0)
    {
         return  false;
    }
     return  true;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
hgeString::IsValid()  const
{
     return ! this->IsEmpty();
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::ToLower()
{
     char* str = ( char*)( this-> string ?  this-> string :  this->localString);
     if (str)
    {
         char c;
         char* ptr = ( char*)str;
         while ((c = *ptr))
        {
            *ptr++ = tolower(c);
        }
    }
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::ToUpper()
{
     char* str = ( char*)( this-> string ?  this-> string :  this->localString);
     if (str)
    {
         char c;
         char* ptr = ( char*)str;
         while ((c = *ptr))
        {
            *ptr++ = toupper(c);
        }
    }
}

// ------------------------------------------------------------------------------
/* *
*/
static
inline
hgeString
operator+( const hgeString& s0,  const hgeString& s1)
{
    hgeString newString = s0;
    newString.Append(s1.Get());
     return newString;
}

// ------------------------------------------------------------------------------
/* *
    Get the first token in the string, delimited by one or more of the
    character in 'whiteSpace'. This simply invokes the strtok() function
    internally, and will destroy the contained string. After calling
    GetFirstToken(), invoke GetNextToken() until 0 returns.

    ATTENTION: if somebody else calls strtok() while GetFirstToken()/
    GetNextToken() is underway, everything will break apart!
    Check out the Tokenize() method for a better alternative.

    @param  whiteSpace  string containing white space characters
*/
inline
const  char*
hgeString::GetFirstToken( const  char* whiteSpace)
{
    assert(whiteSpace);
     return strtok(( char*) this->Get(), whiteSpace);
}

// ------------------------------------------------------------------------------
/* *
    Get the next token in the string. Call this after a GetFirstToken()
    or GetNextToken(). Returns 0 if no more tokens in string. This method
    will destroy the original string.

    ATTENTION: if somebody else calls strtok() while GetFirstToken()/
    GetNextToken() is underway, everything will break apart!
    Check out the Tokenize() method for a better alternative.

    @param  whiteSpace  string containing whitespace characters
*/
inline
const  char*
hgeString::GetNextToken( const  char* whiteSpace)
{
    assert(whiteSpace);
     return strtok(0, whiteSpace);
}

// ------------------------------------------------------------------------------
/* *
    Extract sub string.
*/
inline
hgeString
hgeString::ExtractRange( int from,  int numChars)  const
{
    assert(from <=  this->Length());
    assert(from + numChars <=  this->Length());
     const  char* str =  this->Get();
    hgeString newString;
    newString.Set(&(str[from]), numChars);
     return newString;
}

// ------------------------------------------------------------------------------
/* *
    Terminates the string at the first occurrence of one of the characters
    in charSet.
*/
inline
void
hgeString::Strip( const  char* charSet)
{
    assert(charSet);
     char* str = ( char*) this->Get();
     char* ptr = strpbrk(str, charSet);
     if (ptr)
    {
        *ptr = 0;
    }
     this->SetLength(strlen(str));

}

// ------------------------------------------------------------------------------
/* *
    Returns true if string contains one of the characters from charset.
*/
inline
bool
hgeString::ContainsCharFromSet( const  char* charSet)  const
{
    assert(charSet);
     char* str = ( char*) this->Get();
     char* ptr = strpbrk(str, charSet);
     return (0 != ptr);
}

// ------------------------------------------------------------------------------
/* *
    @result Index or -1 if not found.
*/
inline
int
hgeString::FindStringIndex( const hgeString& v,  int startIndex)  const
{
    assert(0 <= startIndex && startIndex <= Length() - 1);
    assert(!v.IsEmpty());

     for ( int i = startIndex; i < Length(); i++)
    {
         if (Length() - i < v.Length())
        {
             break;
        }

         if (strncmp(&(Get()[i]), v.Get(), v.Length()) == 0)
        {
             return i;
        }
    }

     return -1;
}

// ------------------------------------------------------------------------------
/* *
    Return index of character in string, or -1 if not found.
*/
inline
int
hgeString::FindCharIndex(unsigned  char c,  int startIndex)  const
{
     if ( this->Length() > 0)
    {
        assert(startIndex <  this->Length());
         const  char* ptr = strchr( this->Get() + startIndex, c);
         if (ptr)
        {
             return ( int)(ptr -  this->Get());
        }
    }
     return -1;
}

// ------------------------------------------------------------------------------
/* *
    Terminates the string at the given index.
*/
inline
void
hgeString::TerminateAtIndex( int index)
{
    assert(index <  this->Length());
     char* ptr = ( char*) this->Get();
    ptr[index] = 0;
     this->SetLength(strlen( this->Get()));
}

// ------------------------------------------------------------------------------
/* *
    Strips last slash, if the path name ends on a slash.
*/
inline
void
hgeString::StripTrailingSlash()
{
     if ( this->Length() > 0)
    {
         int pos = Length() - 1;
         char* str = ( char*) this->Get();
         if (str[pos] == '/' || str[pos] == '/')
        {
            str[pos] = 0;
             if ( this-> string != 0)
            {
                 this->strLen--;
            }
             else
            {
                 this->localStrLen--;
            }
        }
         this->SetLength(strlen( this->Get()));
    }
}

// ------------------------------------------------------------------------------
/* *
    Returns a new string which is this string, stripped on the left side
    by all characters in the char set.
*/
inline
hgeString
hgeString::TrimLeft( const  char* charSet)  const
{
    assert(charSet);
     if ( this->IsEmpty())
    {
         return * this;
    }

     int charSetLen = ( int)strlen(charSet);
     int thisIndex = 0;
     bool stopped =  false;
     while (!stopped && (thisIndex <  this->Length()))
    {
         int charSetIndex;
         bool match =  false;
         for (charSetIndex = 0; charSetIndex < charSetLen; charSetIndex++)
        {
             if ((* this)[thisIndex] == charSet[charSetIndex])
            {
                 //  a match
                match =  true;
                 break;
            }
        }
         if (!match)
        {
             //  stop if no match
            stopped =  true;
        }
         else
        {
             //  a match, advance to next character
            ++thisIndex;
        }
    }
    hgeString trimmedString(&( this->Get()[thisIndex]));
     return trimmedString;
}

// ------------------------------------------------------------------------------
/* *
    Returns a new string, which is this string, stripped on the right side
    by all characters in the char set.
*/
inline
hgeString
hgeString::TrimRight( const  char* charSet)  const
{
    assert(charSet);
     if ( this->IsEmpty())
    {
         return * this;
    }

     int charSetLen = ( int)strlen(charSet);
     int thisIndex =  this->Length() - 1;
     bool stopped =  false;
     while (!stopped && (thisIndex <  this->Length()))
    {
         int charSetIndex;
         bool match =  false;
         for (charSetIndex = 0; charSetIndex < charSetLen; charSetIndex++)
        {
             if ((* this)[thisIndex] == charSet[charSetIndex])
            {
                 //  a match
                match =  true;
                 break;
            }
        }
         if (!match)
        {
             //  stop if no match
            stopped =  true;
        }
         else
        {
             //  a match, advance to next character
            --thisIndex;
        }
    }
    hgeString trimmedString;
    trimmedString.Set( this->Get(), thisIndex + 1);
     return trimmedString;
}

// ------------------------------------------------------------------------------
/* *
    Trim both sides of a string.
*/
inline
hgeString
hgeString::Trim( const  char* charSet)  const
{
     return  this->TrimLeft(charSet).TrimRight(charSet);
}

// ------------------------------------------------------------------------------
/* *
    Substitute every occurrence of origStr with substStr.
*/
inline
hgeString
hgeString::Substitute( const  char* matchStr,  const  char* substStr)  const
{
    assert(matchStr && substStr);

     const  char* ptr =  this->Get();
     int matchStrLen = ( int)strlen(matchStr);
    hgeString dest;

     //  walk original string for occurrences of str
     const  char* occur;
     while ((occur = strstr(ptr, matchStr)))
    {
         //  append string fragment until match
        dest.AppendRange(ptr, (unsigned  int)(occur - ptr));

         //  append replacement string
        dest.Append(substStr);

         //  adjust source pointer
        ptr = occur + matchStrLen;
    }
    dest.Append(ptr);
     return dest;
}

// ------------------------------------------------------------------------------
/* *
    This converts an UTF-8 string to 8-bit-ANSI. Note that only characters
    in the range 0 .. 255 are converted, all other characters will be converted
    to a question mark.

    For conversion rules see  http://www.cl.cam.ac.uk/ ~mgk25/unicode.html#utf-8
*/
inline
void
hgeString::UTF8toANSI()
{
    unsigned  char* src = (unsigned  char*) this->Get();
    unsigned  char* dst = src;
    unsigned  char c;
     while ((c = *src++))
    {
         if (c >= 0x80)
        {
             if ((c & 0xE0) == 0xC0)
            {
                 //  a 2 byte sequence with 11 bits of information
                unsigned  short wide = ((c & 0x1F) << 6) | (*src++ & 0x3F);
                 if (wide > 0xff)
                {
                    c = '?';
                }
                 else
                {
                    c = (unsigned  char) wide;
                }
            }
             else  if ((c & 0xF0) == 0xE0)
            {
                 //  a 3 byte sequence with 16 bits of information
                c = '?';
                src += 2;
            }
             else  if ((c & 0xF8) == 0xF0)
            {
                 //  a 4 byte sequence with 21 bits of information
                c = '?';
                src += 3;
            }
             else  if ((c & 0xFC) == 0xF8)
            {
                 //  a 5 byte sequence with 26 bits of information
                c = '?';
                src += 4;
            }
             else  if ((c & 0xFE) == 0xFC)
            {
                 //  a 6 byte sequence with 31 bits of information
                c = '?';
                src += 5;
            }
        }
        *dst++ = c;
    }
    *dst = 0;
}

// ------------------------------------------------------------------------------
/* *
    Convert contained ANSI string to UTF-8 in place.
*/
inline
void
hgeString::ANSItoUTF8()
{
    assert(! this->IsEmpty());
     int bufSize =  this->Length() * 2 + 1;
     char* buffer =  new  char[bufSize];
     char* dstPtr = buffer;
     const  char* srcPtr =  this->Get();
    unsigned  char c;
     while ((c = *srcPtr++))
    {
         //  note: this only covers the 2 cases that the character
         //  is between 0 and 127 and between 128 and 255
         if (c < 128)
        {
            *dstPtr++ = c;
        }
         else
        {
            *dstPtr++ = 192 + (c / 64);
            *dstPtr++ = 128 + (c % 64);
        }
    }
    *dstPtr = 0;
     this->Set(buffer);
    delete []buffer;
}

// ------------------------------------------------------------------------------
/* *
    Replace character with another.
*/
inline
void
hgeString::SubstituteCharacter( char c,  char subst)
{
     char* ptr = ( char*) this->Get();
     int i;
     for (i = 0; i <=  this->Length(); i++)
    {
         if (ptr[i] == c)
        {
            ptr[i] = subst;
        }
    }
}

// ------------------------------------------------------------------------------
/* *
    Converts backslashes to slashes.
*/
inline
void
hgeString::ConvertBackslashes()
{
     this->SubstituteCharacter('/', '/');
}

// ------------------------------------------------------------------------------
/* *
    @return     pointer to extension (without the dot), or 0
*/
inline
const  char*
hgeString::GetExtension()  const
{
     const  char* str =  this->Get();
     const  char* ext = strrchr(str, '.');
     if (ext)
    {
        ext++;
         if (ext[0] != 0)
        {
             return ext;
        }
    }
     return 0;
}

// ------------------------------------------------------------------------------
/* *
    Returns true if file extension matches.

    @param  ext     extension string (without the dot)
    @return         true if extension matches
*/
inline
bool
hgeString::CheckExtension( const  char* ext)  const
{
    assert(ext);
     const  char* extStr =  this->GetExtension();
     if (0 == extStr)
    {
         return  false;
    }
     return (0 == (strcmp(ext, extStr)));
}

// ------------------------------------------------------------------------------
/* *
    Remove the file extension.
*/
inline
void
hgeString::StripExtension()
{
     char* ext = ( char*) this->GetExtension();
     if (ext)
    {
        ext[-1] = 0;
    }
     this->SetLength(strlen( this->Get()));
}

// ------------------------------------------------------------------------------
/* *
    Get a pointer to the last directory separator.
*/
inline
char*
hgeString::GetLastSlash()  const
{
     char* s = ( char*) this->Get();
     char* lastSlash = strrchr(s, '/');
     if (0 == lastSlash) lastSlash = strrchr(s, '/');
     if (0 == lastSlash) lastSlash = strrchr(s, ':');
     return lastSlash;
}

// ------------------------------------------------------------------------------
/* *
    Return a hgeString object containing the part after the last
    path separator.
*/
inline
hgeString
hgeString::ExtractFileName()  const
{
    hgeString pathString;
     char* lastSlash =  this->GetLastSlash();
     if (lastSlash)
    {
        pathString = &(lastSlash[1]);
    }
     else
    {
        pathString =  this->Get();
    }
     return pathString;
}

// ------------------------------------------------------------------------------
/* *
    Return a hgeString object containing the last directory of the path, i.e.
    a category.

    - 17-Feb-04     floh    fixed a bug when the path ended with a slash
*/
inline
hgeString
hgeString::ExtractLastDirName()  const
{
    hgeString pathString(* this);
     char* lastSlash = pathString.GetLastSlash();

     //  special case if path ends with a slash
     if (lastSlash)
    {
         if (0 == lastSlash[1])
        {
            *lastSlash = 0;
            lastSlash = pathString.GetLastSlash();
        }

         char* secLastSlash = 0;
         if (0 != lastSlash)
        {
            *lastSlash = 0;  //  cut filename
            secLastSlash = pathString.GetLastSlash();
             if (secLastSlash)
            {
                *secLastSlash = 0;
                 return hgeString(secLastSlash+1);
            }
        }
    }
     return "";
}

// ------------------------------------------------------------------------------
/* *
    Return a hgeString object containing the part before the last
    directory separator.

    NOTE: I left my fix in that returns the last slash (or colon), this was
    necessary to tell if a dirname is a normal directory or an assign.

    - 17-Feb-04     floh    fixed a bug when the path ended with a slash
*/
inline
hgeString
hgeString::ExtractDirName()  const
{
    hgeString pathString(* this);
     char* lastSlash = pathString.GetLastSlash();

     //  special case if path ends with a slash
     if (lastSlash)
    {
         if (0 == lastSlash[1])
        {
            *lastSlash = 0;
            lastSlash = pathString.GetLastSlash();
        }
         if (lastSlash)
        {
            *++lastSlash = 0;
        }
    }
    pathString.SetLength(strlen(pathString.Get()));
     return pathString;
}

// ------------------------------------------------------------------------------
/* *
    Return a path string object which contains of the complete path
    up to the last slash. Returns an empty string if there is no
    slash in the path.
*/
inline
hgeString
hgeString::ExtractToLastSlash()  const
{
    hgeString pathString(* this);
     char* lastSlash = pathString.GetLastSlash();
     if (lastSlash)
    {
        lastSlash[1] = 0;
    }
     else
    {
        pathString = "";
    }
     return pathString;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::ReplaceChars( const  char* charSet,  char replacement)
{
    assert(charSet);
     char* ptr = ( char*) this->Get();
     char c;
     while (0 != (c = *ptr))
    {
         if (strchr(charSet, c))
        {
            *ptr = replacement;
        }
        ptr++;
    }
}

// ------------------------------------------------------------------------------
/* *
    Return true if the string only contains characters which are in the defined
    character set.
*/
inline
bool
hgeString::CheckValidCharSet( const hgeString& charSet)  const
{
     int i;
     int len =  this->Length();
     for (i = 0; i < len; i++)
    {
         if (-1 == charSet.FindCharIndex((* this)[i], 0))
        {
             return  false;
        }
    }
     return  true;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
hgeString::IsValidInt()  const
{
     return  this->CheckValidCharSet("  -+01234567890");
}

// ------------------------------------------------------------------------------
/* *
    Note: this method is not 100% correct, it just checks for invalid characters.
*/
inline
bool
hgeString::IsValidFloat()  const
{
     return  this->CheckValidCharSet("  -+.e1234567890");
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
hgeString::IsValidBool()  const
{
     static  const  char* bools[] = {
        "no", "yes", "off", "on", "false", "true", 0
    };
     int i = 0;
     while (bools[i] != 0)
    {
         if (0 == stricmp(bools[i],  this->Get()))
        {
             return  true;
        }
        i++;
    }
     return  false;
}

// ------------------------------------------------------------------------------
/* *
    Returns content as integer. Note: this method doesn't check whether the
    contents is actually a valid integer. Use the IsValidInteger() method
    for this!
*/
inline
int
hgeString::AsInt()  const
{
     return atoi( this->Get());
}

// ------------------------------------------------------------------------------
/* *
    Returns content as float. Note: this method doesn't check whether the
    contents is actually a valid float. Use the IsValidInt() method
    for this!
*/
inline
float
hgeString::AsFloat()  const
{
     return  float(atof( this->Get()));
}

// ------------------------------------------------------------------------------
/* *
*/
inline
bool
hgeString::AsBool()  const
{
     static  const  char* bools[] = {
        "no", "yes", "off", "on", "false", "true", 0
    };
     int i = 0;
     while (bools[i] != 0)
    {
         if (0 == stricmp(bools[i],  this->Get()))
        {
             return 1 == (i & 1);
        }
        i++;
    }
     return  false;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void __cdecl
hgeString::Format( const  char* fmtString, ...)
{
    va_list argList;
    va_start(argList, fmtString);
     this->FormatWithArgs(fmtString, argList);
    va_end(argList);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::FormatWithArgs( const  char* fmtString, va_list args)
{
    va_list argList;

     //  First calculate the required length
    argList = args;
    size_t requiredLength;

    requiredLength = _vscprintf(fmtString, argList);

    requiredLength++;  //  Account for NULL termination
    va_end(argList);

     //  Now we can allocate a buffer of the right length
     char* buf = ( char*)alloca(requiredLength);

     //  Now do the formatting
    _vsnprintf(buf, requiredLength, fmtString, args);
     this->Set(buf);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::SetLength(size_t length)
{
     if ( this-> string != 0)
    {
         this->strLen = (unsigned  int)length;
    }
     else
    {
         this->localStrLen = (unsigned  short)length;
    }
}

// ------------------------------------------------------------------------------
/* *
*/
inline
void
hgeString::ReplaceIllegalFilenameChars( char replacement)
{
     this->ReplaceChars("//:*?"<>|", replacement);
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString
hgeString::FromInt( int i)
{
    hgeString str;
    str.SetInt(i);
     return str;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString
hgeString::FromFloat( float f)
{
    hgeString str;
    str.SetFloat(f);
     return str;
}

// ------------------------------------------------------------------------------
/* *
*/
inline
hgeString
hgeString::FromBool( bool b)
{
    hgeString str;
    str.SetBool(b);
     return str;
}

#pragma  once

//  修改来自于nebula2引擎,代码原作属于nebula2.

代码有点长.