例 11.31. SFXAnsiString::GetBuffer と SFXAnsiString::GetCString の動作の違い

SFXAnsiString str;

// null を返すのでエラーが起こる
TRACE("%s", str.GetBuffer());

// '\0' を指すポインタを返すので正しく動作する
TRACE("%s", str.GetCString());

例 11.32. 複数の '\0' を含む文字列の処理

// 第 2 引数で文字列の長さを設定しない場合は "abc" だけが登録される
SFXAnsiString string("abc\0abc\0\0abc", 12);

SInt32 i = string.GetLength();          // i = 12
SInt32 j = string.GetLengthCString();   // j = 3

// nullstring1 は、文字を何も含まない長さ 0 の文字列
SFXAnsiString nullstring1;

Bool x = nullstring1.IsEmpty();         // x = true
Bool y = nullstring1.IsEmptyCString();  // y = true

// nullstring2 は、'\0' だけを含む文字列
SFXAnsiString nullstring2("\0", 1);

Bool x = nullstring2.IsEmpty();         // x = false
Bool y = nullstring2.IsEmptyCString();  // y = true

例 11.33. Attach 関数の使い方

SFXAnsiString string;
ACharPtr char_ptr;

char_ptr = static_cast<ACharPtr>(MemoryAllocate(10240)); // メモリを確保する

// char_ptr を使う処理

// char_ptr に確保したメモリを string オブジェクトに委譲する
string.Attach(char_ptr, 10240);

// char_ptr を明示的に解放してはいけない

// Attach 関数を使わない場合
// string.Set(char_ptr, 10240); // char_ptr の中身がコピーされるので、スピードは遅くなることに注意が必要

	注意
	string オブジェクトに委譲した char_ptr のメモリは、 MemoryFree 関数を呼び出して解放してはいけません。 メモリの解放権は、string オブジェクトが持ちます。

例 11.34. Detach 関数の使い方

SFXAnsiString string;
ACharPtr char_ptr;
SInt32 length;

string = "The best application for BREW.";

// string を使う処理

// string オブジェクトの内部バッファの解放権を char_ptr に渡す
char_ptr = string.Detach(&length);

// char_ptr のサイズを表示する
TRACE("%d", length);

// char_ptr を使う処理

// 必ず char_ptr を解放する
MemoryFree(char_ptr);

	注意
	string オブジェクトから返却された char_ptr のメモリは、 明示的に MemoryFree 関数を呼び出して解放しなければいけません。 メモリの解放権は、char_ptr オブジェクトが持ちます。