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

如果可能，将文件指针重新定位到由 sp 指示的位置。如果关联文件未打开（ is_open ( ) == false ），则立即失败。

重新定位执行如下操作：

如果 sp 不是通过在同一文件上调用 seekoff() 或 seekpos() 获得的，则行为未定义。

参数

返回值

sp 表示成功，或 pos_type ( off_type ( - 1 ) ) 表示失败。

注释

seekpos() 由 std::basic_streambuf::pubseekpos() 调用，而后者又由单参数版本的 std::basic_istream::seekg() 和 std::basic_ostream::seekp() 调用。

许多实现不会在 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++标准。

参见