前のページ次のページ上に戻るホーム SophiaFramework UNIVERSE 5.3
SFXWideString
WChar 型文字列を表すクラスです。
#include <SFXWideString.h.hpp>
class SFXWideString;
SFMTYPEDEFCLASS(SFXWideString)

協調図

SFXWideString クラスの協調図

解説

SFXAnsiString と SFXWideString

BREW には、シングルバイト/マルチバイト文字(ANSI文字)を表す char 型と、 携帯電話の画面に表示するためのダブルバイト文字を表す AECHAR 型(uint16 型)があります。 SophiaFramewok UNIVERSE では、この 2 種類の文字型はそれぞれ AChar 型、WChar 型として定義されます。 また、AChar 型文字列を表す SFXAnsiStringWChar 型文字列を表す SFXWideString の文字列クラスが利用可能です。

文字列を空にする方法

文字列を空にする方法は 2 つあります。

ひとつは、空文字列を代入する、または パラメータを "0" に設定して SFXWideString::SetLength 関数を呼び出す方法です。 もうひとつは、SFXWideString::Clear 関数を呼び出す方法です。

前者の方法では、ヒープは解放されません。ブロックアロケーションのサポートにより、 文字列を作成するときにメモリを新たに確保することなく、このヒープ領域を利用できるので処理が速くなります。

後者の方法では、ヒープを解放します。解放したヒープは他の用途に利用できますが、その分、実行速度は遅くなります。

どちらを使うかは、実行速度とメモリ使用量のどちらを優先させるかで判断します。

例 857. 空文字列を代入する、または SFXWideString::SetLength 関数を呼び出す方法

SFXWideString str = "最も優れた BREW  C++ プログラミング環境";

str = "";
// または
str.SetLength(0);

// ヒープは解放されない

例 858. Clear 関数を呼び出す方法

SFXWideString str = "最も優れた BREW  C++ プログラミング環境";

str.Clear();

// ヒープは解放される

短い文字列を頻繁に処理するときは、SFXWideString::SetLength 関数を呼び出す方法が効率的です。

SFXWideString str;

str = "プログラミング環境";
...
str.SetLength(0);
...
str = "フレームワーク";
...
str.SetLength(0);
...
str = "ミドルウェア";
...

Attach 関数 と Detach 関数

SFXWideString::Attach 関数は、 指定された文字列の領域を SFXWideString オブジェクトに結び付けます。 SFXWideString::Detach 関数はその逆の操作を行います。

SFXWideString::Set 関数や代入演算子 ( = ) では、データはコピーがされますが、 SFXWideString::Attach 関数や SFXWideString::Detach 関数では、データはコピーされません。

数百 KB もの文字列をコピーするためのヒープが無いとき、或いは、パフォーマンス劣化の問題を回避するときに利用します。

参照

SFXAnsiString | SFXBuffer | 文字型

メンバ

