std::strstreambuf::seekoff

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

I/O 操縱器

列印函式 (C++23)

C 風格 I/O

緩衝區

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

檔案 I/O

basic_ifstream

basic_ofstream

basic_fstream

字串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

陣列 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步輸出

basic_osyncstream (C++20)

型別

streamoff

streamsize

fpos

錯誤類別介面

iostream_category (C++11)

io_errc (C++11)

 

std::strstreambuf

公開成員函式

strstreambuf::strstreambuf

strstreambuf::~strstreambuf

strstreambuf::freeze

strstreambuf::str

strstreambuf::pcount

受保護的成員函式

strstreambuf::underflow

strstreambuf::pbackfail

strstreambuf::overflow

strstreambuf::setbuf

strstreambuf::seekoff

strstreambuf::seekpos

 

protected: virtual pos_type seekoff( off_type off,                           ios_base::seekdir way,                           ios_base::openmode which = ios_base::in | ios_base::out );		(C++98 起棄用) (C++26 中移除)

如果可能，將 std::basic_streambuf::gptr 和/或 std::basic_streambuf::pptr 重新定位到與緩衝區讀取區域和/或寫入區域的起始、結束或當前位置偏移 off 個字元的位置。

• 如果 which 包含 ios_base::in 且此緩衝區已開啟供讀取，則按照如下所述在讀取區域內重新定位讀取指標 std::basic_streambuf::gptr。
• 如果 which 包含 ios_base::out 且此緩衝區已開啟供寫入，則按照如下所述在寫入區域內重新定位寫入指標 std::basic_streambuf::pptr。
• 如果 which 包含 ios_base::in 和 ios_base::out 且緩衝區已同時開啟供讀取和寫入，並且 way 是 ios_base::beg 或 ios_base::end，則按照如下所述重新定位讀取和寫入指標。
• 否則，此函式失敗。

如果指標（gptr 或 pptr 或兩者）被重新定位，則按以下方式進行

1) 如果要重新定位的指標為空指標，並且新偏移量 newoff 不為零，則此函式失敗。

2) 確定型別為 off_type 的新指標偏移量 newoff

a) 如果 way == ios_base::beg，則 newoff 為零

b) 如果 way == ios_base::cur，則 newoff 是指標的當前位置（gptr() - eback() 或 pptr() - pbase()）

c) 如果 way == ios_base::end，則 newoff 是緩衝區整個已初始化部分的長度（如果使用超額分配，則是高水位指標減去起始指標）

3) 如果 newoff + off 為負數或超出緩衝區已初始化部分的界限，則函式失敗

4) 否則，指標被賦值，如同透過 gptr() = eback() + newoff + off 或 pptr() = pbase() + newoff + off

引數

off	-	-
way	-	定義應用相對偏移量的基本位置。它可以是以下常量之一 常量 解釋 beg 流的開始 end 流的結束 cur 流位置指示器的當前位置
which	-	- 常量 解釋 in 影響輸入序列 out 影響輸出序列

返回值

成功時返回 pos_type(newoff)，失敗時返回 pos_type(off_type(-1))，如果 pos_type 無法表示結果流位置。

示例

執行此程式碼

#include <iostream>
#include <strstream>
 
int main()
{
    char a[] = "123";
    std::strstream ss(a, sizeof a); // in/out
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    // absolute positioning both pointers
    ss.rdbuf()->pubseekoff(1, std::ios_base::beg); // move both forward
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    // try to move both pointers 1 forward from current position
    if (-1 == ss.rdbuf()->pubseekoff(1, std::ios_base::cur))
        std::cout << "moving both pointers from current position failed\n";
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    // move the write pointer 1 forward, but not the read pointer
    // can also be called as ss.seekp(1, std::ios_base::cur);
    ss.rdbuf()->pubseekoff(1, std::ios_base::cur, std::ios_base::out);
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
 
    ss << 'a'; // write at put position
    std::cout << "Wrote 'a' at put position, the buffer is now: '";
    std::cout.write(a, sizeof a);
    std::cout << "'\n";
 
    char ch;
    ss >> ch;
    std::cout << "reading at get position gives '" << ch << "'\n";
}

輸出

put pos = 0 get pos = 0
put pos = 1 get pos = 1
moving both pointers from current position failed
put pos = 1 get pos = 1
put pos = 2 get pos = 1
Wrote 'a' at put position, the buffer is now: '12a'
reading at get position gives '2'

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 55	C++98	seekoff 失敗時返回未定義 的非法流位置	pos_type(off_type(-1)) 在失敗時返回

另請參閱

seekpos [虛]	使用絕對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (虛擬保護成員函式)
seekoff [虛]	使用相對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (std::basic_streambuf<CharT,Traits> 的虛擬保護成員函式)
seekoff [虛]	使用相對定址重新定位輸入序列、輸出序列或兩者的下一個指標 (std::basic_stringbuf<CharT,Traits,Allocator> 的虛擬保護成員函式)
seekoff [虛]	使用相對地址重新定位檔案位置 (std::basic_filebuf<CharT,Traits> 的虛擬保護成員函式)