SFUFileStream は、ファイルに対する入出力を実装しています。 ストリーム バッファとして内部で SFUFileBuffer を使用しています。

ここではファイルからデータを読み取るサンプル コードを使って説明します。

Void TestFile() {
    SFUFileStream fstr;
    fstr.Open("test.txt", _OFM_READ);
    if (fstr.Exception() != NO_ERROR) {
        TRACE("Cannot open");
        return;
    }
    
    TRACE("available %d", fstr.Available());
    while (! fstr.IsEOS()) {
        UInt08 ch;
        fstr >> ch;
        TRACE("%c", ch);
    }
    
    TRACE("REWIND!");
    fstr >> seek(0);
    fstr >> offset(2);
    
    while (! fstr.IsEOS()) {
        UInt08 ch;
        fstr >> ch;
        TRACE("%c", ch);
    }
}

ファイルをオープンするためには、 Open() 関数を使用し、ファイル名とオープン モードを指定します。 ファイルがオープンできない場合、 Exception() 関数は NO_ERROR 以外の値を返します。 ここでは、BREW モジュールと同ディレクトリに存在する test.txt というファイルをオープンしています。

Available() 関数は、ストリームの現在位置から数えて、 どれぐらいのデータが存在するかを返します。 データが存在しない場合、IsEOF() が TRUE になります。

データはエクストラクタによりさまざまなデータ型で取得できます。 ここでは UInt08 型として 1 文字ずつ読み取っています。

ファイル位置をシークするには、マニピュレータ seek(n) や offset(n) を使用できます。