文字列クラス CGStr Reference

Document generated at 2003/10/26 23:33:16


書式
CGStr()
引数
なし
戻り値
なし
解説
コンストラクタ
 

 
書式
CGStr( CGStr& rStr )
引数
CGStr& rStr                 コピーもとオブジェクトへの参照
戻り値
なし
解説
コピーコンストラクタ
 

 
書式
CGStr( const char* pStr )
引数
const char* pStr            設定する文字列
戻り値
なし
解説
文字列初期化つきのコンストラクタ
 

 
書式
~CGStr()
引数
なし
戻り値
なし
解説
デストラクタ
 

 
書式
BOOL SetDefault()
引数
なし
戻り値
成功:TRUE
失敗:FALSE
解説
コンストラクタレベルでの初期値設定
 

 
書式
BOOL CopyMembers( const CGStr& rStr )
引数
const CGStr& rStr           コピーもとオブジェクトへの参照
戻り値
成功:TRUE
失敗:FALSE
解説
オブジェクトの内容を複製します。
 

 
書式
BOOL FreeString()
引数
なし
戻り値
成功:TRUE
失敗:FALSE
解説
設定されている文字列を解放します。
 

 
書式
BOOL Initialize()
引数
なし
戻り値
成功:TRUE
失敗:FALSE
解説

    
 

 
書式
BOOL Release()
引数
なし
戻り値
成功:TRUE
失敗:FALSE
解説
オブジェクトの内容を破棄し、確保しているリソースを解放します。
 

 
書式
BOOL SetString( const char* pString )
引数
const char* pString         設定する文字列
戻り値
成功:TRUE
失敗:FALSE
解説
オブジェクトに対して文字列を設定します。
既存の文字列があった場合には、一度解放されてから
新しい文字列を設定します。
pString に NULL を指定した場合は、設定されている文字列を
解放して関数を終了します。
 

 
書式
const char* GetString() const
引数
なし
戻り値
オブジェクトに格納されている文字列
解説
文字列を char* で返します。
 

 
書式
BOOL AppendString( const char* pString )
引数
const char* pString         追加する文字列
戻り値
成功:TRUE
失敗:FALSE
解説
文字列のうしろに文字列を接続します。
 

 
書式
BOOL AppendString( const CGStr& rString )
引数
CGStr& rString              追加する文字列
戻り値
成功:TRUE
失敗:FALSE
解説
文字列の後ろに文字列を連結します。
 

 
書式
BOOL InsertString( const char* pString )
引数
char* pString               挿入する文字列
戻り値
成功:TRUE
失敗:FALSE
解説
文字列の前に文字列を接続します。
 

 
書式
BOOL InsertString( const CGStr& rString )
引数
CGStr& rString              連結する文字列
戻り値
成功:TRUE
失敗:FALSE
解説
文字列の前に文字列を挿入して連結します。
 

 
書式
BOOL DeleteLastCR()
引数
なし
戻り値
成功:TRUE
失敗:FALSE
解説
文字列の一番最後が \n だったら、それを \0 に置き換えます。
 

 
書式
BOOL StrLast( const CGStr& rString ) const
引数
const CGStr& rString        含まれるか否かを確認する文字列
戻り値
  含まれる:TRUE
含まれない:FALSE
解説
文字列が、rString で示す文字列で終了している場合に TRUE を
返します。
 

 
書式
BOOL StrLast( const char* pString ) const
引数
const char* pString         含まれるか否かを確認する文字列
戻り値
  含まれる:TRUE
含まれない:FALSE
解説
文字列が、pString で示す文字列で終了している場合に TRUE を
返します。
 

 
書式
BOOL DeleteLastStr( const CGStr& rString )
引数
const CGStr& rString            削除する文字列
戻り値
成功:TRUE
失敗:FALSE
解説
文字列の最後に rString がついていた場合、それを削除します。
(エンドコードを上書きします。)
文字列の最後に rString がついていなかった場合には、
なにもせずに TRUE を返します。
 

 
書式
BOOL DeleteLastStr( const char* pString )
引数
const char* pString         削除する文字列
戻り値
成功:TRUE
失敗:FALSE
解説
文字列の最後に pString がついていた場合、それを削除します。
(エンドコードを上書きします。)
文字列の最後に pString がついていなかった場合には、
なにもせずに TRUE を返します。
 

 
書式
long Length() const
引数
なし
戻り値
設定されている文字列の長さ
エラーの場合は -1
解説
設定されている文字列の長さをバイト単位で返します。
文字列が設定されていない場合は 0 を返します。
 

 
書式
long MBLength() const
引数
なし
戻り値
設定されている文字数
解説
設定されている文字列の文字数を返します。
マルチバイト文字についても、1文字あたり1がカウントされます。
 

 
書式
long GetMBLetterSize( const char* pLetter ) const
引数
文字列へのポインタ
戻り値
pLetter が指す文字列の、先頭文字のバイト数
解説
文字のバイト数を返します。
この関数は、S-JIS 用に記述されています。
 

 
書式
BOOL IsEndCode( const unsigned char* pLetter )
引数
const unsigned char* pLetter    文字列へのポインタ
戻り値
        エンドコード:TRUE
エンドコードではない:FALSE
解説
文字列への先頭を pLetter に指定します。
pLetter がエンドコードを指している場合には TRUE を返します。
 

 
書式
BOOL IsCRCode( const unsigned char* pLetter )
引数
const unsigned char* pLetter    文字列へのポインタ
戻り値
  改行コード:TRUE
