std::basic_filebuf<CharT,Traits>:: seekpos

可能であれば、ファイルポインタを sp で示される位置に再配置します。関連付けられたファイルが開かれていない場合（ is_open ( ) == false ）、直ちに失敗します。

Repositionは以下のように動作します:

sp が同じファイルに対する seekoff() または seekpos() の呼び出しによって取得されなかった場合、動作は未定義です。

パラメータ

戻り値

sp 成功時、または pos_type ( off_type ( - 1 ) ) 失敗時。

注記

seekpos() は std::basic_streambuf::pubseekpos() によって呼び出され、これは単一引数バージョンの std::basic_istream::seekg() および std::basic_ostream::seekp() によって呼び出されます。

多くの実装では、get領域を更新せず、 seekpos() の処理を underflow() に委譲し、これは次に呼び出される sgetc() によって実行されます。

例

#include <fstream>
#include <iostream>
struct mybuf : std::filebuf
{
    pos_type seekpos(pos_type sp, std::ios_base::openmode which)
    {
        std::cout << "Before seekpos(" << sp << "), size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available.\n";
        pos_type rc = std::filebuf::seekpos(sp, which);
        std::cout << "seekpos() returns " << rc << ".\nAfter the call, "
                  << "size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available.\n";
// uncomment if get area is emptied by seekpos()
//        std::filebuf::underflow();
//        std::cout << "after forced underflow(), size of the get area is "
//                  << egptr() - eback() << " with "
//                  << egptr() - gptr() << " read positions available.\n";
        return rc;
    }
};
int main()
{
    mybuf buf;
    buf.open("test.txt", std::ios_base::in);
    std::istream stream(&buf);
    stream.get(); // read one char to force underflow()
    stream.seekg(2);
}

Before seekpos(2), size of the get area is 110 with 109 read positions available.
seekpos() returns 2.
After the call, size of the get area is 110 with 108 read positions available.

欠陥報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目