std::streamoff

 

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)

 

定義於標頭檔案 <ios>
typedef /*實現定義*/ streamoff;

型別 std::streamoff 是一個實現定義的有符號整型(自 C++11 起)，其大小足以表示作業系統支援的最大可能檔案大小。通常，它是 long long 的別名。(自 C++11 起)

它用於表示流位置（型別為 std::fpos 的值）的偏移量。從 -1 構造的 std::streamoff 值也被一些 I/O 庫函式用於表示錯誤條件。

與 std::fpos 的關係

• 兩個 std::fpos 物件之間的差值是型別為 std::streamoff 的值

• 型別為 std::streamoff 的值可以與 std::fpos 相加或相減，從而產生不同的 std::fpos。

• 型別為 std::fpos 的值可以隱式轉換為 std::streamoff（轉換結果是檔案開頭的偏移量）。

• 型別為 std::fpos 的值可以從型別為 std::streamoff 的值構造

參閱

fpos	表示流或檔案中的絕對位置 (類模板)
seekg	設定輸入位置指示符 (std::basic_istream<CharT,Traits> 的公開成員函式)
seekp	設定輸出位置指示器 (std::basic_ostream<CharT,Traits> 的公開成員函式)