例 17.1. 読み込む文字列: "/dir/data.txt"

61 62 63 64 00 65 66 67 68 00 69 6A 6B 6C  // HEX 形式(16 進数表示)

例 17.2. 文字列ストリームから文字列クラスへの読み込み

// *** 以下のコードでは、エラー処理が省略されています。 
SFXFile file;                     // ファイル
SFXAnsiStringStreamReader reader; // ファイル読み込み用文字列ストリーム
SFXAnsiString string;             // 読み込む文字列

// 読み込みモードでファイルを開く
file.OpenReadOnly(SFXPath("/dir/data.txt"));

// ファイル読み込み用文字列ストリームを取得する
// ※ size 引数を指定していないのでストリームバッファは可変長
file.GetStreamReader(&reader);

// ファイルからストリームバッファにデータを読み込む
// ※1. 読み込んだデータのサイズに合わせてストリームバッファは自動的に拡張される
// ※2. 可変長バッファストリームの場合、1 回の Fetch 関数呼び出しで読み込みは完了する
reader.Fetch();

// ストリームバッファから string 変数にデータを読み込む
reader >> string; // '\0' までのデータを文字列として取得する  string ＝ "abcd"
reader >> string; // 次の '\0' までを取得する                 string ＝ "efgh"
reader >> string; // 末尾までを取得する                       string ＝ "ijkl"
reader >> string; // 末尾までを取得する                       string ＝ 空

// ファイル読み込み用文字列ストリームを解放する
reader.Release();

// ファイルを閉じる
file.Close();

例 17.3. '\0' を書き込む方法

writer << ends; // ストリームに '\0' を書き込む

例 17.4. 文字列ストリームへの文字列クラスの書き込み

// *** 以下のコードでは、エラー処理が省略されています。 
SFXFile file;                            // ファイル
SFXAnsiStringStreamWriter writer;        // ファイル書き込み用文字列ストリーム
SFXAnsiString string("abcd");  // 書き込む文字列

// 読み書きモードでファイルを開く
file.OpenReadWrite(SFXPath("/dir/data.txt"));

// ファイル書き込み用文字列ストリームを取得する
// ※ size 引数を指定していないのでストリームバッファは可変長
file.GetStreamWriter(&writer);

// ストリームバッファにデータを書き込む
// ※ 書き込んだデータのサイズに合わせてストリームバッファは自動的に拡張される
writer << string; // "abcd" を書き込む
writer << "efgh"; // "efgh" を書き込む
writer << string; // "abcd" を書き込む

// ストリームバッファからファイルにデータを書き込む
// ※ 可変長バッファストリームの場合、1 回の Flush 関数呼び出しで書き込みは完了する
writer.Flush();

// ファイル書き込み用文字列ストリームを解放する
writer.Release();

// ファイルを閉じる
file.Close();

例 17.5. 書き込まれた文字列: "/dir/data.txt"

61 62 63 64 65 66 67 68 61 62 63 64  // HEX 形式(16 進数表示)

例 17.6. 読み込む文字列: "/dir/data.txt"

61 62 63 64 65 66 67 68 61 62 63  // HEX 形式(16 進数表示)

例 17.7. 文字列ストリームからバッファクラスへの読み込み

// *** 以下のコードでは、エラー処理が省略されています。 
SFXFile file;                      // ファイル
SFXAnsiStringStreamReader reader;  // ファイル読み込み用文字列ストリーム
SFXBuffer buffer;  // 読み込むバッファ
buffer.SetSize(4); // あらかじめ読み込むサイズを設定しておく必要がある

// 読み込みモードでファイルを開く
file.OpenReadOnly(SFXPath("/dir/data.txt"));

// ファイル読み込み用文字列ストリームを取得する
// ※ size 引数を指定していないのでストリームバッファは可変長
file.GetStreamReader(&reader);

// ファイルからストリームバッファにデータを読み込む
// ※1. 読み込んだデータのサイズに合わせてストリームバッファは自動的に拡張される
// ※2. 可変長バッファストリームの場合、1 回の Fetch 関数呼び出しで読み込みは完了する
reader.Fetch();

// ストリームバッファから buffer 変数にデータを読み込む
// ※ エクストラクタ(>> 演算子)は利用できない
reader.Read(&buffer);   // 最初の 4 バイトを取得する  buffer には 61 62 63 64 (HEX 形式)が格納される
reader.Read(&buffer);   // 次の 4 バイトを取得する    buffer には 65 66 67 68 (HEX 形式)が格納される

// この時点でストリームバッファに残っているデータは 3 バイト
// buffer のサイズは 4 バイトなので読み込もうとするデータの方がストリームバッファに残っているデータよりも大きい
reader.Read(&buffer);  // このとき、ストリームから読み込もうとしても buffer の内容は 65 66 67 68 (HEX 形式) のままで変化しない
                   // SFERR_FAILED が返る

// ファイル読み込み用文字列ストリームを解放する
reader.Release();

// ファイルを閉じる
file.Close();

例 17.8. 文字列ストリームへのバッファクラスの書き込み

// *** 以下のコードでは、エラー処理が省略されています。 
SFXFile file;                                   // ファイル
SFXAnsiStringStreamWriter writer;               // ファイル書き込み用文字列ストリーム
SFXBuffer buffer;                               // バッファ
AChar data[] = {0x61, 0x62, 0x63, 0x64, 0x65};  // バッファに設定するデータ

buffer.Set(data, 5);  // buffer に 5 バイトのデータを設定する

// 読み書きモードでファイルを開く
file.OpenReadWrite(SFXPath("/dir/data.txt"));

// ファイル書き込み用文字列ストリームを取得する
// ※ size 引数を指定していないのでストリームバッファは可変長
file.GetStreamWriter(&writer);

// buffer 変数からストリームバッファにデータを書き込む
// ※ インサータ(<< 演算子)は利用できない
writer.Write(buffer); // 5 バイトの buffer データをファイル書き込み用文字列ストリームに書き込む
writer.Write(buffer); // 5 バイトの buffer データをファイル書き込み用文字列ストリームに書き込む

// ストリームバッファからファイルにデータを書き込む
// ※ 可変長バッファストリームの場合、1 回の Flush 関数呼び出しで書き込みは完了する
writer.Flush();

// ファイル書き込み用文字列ストリームを解放する
writer.Release();

// ファイルを閉じる
file.Close();

例 17.9. 書き込まれたバイナリ列: "/dir/data.txt"

61 62 63 64 65 61 62 63 64 65  // HEX 形式(16 進数表示)