std::ios_base

 

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::ios_base

成員函式

ios_base::ios_base

ios_base::~ios_base

ios_base::operator=

格式化

ios_base::flags

ios_base::setf

ios_base::unsetf

ios_base::precision

ios_base::width

區域設定

ios_base::imbue

ios_base::getloc

內部可擴充套件陣列

ios_base::xalloc

ios_base::iword

ios_base::pword

雜項

ios_base::register_callback

ios_base::sync_with_stdio

成員類

ios_base::failure

ios_base::Init

成員型別

ios_base::openmode

ios_base::fmtflags

ios_base::iostate

ios_base::seekdir

ios_base::event

ios_base::event_callback

 

定義於標頭檔案 <ios>
class ios_base;

ios_base 類是一個多用途類，作為所有 I/O 流類的基類。它維護幾種型別的資料：

1) 狀態資訊：流狀態標誌。

2) 控制資訊：控制輸入和輸出序列格式以及內嵌區域設定的標誌。

3) 私有儲存：索引可擴充套件資料結構，允許 long 和 void* 成員，可以實現為兩個任意長度陣列、一個兩元素結構體陣列或另一個容器。

4) 回撥：在 imbue()、std::basic_ios::copyfmt() 和 ~ios_base() 中呼叫的任意數量的使用者定義函式。

典型的實現包含與 fmtflags、iostate、openmode 和 seekdir 的所有值相對應的成員常量（如下所示），維護當前精度、寬度和格式標誌、異常掩碼、緩衝區錯誤狀態、儲存回撥的可調整大小容器、當前內嵌區域設定、私有儲存以及用於 xalloc() 的靜態整數變數。

成員函式

(建構函式)	構造物件 (protected member function)
(解構函式) [virtual]	析構物件 (virtual public member function)
operator=	賦值給流 (public member function)
格式化
flags	管理格式標誌 (public member function)
setf	設定特定格式標誌 (public member function)
unsetf	清除特定格式標誌 (public member function)
precision	管理浮點運算的十進位制精度 (public member function)
width	管理欄位寬度 (public member function)
區域設定
imbue	設定區域設定 (public member function)
getloc	返回當前區域設定 (public member function)
內部可擴充套件陣列
xalloc [靜態]	返回一個程式範圍內的唯一整數，可安全用作 pword() 和 iword() 的索引 (public static member function)
iword	如有必要，調整私有儲存的大小，並訪問給定索引處的 long 元素 (public member function)
pword	如有必要，調整私有儲存的大小，並訪問給定索引處的 void* 元素 (public member function)
雜項
register_callback	註冊事件回撥函式 (public member function)
sync_with_stdio [靜態]	設定 C++ 和 C I/O 庫是否可互操作 (public static member function)
成員類
failure	流異常 (public member class)
Init	初始化標準流物件 (public member class)

成員型別和常量
型別	解釋
openmode	流開啟模式型別 還定義了以下常量 常量 解釋 app 在每次寫入前定位到流末尾 二進位制 以二進位制模式開啟 in 為讀取開啟 out 為寫入開啟 trunc 開啟時丟棄流的內容 ate 開啟後立即定位到流末尾 noreplace (C++23) 以獨佔模式開啟 (typedef)
fmtflags	格式化標誌型別 還定義了以下常量 常量 解釋 dec 對整數 I/O 使用十進位制基數：參閱 std::dec oct 對整數 I/O 使用八進位制基數：參閱 std::oct hex 對整數 I/O 使用十六進位制基數：參閱 std::hex basefield dec | oct | hex。用於掩碼操作 left 左對齊（在右側新增填充字元）：參閱 std::left right 右對齊（在左側新增填充字元）：參閱 std::right internal 內部對齊（在內部指定點新增填充字元）：參閱 std::internal adjustfield left | right | internal。用於掩碼操作 scientific 使用科學記數法生成浮點型別，如果與 fixed 結合，則使用十六進位制記數法：參閱 std::scientific fixed 使用定點記數法生成浮點型別，如果與 scientific 結合，則使用十六進位制記數法：參閱 std::fixed floatfield scientific | fixed。用於掩碼操作 boolalpha 以字母數字格式插入和提取 bool 型別：參閱 std::boolalpha showbase 為整數輸出生成指示數字基數的 字首，在貨幣 I/O 中要求貨幣指示符：參閱 std::showbase showpoint 對於浮點數輸出，無條件生成小數點字元：參閱 std::showpoint showpos 為非負數字輸出生成 + 字元：參閱 std::showpos skipws 在某些輸入操作前跳過前導空白字元：參閱 std::skipws unitbuf 在每次輸出操作後重新整理輸出：參閱 std::unitbuf uppercase 在某些輸出操作中，將某些小寫字母替換為其大寫等效項：參閱 std::uppercase (typedef)
iostate	流狀態型別 還定義了以下常量 常量 解釋 goodbit 無錯誤 badbit 不可恢復的流錯誤 failbit 輸入/輸出操作失敗（格式化或提取錯誤） eofbit 關聯的輸入序列已到達檔案末尾 (typedef)
seekdir	定位方向型別 還定義了以下常量 常量 解釋 beg 流的開始 end 流的結束 cur 流位置指示器的當前位置 (typedef)
event	指定事件型別 (enum)
event_callback	回撥函式型別 (typedef)

已棄用的成員型別 型別 解釋 io_state (deprecated) 可像 iostate 一樣使用的整數型別 open_mode (deprecated) 可像 openmode 一樣使用的整數型別 seek_dir (deprecated) 可像 seekdir 一樣使用的整數型別 streamoff (deprecated) 可像 off_type 一樣使用的未指定型別，不一定是 std::streamoff streampos (deprecated) 可像 pos_type 一樣使用的未指定型別，不一定是 std::streampos

(C++17 前)

缺陷報告

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

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 1357 (N3110)	C++98	std::ios_base 為型別 openmode、fmtflags 和 iostate 定義了 operator~、operator& 和 operator|，違反了 BitmaskType 的要求	移除了這些定義

參閱

basic_ios

管理任意流緩衝區 (類模板)