std::strstreambuf:: seekpos

如果可能，将 std::basic_streambuf::gptr 和/或 std::basic_streambuf::pptr 重新定位到 sp 指示的位置。

如果 std::ios_base::in 在 which 中被设置，则尝试重新定位 gptr() （获取区域中的下一个指针）。如果 std::ios_base::out 在 which 中被设置，则尝试重新定位 pptr() （放置区域中的下一个指针）。如果 which 中未设置任何位，则操作失败。

每个 next 指针按以下方式重新定位：

• 如果下一个指针为空，则操作失败。
• 否则，新的偏移量 newoff （类型为 off_type ）通过调用 sp. offset ( ) 确定。如果 newoff 为负数、超出缓冲区边界或无效，则操作失败。
• 否则，下一个指针的赋值方式相当于 gptr ( ) = eback ( ) + newoff 或 pptr ( ) = pbase ( ) + newoff 。

参数

返回值

成功时返回转换为 pos_type 的结果偏移量，失败时返回 pos_type ( off_type ( - 1 ) ) 。

注释

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

示例

#include <cstring>
#include <iostream>
#include <strstream>
struct mybuf : std::strstreambuf
{
    mybuf(const char* str) : std::strstreambuf(str, std::strlen(str)) {}
    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::strstreambuf::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";
        return rc;
    }
};
int main()
{
    mybuf buf("12345");
    std::iostream stream(&buf);
    stream.seekg(2);
}

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

缺陷报告

下列行为变更缺陷报告被追溯应用于先前发布的C++标准。

参见