改行ではない:FALSE
解説
文字列への先頭を pLetter に指定します。
pLetter が改行コードを指している場合には TRUE を返します。
 

 
書式
BOOL SetEndCode( unsigned char* pLetter )
引数
char* pLetter               エンドコードを書き込む
戻り値
成功:TRUE
失敗:FALSE
解説
pLetter にエンドコードを書き込みます。
 

 
書式
BOOL Explode( const CGStr& rKey , CDStringArray& rElements )
引数
const CGStr&   rKey         分離のキーとなる文字列
CDStringArray& rElements    結果を格納するための CDStringArray への参照
戻り値
成功:TRUE
失敗:FALSE
解説
文字列を rKey で分割し、配列 rElements に格納します。
 

 
書式
BOOL Explode( const char* pKey , CDStringArray& rElements )
引数
const char*    pKey         分離のキーとなる文字列
CDStringArray& rElements    結果を格納するための CDStringArray への参照
戻り値
成功:TRUE
失敗:FALSE
解説
文字列を pKey で分割し、配列 rElements に格納します。
 

 
書式
BOOL Implode( const CGStr& rKey , CDStringArray& rElements )
引数
CGStr&         rKey         要素間に挿入する文字
CDStringArray& rElements    結合する要素を格納した CDStringArray への参照
戻り値
成功:TRUE
失敗:FALSE
解説
配列 rElements に格納された文字列を、rKey で区切った1つの
文字列に結合します。
 

 
書式
BOOL Implode( const char* pKey , CDStringArray& rElements )
引数
const char*    pKey         要素間に挿入する文字
CDStringArray& rElements    結合する要素を格納した CDStringArray への参照
戻り値
成功:TRUE
失敗:FALSE
解説
配列 rElements に格納された文字列を、pKey で区切った1つの
文字列に結合します。
 

 
書式
BOOL Split( const CGStr& rKey , CGStr& rLeft , CGStr& rRight )
引数
const CGStr& rKey           切り離すキー文字列
CGStr&       rLeft          左側文字列
CGStr&       rRight         右側文字列
戻り値
成功:TRUE
失敗:FALSE
解説
文字列に含まれる rKey の左側と右側で分離します。
結果は、rLeft と rRight に格納されます。
文字列に rKey が含まれなかった場合には FALSE で返ります。
 

 
書式
BOOL Split( const char* pKey , CGStr& rLeft , CGStr& rRight )
引数
const char* pKey            切り離すキー文字列
CGStr&      rLeft           左側文字列
CGStr&      rRight          右側文字列
戻り値
成功:TRUE
失敗:FALSE
解説
文字列に含まれる rKey の左側と右側で分離します。
結果は、rLeft と rRight に格納されます。
文字列に rKey が含まれなかった場合には FALSE で返ります。
 

 
書式
BOOL CheckKey( const unsigned char* pString , const CGStr& rKey )
引数
const unsigned char*  pString   文字列の先頭へのポインタ
const CGStr& rKey               キー文字列
戻り値
      一致:TRUE
一致しない:FALSE
解説
文字列 pString の先頭が、キー文字列 rKey と一致するか
否かを確認します。
 

 
書式
CGStr& operator=( const CGStr& rStr )
引数
const CGStr& rStr           代入もとオブジェクトへの参照
戻り値
自分への参照
解説
代入演算子
 

 
書式
CGStr& operator=( const char* pStr )
引数
const char* pString         代入する文字列
戻り値
自分への参照
解説
代入演算子
 

 
書式
CGStr   operator+( const CGStr& rString ) const
引数
const CGStr& rString        足す数
戻り値
連結した文字列を格納したオブジェクト
解説
加算演算子
 

 
書式
CGStr operator+( const char* pString ) const
引数
const char* pString         足される数
戻り値
連結した文字列を格納したオブジェクト
解説
加算演算子
 

 
書式
CGStr& operator+=( const char* pString )
引数
const char* pString         連結する文字列
戻り値
自分への参照
解説
加算代入演算子
 

 
書式
CGStr& operaotr+=( const CGStr& rString )
引数
const CGStr& rString        連結する文字列への参照
戻り値
自分への参照
解説
加算代入演算子
 

 
書式
BOOL operator==( const char* pString ) const
引数
const char* pString         比較対象の文字列
戻り値
  一致:TRUE
不一致:FALSE
解説
比較演算子
文字列の内容が一致している場合に TRUE を返します。
メモリ上の格納位置が異なっていても、文字列が一致すれば
TRUE を返します。
 

 
書式
BOOL operator==( const CGStr& rString ) const
引数
const CGStr& rString        比較対照の文字列
戻り値
  一致:TRUE
不一致:FALSE
解説
比較演算子
文字列の内容が一致している場合に TRUE を返します。
メモリ上の格納位置が異なっていても、文字列が一致すれば
TRUE を返します。
 

 
書式
BOOL operator!=( const char* pString ) const
引数
const char* pString         比較対照の文字列
戻り値
 一致:FALSE
不一致:TRUE
解説
operator== の否定を返します。
 

 
書式
BOOL operator!=( CGStr& rString ) const
引数
const CGStr& rString        比較対照の文字列
戻り値
 一致:FALSE
不一致:TRUE
解説
operator== の否定を返します。

BACK