協調図

解説

SFXAnsiString と SFXWideString

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

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

文字列を空にする方法

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

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

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

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

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

SFXAnsiString str = "The best C++ Programming Environment for BREW";

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

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

SFXAnsiString str = "The best C++ Programming Environment for BREW";

str.Clear();

// ヒープは解放される

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

SFXAnsiString str;

str = "BREW";
...
str.SetLength(0);
...
str = "C++";
...
str.SetLength(0);
...
str = "GUI";
...
str.SetLength(0);
...
str = "XML";
...

Attach 関数 と Detach 関数

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

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

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

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

SFXAnsiString str;
ACharPtr ptr;

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

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

･･･

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

SFXAnsiString str;
ACharPtr ptr;
SInt32 length;

str = "The best application for BREW.";

...

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

...

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

AttachSFXBuffer 関数 と DetachSFXBuffer 関数

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

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

参照

SFXWideString | SFXBuffer

メンバ

解説

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

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

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

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

参照

SFXAnsiString::Set | SFXAnsiString::operator=

解説

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

戻り値

解説

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

参照

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

解説

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

参照

SFXAnsiString::AsUpper | SFXAnsiString::ToLower

解説

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

参照

SFXAnsiString::AsUInt32

解説

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

参照

SFXAnsiString::AsSInt32

解説

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

参照

SFXAnsiString::AsLower | SFXAnsiString::ToUpper

戻り値

解説

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

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

使用例

SFXAnsiString str;
ACharPtr ptr;

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

...

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

･･･

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

参照

SFXAnsiString::Detach

戻り値

解説

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

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

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

使用例

SFXAnsiString str;
SFXBuffer buffer;

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

...

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

･･･

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

参照

SFXAnsiString::Attach | SFXAnsiString::Detach | SFXAnsiString::DetachSFXBuffer

解説

ヒープを解放します。

戻り値

参照

SFXAnsiString::Equals | operator== | operator!=

戻り値

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

解説

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

参照

SFXAnsiString::Add | operator+ | SFXAnsiString::operator+=

戻り値

解説

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

戻り値

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

解説

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

使用例

SFXAnsiString str;
ACharPtr ptr;
SInt32 length;

str = "The best application for BREW.";

...

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

...

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

参照

SFXAnsiString::Attach

戻り値

解説

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

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

使用例

SFXAnsiString str;
SFXBuffer buffer;

str = "The best application for BREW.";

...

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

･･･

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

参照

SFXAnsiString::Detach | SFXAnsiString::AttachSFXBuffer | SFXAnsiString::Attach

解説

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

戻り値

参照

SFXAnsiString::StartsWith

戻り値

参照

SFXAnsiString::Compare | operator== | operator!=

戻り値

解説

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

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

参照

SFXAnsiString::LastIndexOf

解説

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

使用例

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

参照

BREW API VSNPRINTF

解説

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

使用例

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

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

}

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

参照