コンストラクタ/デストラクタ
SFXWideString( Void )
SFXWideString クラスのコンストラクタです。
SFXWideString( SFXWideStringConstRef string )
SFXWideString クラスのコンストラクタです。
SFXWideString( SFXAnsiStringConstRef string )
SFXWideString クラスのコンストラクタです。
SFXWideString( WCharConstPtr string , SInt32 length = -1 )
SFXWideString クラスのコンストラクタです。
SFXWideString( ACharConstPtr string , SInt32 length = -1 )
SFXWideString クラスのコンストラクタです。
SFXWideString( WChar character )
SFXWideString クラスのコンストラクタです。
SFXWideString( SFXBufferConstRef buffer )
SFXWideString クラスのコンストラクタです。
SFXWideString( UInt16 threshold , UInt16 cluster )
SFXWideString クラスのコンストラクタです。
~SFXWideString( Void )
SFXWideString クラスのデストラクタです。
パブリック関数
SFCError Add( SFXWideStringConstRef string )
この文字列の最後に指定された文字列を追加します。
SFCError Add( WCharConstPtr string , SInt32 length = -1 )
この文字列の最後に指定された文字列を追加します。
SFCError Add( WChar character )
この文字列の最後に指定された文字列を追加します。
SFXWideString AsLower( Void )
この文字列を小文字に変換した文字列を取得します。
SInt32 AsSInt32( SInt32 substitute = 0 )
この文字列を SInt32 型整数に変換します。
UInt32 AsUInt32( UInt32 substitute = 0 )
この文字列を UInt32 型整数に変換します。
SFXWideString AsUpper( Void )
この文字列を大文字に変換した文字列を取得します。
SFCError Attach( SFXWideStringPtr string )
指定された文字列をこの文字列オブジェクトに結び付けます。
SFCError Attach( WCharPtr string , SInt32 length = -1 )
指定された文字列をこの文字列オブジェクトに結び付けます。
SFCError Attach( SFXBufferPtr buffer )
指定された文字列をこの文字列オブジェクトに結び付けます。
SFCError AttachSFXBuffer( SFXBufferPtr buffer )
[廃止予定]指定されたバッファをこの文字列オブジェクトに結び付けます。
Void Clear( Void )
この文字列を空にします。
SInt32 Compare( SFXWideStringConstRef string , Bool sensitive = true )
この文字列と指定された文字列を辞書順に比較します。
SInt32 Compare( WCharConstPtr string , Bool sensitive = true )
この文字列と指定された文字列を辞書順に比較します。
SFXWideString Concat( SFXWideStringConstRef string )
この文字列の最後に指定された文字列を連結した文字列を取得します。
SFXWideString Concat( WCharConstPtr string , SInt32 length = -1 )
この文字列の最後に指定された文字列を連結した文字列を取得します。
SFXWideString Concat( WChar character )
この文字列の最後に指定された文字列を連結した文字列を取得します。
SFCError Copy( SInt32 index , SFXWideStringConstRef string )
この文字列を指定された開始位置から指定された文字列で上書きします。
SFCError Copy( SInt32 index , WCharConstPtr string , SInt32 length = -1 )
この文字列を指定された開始位置から指定された文字列で上書きします。
SFCError Detach( SFXWideStringPtr string )
この文字列オブジェクトが管理している文字列領域を切り離します。
WCharPtr Detach( SInt32Ptr length = null )
この文字列オブジェクトが管理している文字列領域を切り離します。
SFCError Detach( SFXBufferPtr buffer )
この文字列オブジェクトが管理している文字列領域を切り離します。
SFCError DetachSFXBuffer( SFXBufferPtr buffer )
[廃止予定]この文字列オブジェクトが管理している文字列領域を切り離します。
static
SFXWideStringConstRef
EmptyInstance( Void )
空文字列を取得します。
Bool EndsWith( SFXWideStringConstRef string , Bool sensitive = true )
この文字列が指定された文字列で終わるか判定します。
Bool EndsWith( WCharConstPtr string , Bool sensitive = true )
この文字列が指定された文字列で終わるか判定します。
Bool EndsWith( WChar character , Bool sensitive = true )
この文字列が指定された文字列で終わるか判定します。
Bool Equals( SFXWideStringConstRef string , Bool sensitive = true )
この文字列が指定された文字列と等しいか判定します。
Bool Equals( WCharConstPtr string , Bool sensitive = true )
この文字列が指定された文字列と等しいか判定します。
Void Fill( WChar character )
この文字列を指定された文字で埋めます。
SInt32 FirstIndexOf( SFXWideStringConstRef string , SInt32 index = SINT32_MINIMUM , Bool sensitive = true )
この文字列を先頭から検索して指定された文字列と一致する、最初のインデックスを取得します。
SInt32 FirstIndexOf( WCharConstPtr string , SInt32 index = SINT32_MINIMUM , Bool sensitive = true )
この文字列を先頭から検索して指定された文字列と一致する、最初のインデックスを取得します。
SInt32 FirstIndexOf( WChar character , SInt32 index = SINT32_MINIMUM , Bool sensitive = true )
この文字列を先頭から検索して指定された文字列と一致する、最初のインデックスを取得します。
static
SFXWideString
Format( va_ref< SFXWideStringConst > format , ... )
データを書式に従った文字列に設定し直します。
static
SFXWideString
Format( va_ref< SFXAnsiStringConst > format , ... )
データを書式に従った文字列に設定し直します。
static
SFXWideString
Format( WCharConstPtr format , ... )
データを書式に従った文字列に設定し直します。
static
SFXWideString
Format( ACharConstPtr format , ... )
データを書式に従った文字列に設定し直します。
static
SFXWideString
FormatV( SFXWideStringConstRef format , va_list argument )
可変個引数リストを書式に従った文字列に設定し直します。
static
SFXWideString
FormatV( SFXAnsiStringConstRef format , va_list argument )
可変個引数リストを書式に従った文字列に設定し直します。
static
SFXWideString
FormatV( WCharConstPtr format , va_list argument )
可変個引数リストを書式に従った文字列に設定し直します。
static
SFXWideString
FormatV( ACharConstPtr format , va_list argument )
可変個引数リストを書式に従った文字列に設定し直します。
WCharPtr GetBuffer( Void )
この文字列の内部バッファへのポインタを取得します。
WCharConstPtr GetBuffer( Void )
この文字列の内部バッファへのポインタを取得します。
WCharConstPtr GetCString( Void )
この文字列の内部バッファへの const ポインタを取得します。(内部バッファの内容を変更できません)
WChar GetChar( SInt32 index )
この文字列の指定されたインデックスの位置にある文字を取得します。
UInt16 GetCluster( Void )
この文字列の内部バッファメモリのクラスタサイズを取得します。[単位: バイト]
SInt32 GetLength( Void )
この文字列の長さ(文字数)を取得します。
SInt32 GetLengthCString( Void )
この文字列の先頭の "\0" までの長さ(文字数)を取得します。
UInt16 GetThreshold( Void )
この文字列の内部バッファメモリの最小値を取得します。[単位: バイト]
SFXWideString Insert( SInt32 index , SFXWideStringConstRef string )
この文字列の指定された位置に指定された文字列や文字を挿入した文字列を取得します。
SFXWideString Insert( SInt32 index , WCharConstPtr string , SInt32 length = -1 )
この文字列の指定された位置に指定された文字列や文字を挿入した文字列を取得します。
SFXWideString Insert( SInt32 index , WChar character )
この文字列の指定された位置に指定された文字列や文字を挿入した文字列を取得します。
Bool IsAlpha( Void )
この文字列の文字がすべて英文字であるか判定します。
Bool IsAlphaDigit( Void )
この文字列の文字がすべて英数字であるか判定します。
Bool IsAscii( Void )
この文字列の文字がすべて ASCII 文字であるか判定します。
Bool IsControl( Void )
この文字列の文字がすべて制御文字であるか判定します。
Bool IsDigit( Void )
この文字列の文字がすべて数字であるか判定します。
Bool IsEmpty( Void )
この文字列の長さが 0 であるか(この文字列が空であるか)判定します。
Bool IsEmptyCString( Void )
この文字列の先頭の文字が null 文字('\0')であるか判定します。
Bool IsGraph( Void )
この文字列の文字がすべて図形文字であるか判定します。
Bool IsHexDigit( Void )
この文字列の文字がすべて 16 進数で使う文字であるか判定します。
Bool IsLower( Void )
この文字列の文字がすべて小文字であるか判定します。
Bool IsNull( Void )
この文字列の文字がすべて null 文字('\0')であるか判定します。
Bool IsPrint( Void )
この文字列の文字がすべて印字可能文字であるか判定します。
Bool IsPunct( Void )
この文字列の文字がすべて空白文字・英数字以外の印字可能文字かであるか判定します。
Bool IsSpace( Void )
この文字列の文字がすべて空白文字または改行文字であるか判定します。
Bool IsUpper( Void )
この文字列の文字がすべて大文字であるか判定します。
SInt32 LastIndexOf( SFXWideStringConstRef string , SInt32 index = SINT32_MAXIMUM , Bool sensitive = true )
この文字列を末尾から検索して指定された文字列と一致する、最後のインデックスを取得します。
SInt32 LastIndexOf( WCharConstPtr string , SInt32 index = SINT32_MAXIMUM , Bool sensitive = true )
この文字列を末尾から検索して指定された文字列と一致する、最後のインデックスを取得します。
SInt32 LastIndexOf( WChar character , SInt32 index = SINT32_MAXIMUM , Bool sensitive = true )
この文字列を末尾から検索して指定された文字列と一致する、最後のインデックスを取得します。
SFCError Mul( SInt32 repeat )
この文字列を指定された回数繰り返した文字列にします。
SFXWideString Remove( SInt32 begin , SInt32 end )
この文字列から指定された範囲の文字列を削除した文字列を取得します。
SFXWideString Replace( SFXWideStringConstRef fstring , SFXWideStringConstRef tstring , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( SFXWideStringConstRef fstring , WCharConstPtr tstring , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( SFXWideStringConstRef fstring , WCharConstPtr tstring , SInt32 tlength , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WCharConstPtr fstring , SFXWideStringConstRef tstring , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WCharConstPtr fstring , SInt32 flength , SFXWideStringConstRef tstring , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WCharConstPtr fstring , WCharConstPtr tstring , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WCharConstPtr fstring , SInt32 flength , WCharConstPtr tstring , SInt32 tlength , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( SFXWideStringConstRef fstring , WChar tcharacter , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WChar fcharacter , SFXWideStringConstRef tstring , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WChar fcharacter , WChar tcharacter , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WCharConstPtr fstring , WChar tcharacter , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WCharConstPtr fstring , SInt32 flength , WChar tcharacter , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WChar fcharacter , WCharConstPtr tstring , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFXWideString Replace( WChar fcharacter , WCharConstPtr tstring , SInt32 tlength , Bool sensitive = true )
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
SFCError Set( SFXWideStringConstRef string )
この文字列を指定された文字列、文字、またはバッファで設定します。
SFCError Set( SFXAnsiStringConstRef string )
この文字列を指定された文字列、文字、またはバッファで設定します。
SFCError Set( WCharConstPtr string , SInt32 length = -1 )
この文字列を指定された文字列、文字、またはバッファで設定します。
SFCError Set( ACharConstPtr string , SInt32 length = -1 )
この文字列を指定された文字列、文字、またはバッファで設定します。
SFCError Set( WChar character )
この文字列を指定された文字列、文字、またはバッファで設定します。
SFCError Set( SFXBufferConstRef buffer )
この文字列を指定された文字列、文字、またはバッファで設定します。
SFCError SetChar( SInt32 index , WChar character )
この文字列の指定された位置に指定された文字を設定します。
Void SetCluster( UInt16 size )
この文字列の内部バッファメモリのクラスタサイズを設定します。[単位: バイト]
SFCError SetLength( SInt32 length )
この文字列の文字数を設定します。
Void SetThreshold( UInt16 size )
この文字列の内部バッファメモリの最小値を設定します。[単位: バイト]
Bool StartsWith( SFXWideStringConstRef string , Bool sensitive = true )
この文字列が指定された文字列で始まるか判定します。
Bool StartsWith( WCharConstPtr string , Bool sensitive = true )
この文字列が指定された文字列で始まるか判定します。
Bool StartsWith( WChar character , Bool sensitive = true )
この文字列が指定された文字列で始まるか判定します。
SFCError Sub( SFXWideStringConstRef string )
この文字列の末尾から指定された文字列を削除します。
SFCError Sub( WCharConstPtr string , SInt32 length = -1 )
この文字列の末尾から指定された文字列を削除します。
SFCError Sub( WChar character )
この文字列の末尾から指定された文字列を削除します。
SFXWideString Substring( SInt32 begin , SInt32 end )
この文字列の指定された範囲の文字列(部分文字列)を取得します。
Void ToLower( Void )
この文字列を小文字に変換します。
Void ToUpper( Void )
この文字列を大文字に変換します。
SFXWideString Trim( SFXWideStringConstRef string , Bool sensitive = true )
この文字列の先頭と末尾から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString Trim( WCharConstPtr string , Bool sensitive = true )
この文字列の先頭と末尾から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString Trim( WChar character , Bool sensitive = true )
この文字列の先頭と末尾から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString Trim( Void )
この文字列の先頭と末尾から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString TrimLeft( SFXWideStringConstRef string , Bool sensitive = true )
この文字列の先頭から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString TrimLeft( ACharConstPtr string , Bool sensitive = true )
この文字列の先頭から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString TrimLeft( AChar character , Bool sensitive = true )
この文字列の先頭から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString TrimLeft( Void )
この文字列の先頭から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString TrimRight( SFXWideStringConstRef string , Bool sensitive = true )
この文字列の末尾から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString TrimRight( ACharConstPtr string , Bool sensitive = true )
この文字列の末尾から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString TrimRight( AChar character , Bool sensitive = true )
この文字列の末尾から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString TrimRight( Void )
この文字列の末尾から空白や指定された文字または文字列を削除した文字列を取得します。
SFXWideString Truncate( Void )
この文字列の先頭の null('\0') 文字までの文字列を取得します。
SFXWideStringRef operator*=( SInt32 repeat )
左側の文字列を右側の回数だけ繰り返した文字列にします。
SFXWideStringRef operator+=( SFXWideStringConstRef string )
左側の文字列の末尾に右側の文字列を追加します。
SFXWideStringRef operator+=( WCharConstPtr string )
左側の文字列の末尾に右側の文字列を追加します。
SFXWideStringRef operator+=( WChar character )
左側の文字列の末尾に右側の文字列を追加します。
SFXWideStringRef operator-=( SFXWideStringConstRef string )
左側の文字列の末尾から右側の文字列を削除します。
SFXWideStringRef operator-=( WCharConstPtr string )
左側の文字列の末尾から右側の文字列を削除します。
SFXWideStringRef operator-=( WChar character )
左側の文字列の末尾から右側の文字列を削除します。
SFXWideStringRef operator<<( SFXWideStringRef left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加します。
SFXWideStringRef operator<<( SFXWideStringRef left , SFXAnsiStringConstRef right )
左側の文字列の末尾に右側の文字列を追加します。
SFXWideStringRef operator<<( SFXWideStringRef left , WCharConstPtr right )
左側の文字列の末尾に右側の文字列を追加します。
SFXWideStringRef operator<<( SFXWideStringRef left , ACharConstPtr right )
左側の文字列の末尾に右側の文字列を追加します。
SFXWideStringRef operator<<( SFXWideStringRef left , WChar right )
左側の文字列の末尾に右側の文字列を追加します。
SFXWideStringRef operator=( SFXWideStringConstRef string )
左側の文字列に右側の文字列を代入します。
SFXWideStringRef operator=( SFXAnsiStringConstRef string )
左側の文字列に右側の文字列を代入します。
SFXWideStringRef operator=( WCharConstPtr string )
左側の文字列に右側の文字列を代入します。
SFXWideStringRef operator=( ACharConstPtr string )
左側の文字列に右側の文字列を代入します。
WCharRef operator[]( SInt32 index )
この文字列内の指定されたインデックス位置にある文字を取得します。
WCharConstRef operator[]( SInt32 index )
この文字列内の指定されたインデックス位置にある文字を取得します。
Bool operator==( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator>=( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator<=( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも小さいか判定します。
SFXWideString operator-( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( SFXWideStringConstRef left , WChar right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( WChar left , SFXWideStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator*( SFXWideStringConstRef left , SInt32 right )
左側の文字列を右側の回数だけ繰り返した文字列を返します。
Bool operator!=( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と異なるか判定します。
SFXWideString operator+( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( SFXWideStringConstRef left , WChar right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( WChar left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
DefaultEnum
内部バッファメモリの最小値とクラスタサイズのデフォルト値を表します。[単位: バイト]
グローバル関数
Bool operator==( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator==( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と等しいか判定します。
Bool operator>=( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>=( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以上であるか判定します。
Bool operator>( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator>( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも大きいか判定します。
Bool operator<=( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<=( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列以下であるか判定します。
Bool operator<( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも小さいか判定します。
Bool operator<( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列よりも小さいか判定します。
SFXWideString operator-( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( SFXWideStringConstRef left , WChar right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator-( WChar left , SFXWideStringConstRef right )
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
SFXWideString operator*( SFXWideStringConstRef left , SInt32 right )
左側の文字列を右側の回数だけ繰り返した文字列を返します。
Bool operator!=( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と異なるか判定します。
Bool operator!=( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列が右側の文字列と異なるか判定します。
SFXWideString operator+( SFXWideStringConstRef left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( SFXWideStringConstRef left , SFXAnsiStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( SFXWideStringConstRef left , WCharConstPtr right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( SFXWideStringConstRef left , ACharConstPtr right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( WCharConstPtr left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( ACharConstPtr left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( SFXWideStringConstRef left , WChar right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
SFXWideString operator+( WChar left , SFXWideStringConstRef right )
左側の文字列の末尾に右側の文字列を追加した文字列を返します。

SFXWideString::SFXWideString
SFXWideString クラスのコンストラクタです。
[ public, explicit ]
SFXWideString(Void);
[ public ]
SFXWideString(
    SFXWideStringConstRef string   // コピー元の文字列
);
[ public ]
SFXWideString(
    SFXAnsiStringConstRef string   // コピー元の文字列
);
[ public ]
SFXWideString(
    WCharConstPtr string   // コピー元の WChar ポインタ
    SInt32 length = -1     // 文字列の文字数
);
[ public ]
SFXWideString(
    ACharConstPtr string   // コピー元の AChar ポインタ
    SInt32 length = -1     // 文字列の文字数
);
[ public, explicit ]
SFXWideString(
    WChar character   // WChar 文字
);
[ public, explicit ]
SFXWideString(
    SFXBufferConstRef buffer   // コピー元のバッファ
);
[ public, explicit ]
SFXWideString(
    UInt16 threshold   // バッファサイズの最小値
    UInt16 cluster     // クラスタサイズ
);

解説

引数に文字列や文字、バッファが指定された場合、 このコンストラクタは、 内部的に SFXWideString::Set 関数を呼び出して指定された値でこの文字列を初期設定します。

cluster 引数と threshold 引数が指定された場合は、 内部的に SFXWideString::SetCluster 関数 と SFXWideString::SetThreshold 関数を呼び出して、 この文字列の内部バッファメモリの最小サイズとクラスタサイズを設定します。

Reference

SFXWideString::Set | SFXWideString::SetCluster | SFXWideString::SetThreshold


SFXWideString::~SFXWideString
SFXWideString クラスのデストラクタです。
[ public ]
~SFXWideString(Void);

解説

このデストラクタは、この文字列の内部バッファメモリを解放します。


SFXWideString::Add
この文字列の最後に指定された文字列を追加します。
[ public ]
SFCError Add(
    SFXWideStringConstRef string   // 追加する文字列
);
[ public ]
SFCError Add(
    WCharConstPtr string   // 追加する文字列
    SInt32 length = -1     // 文字列の文字数
);
[ public ]
SFCError Add(
    WChar character   // 追加する文字
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • メモリ不足のとき: SFERR_NO_MEMORY

解説

この関数は、この文字列の最後に指定された文字列を追加します。

[Tip] Tip
この関数はこの文字列に影響を及ぼします。 元の文字列を保持したい場合は、SFXWideString::Concat 関数を使います。

WChar のポインタを指定すると、null 終端文字列と解釈します。 また、長さを指定すると複数の null('\0') を含んむ文字列を指定できます。

[Note] 注意

length 引数には、string 引数に指定した文字列の長さ以下の数字を指定してください。 負の整数を指定した場合は、string 引数に指定した null 終端文字列の長さを指定したことになります。

length 引数のデフォルト値は -1 です。

参照

SFXWideString::Concat | SFXWideString::Sub | SFXWideString::Mul | SFXWideString::operator<< | operator+ | SFXWideString::operator+=


SFXWideString::AsLower
この文字列を小文字に変換した文字列を取得します。
[ public, const ]
SFXWideString AsLower(Void);

戻り値

この文字列を小文字に変換した文字列

解説

この関数は、この文字列を小文字に変換した文字列を返します。

[Note] 注意
この関数を実行後、元の文字列は変化しません。

参照

SFXWideString::AsUpper | SFXWideString::ToLower


SFXWideString::AsSInt32
この文字列を SInt32 型整数に変換します。
[ public, const ]
SInt32 AsSInt32(
    SInt32 substitute = 0   // 変換失敗時の値
);

戻り値

この文字列を SInt32 型に変換した整数

解説

この関数は、この文字列を SInt32 型整数に変換します。

この文字列の先頭にある " " 文字は無視され、 "+" または "-" の文字は数字の文字列の前に何れか一方だけ一度限り許されます。 省略した場合は、正の整数と解釈されます。

[Tip] Tip
この文字列に " "、"+"、"-"、数字以外の文字が含まれるなどして変換に失敗した場合は、 substitute 引数に指定された値を返します。

参照

SFXWideString::AsUInt32


SFXWideString::AsUInt32
この文字列を UInt32 型整数に変換します。
[ public, const ]
UInt32 AsUInt32(
    UInt32 substitute = 0   // 変換失敗時の値
);

戻り値

この文字列を UInt32 型に変換した整数

解説

この関数は、この文字列を UInt32 型整数に変換します。

この文字列の先頭にある " " 文字は無視され、 "+" は数字の文字列の前に一度限り許されます(省略可)。

[Tip] Tip
この文字列に " "、"+"、数字以外の文字が含まれるなどして変換に失敗した場合は、 substitute 引数に指定された値を返します。 例えば、数字の前に "-" 文字があると、変換に失敗します。

参照

SFXWideString::AsSInt32


SFXWideString::AsUpper
この文字列を大文字に変換した文字列を取得します。
[ public, const ]
SFXWideString AsUpper(Void);

戻り値

この文字列を大文字に変換した文字列

解説

この関数は、この文字列を大文字に変換した文字列を返します。

[Note] 注意
この関数を実行後、元の文字列は変化しません。

参照

SFXWideString::AsLower | SFXWideString::ToUpper


SFXWideString::Attach
指定された文字列をこの文字列オブジェクトに結び付けます。
[ public ]
SFCError Attach(
    SFXWideStringPtr string   // SFXWideString クラスの文字列
);
[ public ]
SFCError Attach(
    WCharPtr string      // WChar 型文字列
    SInt32 length = -1   // 文字列の文字数
);
[ public ]
SFCError Attach(
    SFXBufferPtr buffer   // SFXBuffer クラスのバッファ
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 引数が null であるとき: SFERR_INVALID_PARAM

解説

この関数は、指定された文字列をこの文字列オブジェクトに結び付けます。 この関数を実行した後、指定された文字列は SFXWideString オブジェクトとして操作できます。

指定した文字列はコピーされないので、 SFXWideString::Set 関数よりも効率的で、 大容量の文字列データ処理時のパフォーマンス劣化やメモリ不足の問題を回避できます。

[Note] 注意
引数に指定した文字列に割り当てられていたメモリは、 この文字列オブジェクトが解放されるときに自動的に解放されます。

使用例

SFXWideString string;
WCharPtr char_ptr;

// char_ptr に 10240 バイトの文字列領域を割り当てる
char_ptr = static_cast<WCharPtr>(MemoryAllocate(10240));

...

// char_ptr に割り当てた文字列領域を string オブジェクトに結びつける
string.Attach(char_ptr, 10240);

// 以降、char_ptr に割り当てた文字列領域は string オブジェクトとして操作できる

・・・

// 使用後、char_ptr に割り当てた文字列領域は自動的に解放される 

参照

SFXWideString::Detach


SFXWideString::AttachSFXBuffer
[廃止予定]指定されたバッファをこの文字列オブジェクトに結び付けます。
[ public ]
SFCError AttachSFXBuffer(
    SFXBufferPtr buffer   // バッファ
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 引数が null であるとき: SFERR_INVALID_PARAM

解説

[Note] 廃止予定

この関数は、SophiaFramework UNIVERSE 6.0 で廃止される予定です。 この関数の代わりに SFXWideString::Attach(SFXBufferPtr buffer) 関数を利用することを推奨します。

参照

SFXWideString::Attach | SFXWideString::Detach | SFXWideString::DetachSFXBuffer


SFXWideString::Clear
この文字列を空にします。
[ public ]
Void Clear(Void);

解説

この関数は、この文字列を空にします。

[Note] 注意
この関数を実行する前にこの文字列に割り当てられていたメモリ領域は、解放されます。

SFXWideString::Compare
この文字列と指定された文字列を辞書順に比較します。
[ public, const ]
SInt32 Compare(
    SFXWideStringConstRef string   // 比較する文字列
    Bool sensitive = true          // 大小文字を区別するか
);
[ public, const ]
SInt32 Compare(
    WCharConstPtr string    // 比較する文字列
    Bool sensitive = true   // 大小文字を区別するか
);

戻り値

  • この文字列が指定された文字列より小さいとき: 負の値
  • この文字列が指定された文字列と等しいとき: 0
  • この文字列が指定された文字列より大きいとき: 正の値

解説

この関数は、この文字列と指定された文字列を辞書順に比較します。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。

参照

SFXWideString::Equals | operator== | operator!=


SFXWideString::Concat
この文字列の最後に指定された文字列を連結した文字列を取得します。
[ public, const ]
SFXWideString Concat(
    SFXWideStringConstRef string   // 連結する文字列
);
[ public, const ]
SFXWideString Concat(
    WCharConstPtr string   // 連結する文字列
    SInt32 length = -1     // 文字列の文字数
);
[ public, const ]
SFXWideString Concat(
    WChar character   // 連結する文字
);

戻り値

この文字列の最後に指定された文字列を連結した文字列

解説

この関数は、 この文字列の最後に指定された文字列を連結した文字列を取得します。

[Note] 注意
SFXWideString::Add 関数と異なり、  この関数はこの文字列を変更しません。

WChar のポインタを指定すると、null 終端文字列と解釈します。 また、長さを指定すると複数の null('\0') を含んむ文字列を指定できます。

[Note] 注意

length 引数には、string 引数に指定した文字列の長さ以下の数字を指定してください。 負の整数を指定した場合は、string 引数に指定した null 終端文字列の長さを指定したことになります。

length 引数のデフォルト値は -1 です。

参照

SFXWideString::Add | operator+ | SFXWideString::operator+=


SFXWideString::Copy
この文字列を指定された開始位置から指定された文字列で上書きします。
[ public ]
SFCError Copy(
    SInt32 index                   // 上書き開始位置
    SFXWideStringConstRef string   // コピーする文字列
);
[ public ]
SFCError Copy(
    SInt32 index           // 上書き開始位置
    WCharConstPtr string   // コピーする文字列
    SInt32 length = -1     // 文字列の長さ
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 上書きする文字列がこの文字列の終端を越えるとき、または上書き開始位置がこの文字列の範囲外のとき: SFERR_INVALID_PARAM

解説

この関数は、この文字列を指定された開始位置から指定された文字列で上書きします。

上書きする文字列がこの文字列の終端を越える場合、 または上書き開始位置がこの文字列の範囲外の場合は、SFERR_INVALID_PARAM を返し、コピーは行われません。

WChar のポインタを指定すると、null 終端文字列と解釈します。 また、長さを指定すると複数の null('\0') を含んむ文字列を指定できます。

[Note] 注意

length 引数には、string 引数に指定した文字列の長さ以下の数字を指定してください。 負の整数を指定した場合は、string 引数に指定した null 終端文字列の長さを指定したことになります。

length 引数のデフォルト値は -1 です。


SFXWideString::Detach
この文字列オブジェクトが管理している文字列領域を切り離します。
[ public ]
SFCError Detach(
    SFXWideStringPtr string   // 切り離された SFXWideString 文字列
);
[ public ]
WCharPtr Detach(
    SInt32Ptr length = null   // 切り離される文字列のサイズを格納する変数へのポインタ
);
[ public ]
SFCError Detach(
    SFXBufferPtr buffer   // 切り離された SFXBuffer バッファ
);

戻り値

切り離される文字列が WChar 型である場合、この文字列オブジェクトが管理している文字列領域(WCharPtr 型)を返します。 それ以外の場合は SFCError 型データ値を返します。

解説

この関数は、 この文字列オブジェクトが管理している文字列領域を切り離して返します。

[Note] 注意
文字列領域はコピーされないので、 SFXWideString::GetChar 関数よりも効率的で、 大容量の文字列データ処理時のパフォーマンス劣化やメモリ不足の問題を回避できます。

使用例

SFXWideString string;
WCharPtr char_ptr;
SInt32 length;

string = "The best application for BREW.";

...

// string オブジェクトが管理する文字列領域を切り離し、その領域のポインタを cha_ptr に設定する
// 領域のサイズは length に格納される
cha_ptr = string.Detach(&length);

// 以降、string オブジェクトの文字列領域は char_ptr に割り当てられた領域として操作する

...

// 使用後、char_ptr に割り当てた文字列領域を解放する必要がある
MemoryFree(char_ptr);

参照

SFXWideString::Attach


SFXWideString::DetachSFXBuffer
[廃止予定]この文字列オブジェクトが管理している文字列領域を切り離します。
[ public ]
SFCError DetachSFXBuffer(
    SFXBufferPtr buffer   // バッファ
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • 引数が null であるとき: SFERR_INVALID_PARAM

解説

[Note] 廃止予定

この関数は、SophiaFramework UNIVERSE 6.0 で廃止される予定です。 この関数の代わりに SFXWideString::Detach(SFXBufferPtr buffer) 関数を利用することを推奨します。

参照

SFXWideString::Detach | SFXWideString::AttachSFXBuffer | SFXWideString::Attach


SFXWideString::EmptyInstance
空文字列を取得します。
[ public, static ]
SFXWideStringConstRef EmptyInstance(Void);

戻り値

空文字列

解説

この関数は、空文字列を取得します。

[Tip] Tip
関数の戻り値として空文字列のインスタンスへの参照を返すときに使います。

SFXWideString::EndsWith
この文字列が指定された文字列で終わるか判定します。
[ public, const ]
Bool EndsWith(
    SFXWideStringConstRef string   // 調べる文字列
    Bool sensitive = true          // 大小文字を区別するか
);
[ public, const ]
Bool EndsWith(
    WCharConstPtr string    // 調べる文字列
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
Bool EndsWith(
    WChar character         // 調べる文字
    Bool sensitive = true   // 大小文字を区別するか
);

戻り値

  • 指定された文字列で終わるとき: true
  • そうでないとき: false

解説

この関数は、この文字列が指定された文字列で終わるか判定します。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。

参照

SFXWideString::StartsWith


SFXWideString::Equals
この文字列が指定された文字列と等しいか判定します。
[ public, const ]
Bool Equals(
    SFXWideStringConstRef string   // 比較対象の文字列
    Bool sensitive = true          // 大小文字を区別するか
);
[ public, const ]
Bool Equals(
    WCharConstPtr string    // 比較対象の文字列
    Bool sensitive = true   // 大小文字を区別するか
);

戻り値

  • 指定された文字列と等しいとき: true
  • そうでないとき: false

解説

この関数は、この文字列が指定された文字列と等しいか判定します。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。

参照

SFXWideString::Compare | operator== | operator!=


SFXWideString::Fill
この文字列を指定された文字で埋めます。
[ public ]
Void Fill(
    WChar character   // 文字
);

解説

この関数は、この文字列を指定された文字で埋めます。


SFXWideString::FirstIndexOf
この文字列を先頭から検索して指定された文字列と一致する、最初のインデックスを取得します。
[ public, const ]
SInt32 FirstIndexOf(
    SFXWideStringConstRef string    // 検索する文字列
    SInt32 index = SINT32_MINIMUM   // 検索開始位置
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SInt32 FirstIndexOf(
    WCharConstPtr string            // 検索する文字列
    SInt32 index = SINT32_MINIMUM   // 検索開始位置
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SInt32 FirstIndexOf(
    WChar character                 // 検索する文字
    SInt32 index = SINT32_MINIMUM   // 検索開始位置
    Bool sensitive = true           // 大小文字を区別するか
);

戻り値

  • 成功したとき: 見つかった位置のインデックス
  • 失敗したとき: -1

解説

この関数は、この文字列を先頭から末尾に向かって検索し、指定された文字列が見つかった最初の位置(インデックス)を取得します。

検索開始位置を指定することで、先頭以外の位置から検索できます(先頭のインデックスは 0 です)。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。

参照

SFXWideString::LastIndexOf


SFXWideString::Format
データを書式に従った文字列に設定し直します。
[ public, static ]
SFXWideString Format(
    va_ref< SFXWideStringConst > format   // 書式を表す文字列
    ...                                   // データ
);
[ public, static ]
SFXWideString Format(
    va_ref< SFXAnsiStringConst > format   // 書式を表す文字列
    ...                                   // データ
);
[ public, static ]
SFXWideString Format(
    WCharConstPtr format   // 書式を表す文字列
    ...                    // データ
);
[ public, static ]
SFXWideString Format(
    ACharConstPtr format   // 書式を表す文字列
    ...                    // データ
);

解説

この関数は、指定されたデータを書式に従った文字列に設定し直します。

書式は C 言語の printf 関数とほぼ同じですが、浮動小数点数の書式は使えません。

[Note] 注意
書式の詳細は、 BREW API SPRINTF を参照してください。

使用例

SIntN year = 2003;
SIntN month = 8;
SFXWideString str = SFXWideString::Format("%d年%d月", year, month);

参照

BREW API SPRINTF


SFXWideString::FormatV
可変個引数リストを書式に従った文字列に設定し直します。
[ public, static ]
SFXWideString FormatV(
    SFXWideStringConstRef format   // 書式を表す文字列
    va_list argument               // 可変個引数リスト
);
[ public, static ]
SFXWideString FormatV(
    SFXAnsiStringConstRef format   // 書式を表す文字列
    va_list argument               // 可変個引数リスト
);
[ public, static ]
SFXWideString FormatV(
    WCharConstPtr format   // 書式を表す文字列
    va_list argument       // 可変個引数リスト
);
[ public, static ]
SFXWideString FormatV(
    ACharConstPtr format   // 書式を表す文字列
    va_list argument       // 可変個引数リスト
);

解説

この関数は、指定された可変個引数リストを書式に従った文字列に設定し直します。

書式は C 言語の printf 関数とほぼ同じですが、浮動小数点数の書式は使えません。

[Note] 注意
書式の詳細は、 BREW API SPRINTF を参照してください。

使用例

SFXWideString MyClass::variableArgument(SInt32 arg_num , ...) 
{
    va_list argument;

    va_start(argument, arg_num);
    
    SFXWideString str = SFXAnsiString::FormatV("%d年%d月%d日%d時%d分%d秒、天気は%sです。", argument);
    
    va_end(argument);
   
    return str;

}

SFXWideString str = variableArgument(7, 2007, 7, 17, 17, 37, 50,"雨");
// str = " 2007年7月17日17時37分50秒、天気は雨です。" 

参照

BREW API VSNPRINTF | BREW API SPRINTF


SFXWideString::GetBuffer
この文字列の内部バッファへのポインタを取得します。
[ public ]
WCharPtr GetBuffer(Void);
[ public, const ]
WCharConstPtr GetBuffer(Void);

戻り値

この文字列の内部バッファへのポインタ。 但し、この文字列が空のときは、null が返ります。

解説

この関数は、この文字列の内部バッファへのポインタを取得します。 このポインタを使用して内部バッファへの書き込みが可能です。

文字列が空のときは、null を返します。

[Caution] 注意

この文字列の内部バッファへのポインタが指す位置から SFXWideString::GetLength 関数で得られる長さを超える位置にアクセスしてはいけません。

[Note] GetBuffer 関数と GetCString 関数の差異

この文字列が空の場合、 SFXWideString::GetCString 関数は、"\0" へのポインタを返します。 それに対して、SFXWideString::GetBuffer 関数は null を返します。

SFXWideString::GetCString 関数が返すポインタは const ですので、このポインタを用いて内部バッファへの書き込みはできません。 内部バッファへ書き込むには、SFXWideString::GetBuffer 関数を使用します。

参照

SFXWideString::GetCString | SFXWideString::GetLength


SFXWideString::GetCString
この文字列の内部バッファへの const ポインタを取得します。(内部バッファの内容を変更できません)
[ public, const ]
WCharConstPtr GetCString(Void);

戻り値

この文字列の内部バッファへの const ポインタ

解説

この関数は、この文字列の内部バッファを WCharConstPtr 型( Const 型 )で取得します。 そのため、このポインタを使用して内部バッファへの書き込みはできません。

この文字列が空である場合は、"\0" へのポインタを返します。

[Note] GetBuffer 関数と GetCString 関数の差異

この文字列が空の場合、 SFXWideString::GetCString 関数は、"\0" へのポインタを返します。 それに対して、SFXWideString::GetBuffer 関数は null を返します。

SFXWideString::GetCString 関数が返すポインタは const ですので、このポインタを用いて内部バッファへの書き込みはできません。 内部バッファへ書き込むには、SFXWideString::GetBuffer 関数を使用します。

参照

SFXWideString::GetBuffer


SFXWideString::GetChar
この文字列の指定されたインデックスの位置にある文字を取得します。
[ public, const ]
WChar GetChar(
    SInt32 index   // 取得する文字の位置
);

戻り値

この文字列の内部バッファの指定されたインデックスの文字。 この文字列が空である場合や、 インデックスがこの文字列の範囲外の値である場合、null('\0') が返ります。

解説

この関数は、この文字列の指定されたインデックスの位置にある文字を取得します。

[Caution] 注意

この文字列が空である場合や、 インデックスがこの文字列の範囲外の値である場合、null('\0') が返ります。

参照

SFXWideString::GetBuffer | SFXWideString::SetChar


SFXWideString::GetCluster
この文字列の内部バッファメモリのクラスタサイズを取得します。[単位: バイト]
[ public, const ]
UInt16 GetCluster(Void);

戻り値

この文字列の内部バッファメモリのクラスタサイズ [単位: バイト]

解説

この関数は、この文字列の内部バッファメモリのクラスタサイズを取得します。[単位: バイト]

参照

SFXWideString::SetCluster


SFXWideString::GetLength
この文字列の長さ(文字数)を取得します。
[ public, const ]
SInt32 GetLength(Void);

戻り値

この文字列の長さ(文字数)

解説

この関数は、この文字列の長さ(文字数)を取得します。

[Note] 注意

この文字列内に "\0" が含まれる場合、"\0" も文字数に含まれます。

使用例

SFXWideString str("abc\0abc", 7);
int i;
i = str.GetLengthCString(); // i = 3
i = str.GetLength();        // i = 7

参照

SFXWideString::GetLengthCString | SFXWideString::SetLength


SFXWideString::GetLengthCString
この文字列の先頭の "\0" までの長さ(文字数)を取得します。
[ public, const ]
SInt32 GetLengthCString(Void);

戻り値

この文字列の先頭の "\0" までの長さ(文字数)

解説

この関数は、この文字列の先頭の "\0" までの長さ(文字数)を取得します。

[Note] 注意

先頭の "\0" は、文字数に含まれません。

使用例

SFXWideString str("abc\0abc", 7);
int i;
i = str.GetLengthCString(); // i = 3
i = str.GetLength();        // i = 7

参照

SFXWideString::GetLength


SFXWideString::GetThreshold
この文字列の内部バッファメモリの最小値を取得します。[単位: バイト]
[ public, const ]
UInt16 GetThreshold(Void);

戻り値

この文字列の内部バッファメモリの最小値 [単位: バイト]

解説

この関数は、この文字列の内部バッファメモリの最小値を取得します。[単位: バイト]

参照

SFXWideString::SetThreshold


SFXWideString::Insert
この文字列の指定された位置に指定された文字列や文字を挿入した文字列を取得します。
[ public, const ]
SFXWideString Insert(
    SInt32 index                   // 挿入する位置
    SFXWideStringConstRef string   // 挿入する文字列
);
[ public, const ]
SFXWideString Insert(
    SInt32 index           // 挿入する位置
    WCharConstPtr string   // 挿入する文字列
    SInt32 length = -1     // 挿入する文字列の文字数
);
[ public, const ]
SFXWideString Insert(
    SInt32 index      // 挿入する位置
    WChar character   // 挿入する文字
);

戻り値

この文字列の指定された位置に指定された文字列や文字を挿入した文字列。

解説

この関数は、この文字列の指定された位置に指定された文字列や文字を挿入した文字列を取得します。

index 引数が 0 未満の場合は、0 を指定したことになります。 また、index 引数が文字列の長さより大きい場合は、"文字列の長さ" を指定したことになります。

[Caution] 注意

この文字列の内容は、この操作によって変更されません。


SFXWideString::IsAlpha
この文字列の文字がすべて英文字であるか判定します。
[ public, const ]
Bool IsAlpha(Void);

戻り値

  • すべて英文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて英文字であるか判定します。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsAlpha


SFXWideString::IsAlphaDigit
この文字列の文字がすべて英数字であるか判定します。
[ public, const ]
Bool IsAlphaDigit(Void);

戻り値

  • すべて英数字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて英数字であるか判定します。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsAlphaDigit


SFXWideString::IsAscii
この文字列の文字がすべて ASCII 文字であるか判定します。
[ public, const ]
Bool IsAscii(Void);

戻り値

  • すべて ASCII 文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて ASCII 文字であるか判定します。

[Note] ASCII 文字

ASCII 文字のコードは、 0x00 以上 0x7F 以下 です。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsAscii


SFXWideString::IsControl
この文字列の文字がすべて制御文字であるか判定します。
[ public, const ]
Bool IsControl(Void);

戻り値

  • すべて制御文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて制御文字であるか判定します。

[Note] 制御文字

制御文字のコードは、 0x00 以上 0x20 未満または 0x7E です。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsControl


SFXWideString::IsDigit
この文字列の文字がすべて数字であるか判定します。
[ public, const ]
Bool IsDigit(Void);

戻り値

  • すべて数字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて数字であるか判定します。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsDigit


SFXWideString::IsEmpty
この文字列の長さが 0 であるか(この文字列が空であるか)判定します。
[ public, const ]
Bool IsEmpty(Void);

戻り値

  • この文字列の長さが 0 であるとき(この文字列が空であるとき): true
  • そうでないとき: false

解説

この関数は、この文字列の長さが 0 であるか(この文字列が空であるか)判定します。

参照

SFXWideString::IsEmptyCString | SFXWideString::GetLength


SFXWideString::IsEmptyCString
この文字列の先頭の文字が null 文字('\0')であるか判定します。
[ public, const ]
Bool IsEmptyCString(Void);

戻り値

  • 先頭の文字が null 文字('\0')であるとき: true
  • そうでないとき: false

解説

この関数は、この文字列の先頭の文字が null 文字('\0')であるか判定します。

使用例

SFXWideString str("\0abc", 4);
Bool b;
b = str.IsEmptyCString(); // b = true
b = str.IsEmpty();        // b = false

参照

SFXWideString::IsEmpty | SFXWideString::GetLength


SFXWideString::IsGraph
この文字列の文字がすべて図形文字であるか判定します。
[ public, const ]
Bool IsGraph(Void);

戻り値

  • すべて図形文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて図形文字であるか判定します。

[Note] 図形文字

空白文字(0x20)を除く印字文字です。 印字文字とは、空白文字と制御文字以外の表示できる文字です。

図形文字のコードは、 0x21 以上 0x7E 未満です。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsGraph


SFXWideString::IsHexDigit
この文字列の文字がすべて 16 進数で使う文字であるか判定します。
[ public, const ]
Bool IsHexDigit(Void);

戻り値

  • すべて 16 進数で使う文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて 16 進数で使う文字(数字、または a, b, c, d, e, f, A, B, C, D, E, F)であるか判定します。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsHexDigit


SFXWideString::IsLower
この文字列の文字がすべて小文字であるか判定します。
[ public, const ]
Bool IsLower(Void);

戻り値

  • すべて小文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて小文字であるか判定します。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsLower


SFXWideString::IsNull
この文字列の文字がすべて null 文字('\0')であるか判定します。
[ public, const ]
Bool IsNull(Void);

戻り値

  • すべて null 文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて null 文字('\0')であるか判定します。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsNull


SFXWideString::IsPrint
この文字列の文字がすべて印字可能文字であるか判定します。
[ public, const ]
Bool IsPrint(Void);

戻り値

  • すべて印字可能文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて印字可能文字であるか判定します。

[Note] 印字可能文字

制御文字以外の表示できる文字です。

印字可能文字のコードは、0x20 以上 0x7E 未満です。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsPrint


SFXWideString::IsPunct
この文字列の文字がすべて空白文字・英数字以外の印字可能文字かであるか判定します。
[ public, const ]
Bool IsPunct(Void);

戻り値

  • すべて空白文字か英数字以外の印字可能文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字が空白文字・英数字以外の印字可能文字かであるか判定します(空白文字と英数字は含みません)。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsPunct


SFXWideString::IsSpace
この文字列の文字がすべて空白文字または改行文字であるか判定します。
[ public, const ]
Bool IsSpace(Void);

戻り値

  • すべて空白文字か改行文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて空白文字または改行文字であるか判定します。

[Note] 注意

空白文字または改行文字のコードは、0x09 から 0x0D まで、または 0x20 です。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsSpace


SFXWideString::IsUpper
この文字列の文字がすべて大文字であるか判定します。
[ public, const ]
Bool IsUpper(Void);

戻り値

  • すべて大文字のとき、または空のとき: true
  • そうでないとき: false

解説

この関数は、この文字列の文字がすべて大文字であるか判定します。

[Caution] 注意

この文字列が空の場合は、true が返ります。

参照

SFXAscii::IsUpper


SFXWideString::LastIndexOf
この文字列を末尾から検索して指定された文字列と一致する、最後のインデックスを取得します。
[ public, const ]
SInt32 LastIndexOf(
    SFXWideStringConstRef string    // 検索する文字列
    SInt32 index = SINT32_MAXIMUM   // 検索開始位置
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SInt32 LastIndexOf(
    WCharConstPtr string            // 検索する文字列
    SInt32 index = SINT32_MAXIMUM   // 検索開始位置
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SInt32 LastIndexOf(
    WChar character                 // 検索する文字
    SInt32 index = SINT32_MAXIMUM   // 検索開始位置
    Bool sensitive = true           // 大小文字を区別するか
);

戻り値

  • 成功したとき: 見つかった位置のインデックス
  • 失敗したとき: -1

解説

この関数は、この文字列を末尾から先頭に向かって検索し、指定された文字列が見つかった最後の位置(インデックス)を取得します。

検索開始位置を指定することで、末尾以外の位置から検索できます(先頭のインデックスは 0 です)。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。

参照

SFXWideString::FirstIndexOf


SFXWideString::Mul
この文字列を指定された回数繰り返した文字列にします。
[ public ]
SFCError Mul(
    SInt32 repeat   // 繰り返す回数
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • メモリ不足のとき: SFERR_NO_MEMOERY

解説

この関数は、この文字列を指定された回数繰り返した文字列にします。

この操作により、この文字列の内容は変化します。 変換元の文字列を保持したい場合は、予めコピーする必要があります。

使用例

SFXWideString str("abc");
str.Mul(3); // str = "abcabcabc"

参照

SFXWideString::Add | SFXWideString::Sub | operator* | SFXWideString::operator*=


SFXWideString::Remove
この文字列から指定された範囲の文字列を削除した文字列を取得します。
[ public, const ]
SFXWideString Remove(
    SInt32 begin   // 開始位置(開始位置の文字を含みます)
    SInt32 end     // 終了位置(終了位置の文字は含まれません)
);

戻り値

この文字列から指定された範囲の文字列を削除した文字列

解説

この関数は、 この文字列から指定された範囲の文字列を削除した文字列を取得します。

"begin 引数 ≧ end 引数" の場合は、文字列の削除は行われません。

begin 引数が 0 未満の場合は、0 を指定したことになります。 また、end 引数が文字列の長さより大きい場合は、"文字列の長さ" を指定したことになります。

[Note] 注意
この関数はこの文字列を変更しません。

参照

SFXWideString::Insert


SFXWideString::Replace
この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。
[ public, const ]
SFXWideString Replace(
    SFXWideStringConstRef fstring   // 置換元の文字列
    SFXWideStringConstRef tstring   // 置換先の文字列
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    SFXWideStringConstRef fstring   // 置換元の文字列
    WCharConstPtr tstring           // 置換先の文字列
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    SFXWideStringConstRef fstring   // 置換元の文字列
    WCharConstPtr tstring           // 置換先の文字列
    SInt32 tlength                  // 置換先の文字列の文字数
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WCharConstPtr fstring           // 置換元の文字列
    SFXWideStringConstRef tstring   // 置換先の文字列
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WCharConstPtr fstring           // 置換元の文字列
    SInt32 flength                  // 置換元の文字列の文字数
    SFXWideStringConstRef tstring   // 置換先の文字列
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WCharConstPtr fstring   // 置換元の文字列
    WCharConstPtr tstring   // 置換先の文字列
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WCharConstPtr fstring   // 置換元の文字列
    SInt32 flength          // 置換元の文字列の文字数
    WCharConstPtr tstring   // 置換先の文字列
    SInt32 tlength          // 置換先の文字列の文字数
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    SFXWideStringConstRef fstring   // 置換元の文字列
    WChar tcharacter                // 置換先の文字
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WChar fcharacter                // 置換元の文字
    SFXWideStringConstRef tstring   // 置換先の文字列
    Bool sensitive = true           // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WChar fcharacter        // 置換元の文字
    WChar tcharacter        // 置換先の文字
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WCharConstPtr fstring   // 置換元の文字列
    WChar tcharacter        // 置換先の文字
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WCharConstPtr fstring   // 置換元の文字列
    SInt32 flength          // 置換元の文字列の文字数
    WChar tcharacter        // 置換先の文字
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WChar fcharacter        // 置換元の文字
    WCharConstPtr tstring   // 置換先の文字列
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString Replace(
    WChar fcharacter        // 置換元の文字
    WCharConstPtr tstring   // 置換先の文字列
    SInt32 tlength          // 置換先の文字列の文字数
    Bool sensitive = true   // 大小文字を区別するか
);

戻り値

この文字列内の指定された文字列を指定された文字列で置換した文字列

解説

この関数は、 この文字列内の指定された文字列を指定された文字列で置換した文字列を取得します。

[Note] 注意

flength / tlength 引数には、fstring / tstring 引数に指定した文字列の長さ以下の数字を指定してください。 負の整数を指定した場合は、fstring / tstring 引数に指定した null 終端文字列の長さを指定したことになります。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。
[Note] 注意
この関数はこの文字列を変更しません。

使用例

SFXWideString string("x < y & y < z");
SFXWideString replacestring;

// すべての "<" を "&lt;" に置換する
replacestring = string.Replace("<", "&lt;");

// 元データは変更されない
TRACE("%s", string);  // "x < y & y < z"

TRACE("%s", replacestring);// "&lt;"


SFXWideString::Set
この文字列を指定された文字列、文字、またはバッファで設定します。
[ public ]
SFCError Set(
    SFXWideStringConstRef string   // コピー元の WChar 型文字列
);
[ public ]
SFCError Set(
    SFXAnsiStringConstRef string   // コピー元の AChar 型文字列
);
[ public ]
SFCError Set(
    WCharConstPtr string   // コピー元の WChar ポインタ
    SInt32 length = -1     // 文字列の文字数
);
[ public ]
SFCError Set(
    ACharConstPtr string   // コピー元の AChar ポインタ
    SInt32 length = -1     // 文字列の文字数
);
[ public ]
SFCError Set(
    WChar character   // コピー元の WChar 文字
);
[ public ]
SFCError Set(
    SFXBufferConstRef buffer   // コピー元のバッファ
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • メモリ不足のとき: SFERR_NO_MEMORY

解説

この関数は、この文字列を指定された文字列、文字、またはバッファで設定します。

SFXWideString インスタンス、 または SFXAnsiString インスタンスを指定すると、その文字列をコピーして文字列を設定します。

AChar や WChar のポインタを指定すると、null 終端文字列と解釈します。 また、長さを指定すると複数の null('\0') を含んむ文字列を指定できます。

[Note] 注意

length 引数には、string 引数に指定した文字列の長さ以下の数字を指定してください。 負の整数を指定した場合は、string 引数に指定した null 終端文字列の長さを指定したことになります。

length 引数のデフォルト値は -1 です。

[Caution] 注意

メモリ不足で失敗で失敗した場合、以前の値は保持されます。

参照

SFXWideString::SFXWideString | SFXWideString::operator=


SFXWideString::SetChar
この文字列の指定された位置に指定された文字を設定します。
[ public ]
SFCError SetChar(
    SInt32 index      // 設定する文字の位置
    WChar character   // 設定する文字
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • index 引数がこの文字列の範囲外であるとき: SFERR_INVALID_PARAM

解説

この関数は、この文字列の指定された位置に指定された文字を設定します。

具体的には、この文字列の内部バッファの指定されたインデックスに指定された文字を設定します。

[Note] 注意

内部バッファが空であるとき、 または指定されたインデックスが内部バッファの範囲外であるときは、 SFERR_INVALID_PARAM を返します。

参照

SFXWideString::GetBuffer | SFXWideString::GetChar


SFXWideString::SetCluster
この文字列の内部バッファメモリのクラスタサイズを設定します。[単位: バイト]
[ public ]
Void SetCluster(
    UInt16 size   // 設定するクラスタサイズ
);

解説

この関数は、 この文字列の内部バッファメモリ(SFXClusterHeap)を確保する時の最小単位を設定します。[単位: バイト]

デフォルト値: SFXWideString::DEFAULT_CLUSTER バイト

SFXWideString::DEFAULT_CLUSTER の値は SFXWideString::DefaultEnum を参照してください。

参照

SFXWideString::GetCluster | SFXWideString::DefaultEnum | SFXClusterHeap


SFXWideString::SetLength
この文字列の文字数を設定します。
[ public ]
SFCError SetLength(
    SInt32 length   // 設定する文字数
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • メモリ不足のとき: SFERR_NO_MEMORY

解説

この関数は、この文字列の文字数を設定します。

元の文字列より短く文字数を設定すると、指定された文字数以降の文字は失われます。 長く設定すると、拡張された部分は null('\0') になります。

参照

SFXWideString::GetLength | SFXWideString::GetLengthCString


SFXWideString::SetThreshold
この文字列の内部バッファメモリの最小値を設定します。[単位: バイト]
[ public ]
Void SetThreshold(
    UInt16 size   // 設定する最小値 [単位: バイト]
);

解説

この関数は、 この文字列の内部バッファメモリ(SFXClusterHeap)の最小値を設定します。[単位: バイト]

デフォルト値: SFXWideString::DEFAULT_THRESHOLD バイト

SFXWideString::DEFAULT_THRESHOLD の値は SFXWideString::DefaultEnum を参照してください。

参照

SFXWideString::GetThreshold | SFXWideString::DefaultEnum | SFXClusterHeap::SetThreshold | SFXClusterHeap


SFXWideString::StartsWith
この文字列が指定された文字列で始まるか判定します。
[ public, const ]
Bool StartsWith(
    SFXWideStringConstRef string   // 調べる文字列
    Bool sensitive = true          // 大小文字を区別するか
);
[ public, const ]
Bool StartsWith(
    WCharConstPtr string    // 調べる文字列
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
Bool StartsWith(
    WChar character         // 調べる文字
    Bool sensitive = true   // 大小文字を区別するか
);

戻り値

  • 指定された文字列で始まるとき: true
  • そうでないとき: false

解説

この関数は、この文字列が指定された文字列で始まるか判定します。

参照

SFXWideString::EndsWith


SFXWideString::Sub
この文字列の末尾から指定された文字列を削除します。
[ public ]
SFCError Sub(
    SFXWideStringConstRef string   // 末尾から削除する文字列
);
[ public ]
SFCError Sub(
    WCharConstPtr string   // 末尾から削除する文字列
    SInt32 length = -1     // 文字列の文字数
);
[ public ]
SFCError Sub(
    WChar character   // 末尾から削除する文字
);

戻り値

  • 成功したとき: SFERR_NO_ERROR
  • メモリ不足のとき: SFERR_NO_MEMORY

解説

この関数は、この文字列の末尾から指定された文字列を削除します。

指定された文字列が末尾にある場合、末尾の文字列を削除します。 末尾に存在しない場合は何も行いません。

WChar のポインタを指定すると、null 終端文字列と解釈します。 また、長さを指定すると複数の null('\0') を含んむ文字列を指定できます。

[Note] 注意

length 引数には、string 引数に指定した文字列の長さ以下の数字を指定してください。 負の整数を指定した場合は、string 引数に指定した null 終端文字列の長さを指定したことになります。

length 引数のデフォルト値は -1 です。

[Tip] Tip

この関数は文字列に影響を及ぼします。 元の文字列を保持したい場合は、operator- オペレーターを使います。

参照

SFXWideString::operator-= | operator- | operator+


SFXWideString::Substring
この文字列の指定された範囲の文字列(部分文字列)を取得します。
[ public, const ]
SFXWideString Substring(
    SInt32 begin   // 開始インデックス (この位置を含む)
    SInt32 end     // 終了インデックス (この位置を含まない)
);

戻り値

この文字列の指定された範囲の文字列(部分文字列)

解説

この関数は、この文字列の指定された範囲の文字列(部分文字列)を取得します。

begin + 1 文字目から end 文字目までの部分文字列を返します。 文字列の長さは end - begin です。

"begin 引数 ≧ end 引数" の場合は、空文字列を返します。

begin 引数が 0 未満の場合は、0 を指定したことになります。 また、end 引数が文字列の長さより大きい場合は、"文字列の長さ" を指定したことになります。

[Note] 注意
この関数はこの文字列を変更しません。

使用例

SFXWideString str1("American");
SFXWideString str2 = str1.Substring(2, 6);  // str2 = "eric"

SFXWideString::ToLower
この文字列を小文字に変換します。
[ public ]
Void ToLower(Void);

解説

この関数は、この文字列を小文字に変換します。

[Note] 注意
この関数は文字列に影響を及ぼします。 元の文字列を保持したい場合は、SFXWideString::AsLower 関数を使います。

参照

SFXWideString::ToUpper | SFXWideString::AsLower


SFXWideString::ToUpper
この文字列を大文字に変換します。
[ public ]
Void ToUpper(Void);

解説

この関数は、この文字列を大文字に変換します。

[Note] 注意
この関数は文字列に影響を及ぼします。 元の文字列を保持したい場合は、SFXWideString::AsUpper 関数を使います。

参照

SFXWideString::ToLower | SFXWideString::AsUpper


SFXWideString::Trim
この文字列の先頭と末尾から空白や指定された文字または文字列を削除した文字列を取得します。
[ public, const ]
SFXWideString Trim(
    SFXWideStringConstRef string   // 削除する文字列
    Bool sensitive = true          // 大小文字を区別するか
);
[ public, const ]
SFXWideString Trim(
    WCharConstPtr string    // 削除する文字列
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString Trim(
    WChar character         // 削除する文字
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString Trim(Void);

戻り値

この文字列の先頭と末尾から空白や指定された文字または文字列を削除した文字列

解説

この関数は、 この文字列の先頭と末尾から空白や指定された文字または文字列を削除した文字列を取得します。

引数を指定しなかった場合は、この 文字列の先頭と末尾から空白(スペース、タブ、垂直タブ、改行、復帰、フォームフィード)が削除されます。

引数を指定した場合は、 この文字列の先頭と末尾から指定した文字または文字列が削除されます。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。
[Tip] Tip
元の文字列は変更されません。

使用例

SFXWideString str1("\t delicious beef ");
SFXWideString str2 = str1.Trim();        // str2 = "delicious beef" 
SFXWideString str3 = str2.Trim("adef");  // str3 = "licious b"

参照

SFXWideString::TrimLeft | SFXWideString::TrimRight


SFXWideString::TrimLeft
この文字列の先頭から空白や指定された文字または文字列を削除した文字列を取得します。
[ public, const ]
SFXWideString TrimLeft(
    SFXWideStringConstRef string   // 削除する文字
    Bool sensitive = true          // 大小文字を区別するか
);
[ public, const ]
SFXWideString TrimLeft(
    ACharConstPtr string    // 削除する文字
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString TrimLeft(
    AChar character         // 削除する文字
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString TrimLeft(Void);

戻り値

この文字列の先頭から空白や指定された文字または文字列を削除した文字列

解説

この関数は、 この文字列の先頭から空白や指定された文字または文字列を削除した文字列を取得します。

引数を指定しなかった場合は、この 文字列の先頭から空白(スペース、タブ、垂直タブ、改行、復帰、フォームフィード)が削除されます。

引数を指定した場合は、 この文字列の先頭から指定した文字または文字列が削除されます。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。
[Tip] Tip
元の文字列は変更されません。

使用例

SFXWideString str1("\t delicious beef ");
SFXWideString str2 = str1.TrimLeft();        // str2 = "delicious beef "
SFXWideString str3 = str2.TrimLeft("adef");  // str3 = "licious beef "

参照

SFXWideString::Trim | SFXWideString::TrimRight


SFXWideString::TrimRight
この文字列の末尾から空白や指定された文字または文字列を削除した文字列を取得します。
[ public, const ]
SFXWideString TrimRight(
    SFXWideStringConstRef string   // 削除する文字
    Bool sensitive = true          // 大小文字を区別するか
);
[ public, const ]
SFXWideString TrimRight(
    ACharConstPtr string    // 削除する文字
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString TrimRight(
    AChar character         // 削除する文字
    Bool sensitive = true   // 大小文字を区別するか
);
[ public, const ]
SFXWideString TrimRight(Void);

戻り値

この文字列の末尾から空白や指定された文字または文字列を削除した文字列

解説

この関数は、 この文字列の末尾から空白や指定された文字または文字列を削除した文字列を取得します。

引数を指定しなかった場合は、この 文字列の末尾から空白(スペース、タブ、垂直タブ、改行、復帰、フォームフィード)が削除されます。

引数を指定した場合は、 この文字列の末尾から指定した文字または文字列が削除されます。

[Tip] Tip
比較時に大文字・小文字の区別をするかどうかを、sensitive 引数に指定することができます。
[Tip] Tip
元の文字列は変更されません。

使用例

SFXWideString str1("\t delicious beef ");
SFXWideString str2 = str1.TrimRight();        // str2 = "\t delicious beef"
SFXWideString str3 = str2.TrimRight("adef");  // str3 = "\t delicious b"

参照

SFXWideString::Trim | SFXWideString::TrimLeft


SFXWideString::Truncate
この文字列の先頭の null('\0') 文字までの文字列を取得します。
[ public, const ]
SFXWideString Truncate(Void);

戻り値

この文字列の先頭の null('\0') 文字までの文字列

解説

この関数は、 この文字列の先頭の null('\0') 文字までの文字列を取得します。

[Tip] Tip
元の文字列は変更されません。

使用例

SFXWideString str1("abc\0abc", 7);
SFXWideString str2 = str1.Truncate(); // str2 = "abc"

SFXWideString::operator=
左側の文字列に右側の文字列を代入します。
[ public ]
SFXWideStringRef operator=(
    SFXWideStringConstRef string   // コピー元の WChar 型文字列
);
[ public ]
SFXWideStringRef operator=(
    SFXAnsiStringConstRef string   // コピー元の AChar 型文字列
);
[ public ]
SFXWideStringRef operator=(
    WCharConstPtr string   // コピー元の WChar ポインタ
);
[ public ]
SFXWideStringRef operator=(
    ACharConstPtr string   // コピー元の AChar ポインタ
);

戻り値

代入後の左側の文字列

解説

このオペレーターは、左側の文字列に右側の文字列を代入します。

SFXWideString インスタンス、 または SFXAnsiString インスタンスを指定すると、その文字列をコピーしてこの文字列に代入します。

AChar や WChar のポインタを指定すると、null 終端文字列と解釈します。

[Note] 注意

このオペレーターは左側の文字列に影響を及ぼします。

参照

SFXWideString::Set


operator==
左側の文字列が右側の文字列と等しいか判定します。
[ public, friend ]
Bool operator==(
    SFXWideStringConstRef left    // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator==(
    SFXWideStringConstRef left    // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator==(
    SFXWideStringConstRef left   // 左側の文字列
    WCharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator==(
    SFXWideStringConstRef left   // 左側の文字列
    ACharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator==(
    WCharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator==(
    ACharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);

戻り値

  • 等しいとき: true
  • そうでないとき: false

解説

このオペレーターは、左側の文字列が右側の文字列と等しいか判定します。

参照

SFXWideString::Equals | operator!=


operator>=
左側の文字列が右側の文字列以上であるか判定します。
[ public, friend ]
Bool operator>=(
    SFXWideStringConstRef left    // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator>=(
    SFXWideStringConstRef left    // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator>=(
    SFXWideStringConstRef left   // 左側の文字列
    WCharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator>=(
    SFXWideStringConstRef left   // 左側の文字列
    ACharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator>=(
    WCharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator>=(
    ACharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);

戻り値

  • 左側の文字列が右側の文字列以上であるとき: true
  • そうでないとき: false

解説

このオペレーターは、左側の文字列が右側の文字列以上であるか判定します。

参照

SFXWideString::Compare | operator> | operator< | operator<=


operator>
左側の文字列が右側の文字列よりも大きいか判定します。
[ public, friend ]
Bool operator>(
    SFXWideStringConstRef left    // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator>(
    SFXWideStringConstRef left    // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator>(
    SFXWideStringConstRef left   // 左側の文字列
    WCharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator>(
    SFXWideStringConstRef left   // 左側の文字列
    ACharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator>(
    WCharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator>(
    ACharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);

戻り値

  • 左側の文字列が右側の文字列よりも大きいとき: true
  • そうでないとき: false

解説

このオペレーターは、左側の文字列が右側の文字列よりも大きいか判定します。

参照

SFXWideString::Compare | operator>= | operator< | operator<=


SFXWideString::operator[]
この文字列内の指定されたインデックス位置にある文字を取得します。
[ public ]
WCharRef operator[](
    SInt32 index   // インデックス位置
);
[ public, const ]
WCharConstRef operator[](
    SInt32 index   // インデックス位置
);

戻り値

この文字列内の指定されたインデックス位置にある文字

解説

このオペレーターは、この文字列内の指定されたインデックス位置にある文字を取得します。

[Caution] 注意

この文字列が空である場合や、 指定されたインデックス位置がこの文字列の範囲外の値である場合、null('\0') が返ります。

参照

SFXWideString::GetChar


SFXWideString::operator<<
左側の文字列の末尾に右側の文字列を追加します。
[ public, friend ]
SFXWideStringRef operator<<(
    SFXWideStringRef left         // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideStringRef operator<<(
    SFXWideStringRef left         // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideStringRef operator<<(
    SFXWideStringRef left   // 左側の文字列
    WCharConstPtr right     // 右側の文字列
);
[ public, friend ]
SFXWideStringRef operator<<(
    SFXWideStringRef left   // 左側の文字列
    ACharConstPtr right     // 右側の文字列
);
[ public, friend ]
SFXWideStringRef operator<<(
    SFXWideStringRef left   // 左側の文字列
    WChar right             // 右側の文字列(文字)
);

戻り値

追加後の左側の文字列

解説

このオペレーターは、左側の文字列の末尾に右側の文字列を追加します。

[Tip] Tip

このオペレーターは左側の文字列に影響を及ぼします。

複数の文字列を結合するとき、このオペレーター(<<)は便利です。

使用例

SFXWideString str = "abc";
str << "def" << "ghi"; // str = "abcdefghi"

参照

SFXWideString::Add | SFXWideString::operator+=


operator<=
左側の文字列が右側の文字列以下であるか判定します。
[ public, friend ]
Bool operator<=(
    SFXWideStringConstRef left    // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator<=(
    SFXWideStringConstRef left    // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator<=(
    SFXWideStringConstRef left   // 左側の文字列
    WCharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator<=(
    SFXWideStringConstRef left   // 左側の文字列
    ACharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator<=(
    WCharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator<=(
    ACharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);

戻り値

  • 左側の文字列が右側の文字列以下であるとき: true
  • そうでないとき: false

解説

このオペレーターは、左側の文字列が右側の文字列以下であるか判定します。

参照

SFXWideString::Compare | operator> | operator>= | operator<


operator<
左側の文字列が右側の文字列よりも小さいか判定します。
[ public, friend ]
Bool operator<(
    SFXWideStringConstRef left    // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator<(
    SFXWideStringConstRef left    // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator<(
    SFXWideStringConstRef left   // 左側の文字列
    WCharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator<(
    SFXWideStringConstRef left   // 左側の文字列
    ACharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator<(
    WCharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator<(
    ACharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);

戻り値

  • 左側の文字列が右側の文字列よりも小さいとき: true
  • そうでないとき: false

解説

このオペレーターは、左側の文字列が右側の文字列よりも小さいか判定します。

参照

SFXWideString::Compare | operator<= | operator> | operator>=


SFXWideString::operator-=
左側の文字列の末尾から右側の文字列を削除します。
[ public ]
SFXWideStringRef operator-=(
    SFXWideStringConstRef string   // 右側の文字列
);
[ public ]
SFXWideStringRef operator-=(
    WCharConstPtr string   // 右側の文字列
);
[ public ]
SFXWideStringRef operator-=(
    WChar character   // 右側の文字列(文字)
);

戻り値

左側の文字列の末尾から右側の文字列を削除した後の左側の文字列

解説

このオペレーターは、 左側の文字列の末尾に右側の文字列がある場合、 左側の文字列の末尾から右側の文字列を削除します。

存在しない場合は、 何もしません。

[Note] 注意

このオペレーターは左側の文字列に影響を及ぼします。

参照

SFXWideString::Sub | operator-


operator-
左側の文字列の末尾から右側の文字列を削除した文字列を返します。
[ public, friend ]
SFXWideString operator-(
    SFXWideStringConstRef left    // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideString operator-(
    SFXWideStringConstRef left    // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideString operator-(
    SFXWideStringConstRef left   // 左側の文字列
    WCharConstPtr right          // 右側の文字列
);
[ public, friend ]
SFXWideString operator-(
    SFXWideStringConstRef left   // 左側の文字列
    ACharConstPtr right          // 右側の文字列
);
[ public, friend ]
SFXWideString operator-(
    WCharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideString operator-(
    ACharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideString operator-(
    SFXWideStringConstRef left   // 左側の文字列
    WChar right                  // 右側の文字列(文字)
);
[ public, friend ]
SFXWideString operator-(
    WChar left                    // 左側の文字列(文字)
    SFXWideStringConstRef right   // 右側の文字列
);

戻り値

左側の文字列の末尾から右側の文字列を削除した文字列

解説

このオペレーターは、 左側の文字列の末尾から右側の文字列を削除した文字列をコピーして返します。

左側の文字列の末尾に右側の文字列が存在しない場合は、 何もせずに左側の文字列をコピーして返します。

[Note] 注意

このオペレーターは左側の文字列に影響を及ぼしません。

使用例

SFXWideString str1("Hello World");
SFXWideString str2(" World");
SFXWideString str3 = str1 - str2;   // str3 = "Hello"

参照

SFXWideString::Sub | SFXWideString::operator-=


SFXWideString::operator*=
左側の文字列を右側の回数だけ繰り返した文字列にします。
[ public ]
SFXWideStringRef operator*=(
    SInt32 repeat   // 右側の回数
);

戻り値

左側の文字列を右側の回数だけ繰り返した後の左側の文字列

解説

このオペレーターは、 左側の文字列を右側の回数だけ繰り返した文字列にします。

[Note] 注意

このオペレーターは左側の文字列に影響を及ぼします。

参照

SFXWideString::Mul | operator*


operator*
左側の文字列を右側の回数だけ繰り返した文字列を返します。
[ public, friend ]
SFXWideString operator*(
    SFXWideStringConstRef left   // 左側の文字列
    SInt32 right                 // 右側の回数
);

戻り値

左側の文字列を右側の回数だけ繰り返した文字列

解説

このオペレーターは、 左側の文字列を右側の回数だけ繰り返した文字列をコピーして返します。

[Note] 注意

このオペレーターは左側の文字列に影響を及ぼしません。

参照

SFXWideString::Mul | SFXWideString::operator*=


operator!=
左側の文字列が右側の文字列と異なるか判定します。
[ public, friend ]
Bool operator!=(
    SFXWideStringConstRef left    // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator!=(
    SFXWideStringConstRef left    // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator!=(
    SFXWideStringConstRef left   // 左側の文字列
    WCharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator!=(
    SFXWideStringConstRef left   // 左側の文字列
    ACharConstPtr right          // 右側の文字列
);
[ public, friend ]
Bool operator!=(
    WCharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
Bool operator!=(
    ACharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);

戻り値

  • 異なるとき: true
  • そうでないとき: false

解説

このオペレーターは、左側の文字列が右側の文字列と異なるか判定します。

参照

SFXWideString::Equals | operator==


SFXWideString::operator+=
左側の文字列の末尾に右側の文字列を追加します。
[ public ]
SFXWideStringRef operator+=(
    SFXWideStringConstRef string   // 右側の文字列
);
[ public ]
SFXWideStringRef operator+=(
    WCharConstPtr string   // 右側の文字列
);
[ public ]
SFXWideStringRef operator+=(
    WChar character   // 右側の文字列(文字)
);

戻り値

末尾に右側の文字列を追加した左側の文字列

解説

このオペレーターは、 左側の文字列の末尾に右側の文字列を追加します。

[Note] 注意

このオペレーターは左側の文字列に影響を及ぼします。

参照

SFXWideString::Add | operator+ | SFXWideString::operator<<


operator+
左側の文字列の末尾に右側の文字列を追加した文字列を返します。
[ public, friend ]
SFXWideString operator+(
    SFXWideStringConstRef left    // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideString operator+(
    SFXWideStringConstRef left    // 左側の文字列
    SFXAnsiStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideString operator+(
    SFXWideStringConstRef left   // 左側の文字列
    WCharConstPtr right          // 右側の文字列
);
[ public, friend ]
SFXWideString operator+(
    SFXWideStringConstRef left   // 左側の文字列
    ACharConstPtr right          // 右側の文字列
);
[ public, friend ]
SFXWideString operator+(
    WCharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideString operator+(
    ACharConstPtr left            // 左側の文字列
    SFXWideStringConstRef right   // 右側の文字列
);
[ public, friend ]
SFXWideString operator+(
    SFXWideStringConstRef left   // 左側の文字列
    WChar right                  // 右側の文字列(文字)
);
[ public, friend ]
SFXWideString operator+(
    WChar left                    // 左側の文字列(文字)
    SFXWideStringConstRef right   // 右側の文字列(文字)
);

戻り値

左側の文字列の末尾に右側の文字列を追加した文字列

解説

このオペレーターは、 左側の文字列の末尾に右側の文字列を追加した文字列をコピーして返します。

[Note] 注意

このオペレーターは左側の文字列に影響を及ぼしません。

参照

SFXWideString::Add | SFXWideString::operator+=


SFXWideString::DefaultEnum
内部バッファメモリの最小値とクラスタサイズのデフォルト値を表します。[単位: バイト]
enum DefaultEnum {
    DEFAULT_THRESHOLD = 4 * sizeof(WChar),    // 内部バッファメモリの最小値 [単位: バイト]
    DEFAULT_CLUSTER   = 8 * sizeof(WChar)     // 内部バッファメモリのクラスタサイズ(メモリ確保の最小単位) [単位: バイト]
};

解説

DEFAULT_THRESHOLD と DEFAULT_CLUSTER は、 内部バッファメモリ(SFXClusterHeap)の最小値とクラスタサイズのデフォルト値を表します。[単位: バイト]

参照

SFXWideString::SetCluster | SFXWideString::SetThreshold | SFXClusterHeap