協調図

解説

SFXAnsiString と SFXWideString

BREW には、シングルバイト文字またはマルチバイト文字を表す char 型と、 BREW 独自の 2 バイト文字を表す AECHAR 型があります。 SophiaFramewok では、これら 2 種類の文字型をそれぞれ AChar 型、WChar 型として定義しています。

文字列を表すクラスには、AChar 型の文字で構成される SFXAnsiString と、 WChar 型の文字で構成される SFXWideString の 2 種類があります。

文字列を空にする方法

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

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

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

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

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

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

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

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

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

str.Clear();

// ヒープは解放される

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

SFXWideString str;

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

Attach 関数 と Detach 関数

SFXWideString::Attach 関数は、WChar 型文字列の動作と管理権限を SFXWideString クラスのインスタンスにデリゲート(委譲)します。 そのため、WChar 型文字列のメモリを解放する必要がなくなります。 SFXWideString::Detach 関数はその逆の操作を行います。

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

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

デリゲートとは : オブジェクト指向プログラミングにおいて、あるオブジェクトの振る舞いを別のオブジェクトに肩代わりして振る舞ってもらうことです。 日本語では、「委譲」と訳されます。

SFXWideString str;
WCharPtr ptr;

// メモリを割り当て、WChar 型文字列にキャストする
ptr = static_cast<WCharPtr>(MemoryAllocate(10240)); 

...

// WChar 型文字列 ptr の動作と管理権限を SFXWideString クラスのインスタンス str にデリゲートする
str.Attach(ptr, 10240);
// 以降、WChar 型文字列 ptr を SFXWideString クラスのインスタンス str として操作できる

･･･

// 使用後、割り当てたメモリは自動的に解放される 

SFXWideString str;
WCharPtr ptr;
SInt32 length;

str = "BREW  C++ プログラミング環境";

...

// SFXWideString クラスのインスタンス str の動作と管理権限を WChar 型文字列 ptr にデリゲートする
ptr = str.Detach(&length);
// 以降、SFXWideString クラスのインスタンス を WChar 型文字列 ptr として操作する

...

// 使用後、WChar 型文字列 ptr のメモリを解放する必要がある
MemoryFree(ptr);

AttachSFXBuffer 関数 と DetachSFXBuffer 関数

SFXWideString と SFXBuffer のクラスのインスタンス間で動作と管理権限をデリゲート(委譲)するときに使います。

関連情報 : Attach 関数 と Detach 関数

参照

SFXAnsiString | SFXBuffer

メンバ

解説

SFXWideString クラスのコンストラクタに SFXWideString クラス、または SFXAnsiString クラスを指定すると、 その文字列をコピーします。

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

長さを指定すると null を含んだバイナリ文字列を処理できます。

WChar を指定すると、1 文字だけを作成します。

参照

SFXWideString::Set | SFXWideString::operator=

解説

内部の文字列バッファは解放されます。

戻り値

解説

SFXWideString::Add 関数は文字列に影響を及ぼします。 変換元の文字列を保持しておく場合は、SFXWideString::Concat 関数を使います。

参照

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

解説

SFXWideString::AsLower 関数を呼び出しても、元の文字列は変化しません。

参照

SFXWideString::AsUpper | SFXWideString::ToLower

解説

変換できなかった場合は substitute に指定した値を返します。

参照

SFXWideString::AsUInt32

解説

変換できなかった場合は substitute に指定した値を返します。

参照

SFXWideString::AsSInt32

解説

SFXWideString::AsUpper 関数を呼び出しても、元の文字列は変化しません。

参照

SFXWideString::AsLower | SFXWideString::ToUpper

戻り値

解説

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

文字列に割り当てられたメモリは、SFXWideString クラスの文字列が解放されると自動的に解放されます。 文字列に割り当てられたメモリを明示的に解放するには、SFXWideString::Detach 関数を呼び出す必要があります。

使用例

  
SFXWideString str;
WCharPtr ptr;

// メモリを割り当て、WChar 型文字列にキャストする
ptr = static_cast<WCharPtr>(MemoryAllocate(10240)); 

...

// WChar 型文字列 ptr の動作と管理権限を SFXWideString クラスの文字列 str にデリゲートする
str.Attach(ptr, 10240);
// 以降、WChar 型文字列 ptr を SFXWideString クラスの文字列 str として操作できる

･･･

// 使用後、割り当てたメモリは自動的に解放される 

参照

SFXWideString::Detach

戻り値

解説

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

SFXBuffer クラスのバッファーは、SFXWideString クラスの文字列が解放されると自動的に解放されます。 SFXBuffer クラスのバッファーを明示的に解放するには、SFXWideString::DetachSFXBuffer 関数を呼び出す必要があります。

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

使用例

SFXWideString str;
SFXBuffer buffer;

// SFXBuffer クラスのバッファー buffer にメモリを割り当てる
buffer.SetSize(10240); 

...

// SFXBuffer クラスのバッファー buffer の動作と管理権限を SFWideString クラスの文字列 str にデリゲートする
str.AttachSFXBuffer(&buffer);
// 以降、SFXBuffer クラスのバッファー buffer 型文字列 ptr を SFXWideString クラスの文字列 str として操作できる

･･･

// 使用後、割り当てたメモリは自動的に解放される 

参照

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

解説

ヒープを解放します。

戻り値

参照

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

戻り値

連結後の文字列を返します。

解説

SFXWideString::Concat 関数は現在の文字列の最後に、指定した文字列を連結して返します。 元の文字列は変更されません。

参照

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

戻り値

解説

上書きする文字列が元の文字列の終端を越える場合は SFERR_INVALID_PARAM を返し、コピーは行われません。

戻り値

委譲先が WChar 型文字列である場合、SFXWideString クラスが持っている WChar 型文字列を返します。 それ以外の場合は SFCError 型データ値。

解説

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

使用例

SFXWideString str;
WCharPtr ptr;
SInt32 length;

str = "BREW  C++ プログラミング環境";

...

// SFXWideString クラスの文字列 str の動作と管理権限を WChar 型の文字列 ptr にデリゲートする
ptr = str.Detach(&length);
// 以降、SFXWideString クラスの文字列 を WChar 型の文字列 ptr として操作する

...

// 使用後、WChar 型文字列 ptr のメモリを解放する必要がある
MemoryFree(ptr);

参照

SFXWideString::Attach

戻り値

解説

SFXWideString クラスの文字列はコピーされないので、大容量の文字列データ処理時のパフォーマンス劣化やメモリ不足の問題を回避できます。

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

使用例

SFXWideString str;
SFXBuffer buffer;

str = "BREW  C++ プログラミング環境";

...

// SFXWideString クラスの文字列 str の動作と管理権限を SFXBuffer クラスのバッファー buffer にデリゲートする
str.DetachSFXBuffer(&buffer);  
// 以降、SFXWideString クラスの文字列 str を SFXBuffer クラスのバッファー buffer として操作する

･･･

// 使用後、SFXBuffer クラスのバッファー buffer は自動的に解放される

参照

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

解説

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

戻り値

参照

SFXWideString::StartsWith

戻り値

参照

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

戻り値

解説

文字列を先頭から末尾に向かって検索し、最初に見つかった位置のインデックスを取得します。

検索開始位置を指定することで、先頭以外の位置から検索できます。

参照

SFXWideString::LastIndexOf

解説

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

使用例

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

参照

BREW API VSNPRINTF

解説

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

使用例

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秒、天気は雨です。"