例 18.1. ファイル入力

SFXFile file;                     // ファイル
SFXAnsiStringStreamReader reader; // ファイル読み込み用ストリーム
SFXAnsiString string;             // 読み込む変数

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

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

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

            // ストリームのバッファから string 変数にデータを読み込む
            if ((error = reader.ReadSFXAnsiString(&string)) == SFERR_NO_ERROR) { 

                // ファイル読み込み成功！

                // string 変数の内容をデバッグウィンドウに表示する
                TRACE("%s", string.GetCString());

            } 
        }
        // ファイル読み込み用ストリームを解放する
        reader.Release();
    }
    // ファイルを閉じる
    file.Close();
} 
if (error != SFERR_NO_ERROR) {

    // エラーが発生したとき
    ...
}

	可変長バッファストリームによる読み込み
	ストリームにはバッファがあります。 SFXFile::GetStreamReader 関数で size 引数を指定せずにファイル読み込み用ストリームを取得しているので、 可変長バッファが使用されます。 このため、 ストリームバッファは入力ファイルと同じサイズまで拡張されます。 SFXStreamReader::Fetch 関数は、 ファイルからデータを読み込み、ストリームバッファに読み込みます。 SFXAnsiStringStreamReader::ReadSFXAnsiString 関数は、 ストリームバッファからデータを読み込み、string 変数に格納します。

例 18.2. ファイル出力

SFXFile file;                     // ファイル
SFXAnsiStringStreamWriter writer; // ファイル書き込み用ストリーム
SFXAnsiString string("abcdefg");  // 書き込む変数

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

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

        // string 変数からストリームバッファにデータを書き込む
        // ※ 書き込んだデータのサイズに合わせてストリームバッファは自動的に拡張される
        if ((error = writer.WriteSFXAnsiString(string)) == SFERR_NO_ERROR) {

            // ストリームバッファのデータをファイルにデータを書き込む
            // ※ 可変長バッファストリームの場合、1 回の Flush 関数呼び出しで書き込みは完了する
            error = writer.Flush(); 
        } 
        // ファイル書き込み用ストリームを解放する
        writer.Release();
    } 
    // ファイルを閉じる
    file.Close();
} 
if (error != SFERR_NO_ERROR) {

    // エラーが発生したとき
    ...
}

	可変長バッファストリームによる書き込み
	ストリームにはバッファがあります。 SFXFile::GetStreamWriter 関数で size 引数を指定せずにファイル書き込み用ストリームを取得しているので、 可変長バッファが使用されます。 このため、 ストリームバッファは出力ファイルに書き込む全データと同じサイズまで拡張されます。 SFXAnsiStringStreamWriter::WriteSFXAnsiString 関数は、 string 変数のデータをストリームバッファに書き込みます。 SFXStreamWriter::Flush 関数は、 ストリームバッファ内のデータをファイルに書き込みます。