std::basic_ios

 

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

成員函式

basic_ios::basic_ios

basic_ios::~basic_ios

狀態函式

basic_ios::good

basic_ios::eof

basic_ios::fail

basic_ios::bad

basic_ios::operator!

basic_ios::operator bool

basic_ios::rdstate

basic_ios::setstate

basic_ios::clear

格式化

basic_ios::copyfmt

basic_ios::fill

雜項

basic_ios::exceptions

basic_ios::imbue

basic_ios::rdbuf

basic_ios::tie

basic_ios::narrow

basic_ios::widen

受保護的成員函式

basic_ios::init

basic_ios::move (C++11)

basic_ios::swap (C++11)

basic_ios::set_rdbuf (C++11)

 

定義於標頭檔案 <ios>
template<     class CharT,     class Traits = std::char_traits<CharT> > class basic_ios     : public std::ios_base

類 std::basic_ios 提供了與具有 std::basic_streambuf 介面的物件進行互動的工具。多個 std::basic_ios 物件可以引用同一個實際的 std::basic_streambuf 物件。

繼承圖

提供了用於常見字元型別的幾個 typedef

定義於標頭檔案 <ios>
型別	定義
std::ios	std::basic_ios<char>
std::wios	std::basic_ios<wchar_t>

成員型別

成員型別	定義
char_type	CharT
traits_type	Traits；如果 Traits::char_type 不是 CharT，則程式格式錯誤。
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

Public 成員函式

(建構函式)	構造物件 (public 成員函式)
(解構函式) [virtual]	析構物件 (virtual public 成員函式)
operator=	複製賦值運算子已被刪除 (公開成員函式)
狀態函式
good	檢查是否沒有發生錯誤，即 I/O 操作可用 (public 成員函式)
eof	檢查是否已到達檔案末尾 (public 成員函式)
fail	檢查是否發生錯誤 (public 成員函式)
bad	檢查是否發生不可恢復的錯誤 (public 成員函式)
operator!	檢查是否發生錯誤（fail() 的同義詞） (public 成員函式)
operator bool	檢查是否沒有發生錯誤（!fail() 的同義詞） (public 成員函式)
rdstate	返回狀態標誌 (public 成員函式)
setstate	設定狀態標誌 (public 成員函式)
clear	修改狀態標誌 (public 成員函式)
格式化
copyfmt	複製格式化資訊 (public 成員函式)
fill	管理填充字元 (public 成員函式)
雜項
exceptions	管理異常掩碼 (public 成員函式)
imbue	設定區域設定 (public 成員函式)
rdbuf	管理關聯的流緩衝區 (public 成員函式)
tie	管理繫結的流 (public 成員函式)
narrow	窄化字元 (public 成員函式)
widen	寬化字元 (public 成員函式)

Protected 成員函式

init	初始化預設構造的 std::basic_ios (protected 成員函式)
move (C++11)	從另一個 std::basic_ios 移動，除了 rdbuf (protected 成員函式)
swap (C++11)	與另一個 std::basic_ios 交換，除了 rdbuf (protected 成員函式)
set_rdbuf	替換 rdbuf 而不清除其錯誤狀態 (protected 成員函式)

繼承自 std::ios_base

成員函式

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

成員型別和常量
型別	解釋
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)

註釋

std::basic_ios 的直接實現只儲存以下成員（它們都依賴於模板引數，因此不能作為 std::ios_base 的一部分）：

• 填充字元（參見 fill()）
• 繫結的流指標（參見 tie()）
• 關聯的流緩衝區指標（參見 rdbuf()）。

實際實現因平臺而異：

Microsoft Visual Studio 只儲存這三個成員。

LLVM libc++ 儲存的成員少 1 個：它將 rdbuf 指標作為 ios_base 的 void* 成員維護。

GNU libstdc++ 儲存了 4 個額外的成員：三個快取的 facet 和一個指示填充已初始化的標誌。