std::basic_ostream

 

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_ostream

全域性物件
coutwcout	cerrwcerr	clogwclog
成員函式
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
格式化輸出
basic_ostream::operator<<
非格式化輸出
basic_ostream::put
basic_ostream::write
定位
basic_ostream::tellp
basic_ostream::seekp
雜項
basic_ostream::flush
basic_ostream::swap (C++11)
成員類
basic_ostream::sentry
非成員函式
operator<<(std::basic_ostream)
print(std::ostream) (C++23)
println(std::ostream) (C++23)
vprint_unicode(std::ostream) (C++23)
vprint_nonunicode(std::ostream) (C++23)

 

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

類模板basic_ostream提供對字元流上高階輸出操作的支援。支援的操作包括格式化輸出（例如整數值）和非格式化輸出（例如原始字元和字元陣列）。此功能是根據basic_streambuf類提供的介面實現的，透過basic_ios基類訪問。在典型的實現中，basic_ostream沒有非繼承的資料成員。

繼承圖

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

定義於標頭檔案 <ostream>
型別	定義
std::ostream	std::basic_ostream<char>
std::wostream	std::basic_ostream<wchar_t>

全域性物件

標準庫提供六個全域性basic_ostream物件

定義於標頭檔案 <iostream>
coutwcout	寫入標準 C 輸出流 stdout (全域性物件)
cerrwcerr	寫入標準 C 錯誤流 stderr，無緩衝 (全域性物件)
clogwclog	寫入標準 C 錯誤流 stderr (全域性物件)

成員型別

成員型別	定義
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 member function)
(解構函式) [虛擬函式]	析構物件 (virtual public member function)
operator= (C++11)	從另一個basic_ostream移動賦值 (protected member function)
格式化輸出
operator<<	插入格式化資料 (public member function)
非格式化輸出
put	插入一個字元 (public member function)
write	插入字元塊 (public member function)
定位
tellp	返回輸出位置指示器 (public member function)
seekp	設定輸出位置指示器 (public member function)
雜項
flush	與底層儲存裝置同步 (public member function)
swap (C++11)	交換流物件，除了關聯緩衝區 (protected member function)

成員類

sentry

實現流為輸出操作準備的基本邏輯 (public member class)

非成員函式

operator<<(std::basic_ostream)	插入字元資料或插入到右值流中 (函式模板)
print(std::ostream) (C++23)	輸出引數的格式化表示 (函式模板)
println(std::ostream) (C++23)	輸出帶附加 '\n' 的引數格式化表示 (函式模板)
vprint_unicode(std::ostream) (C++23)	使用型別擦除的引數表示執行 Unicode 感知輸出 (函式)
vprint_nonunicode(std::ostream) (C++23)	使用型別擦除的引數表示輸出字元資料 (函式)

繼承自 std::basic_ios

成員型別

成員型別	定義
char_type	CharT
traits_type	特性
int_type	Traits::int_type
pos_type	Traits::pos_type
off_type	Traits::off_type

成員函式

狀態函式
good	檢查是否沒有發生錯誤，即 I/O 操作可用 (std::basic_ios<CharT,Traits>的公共成員函式)
eof	檢查是否已到達檔案末尾 (std::basic_ios<CharT,Traits>的公共成員函式)
fail	檢查是否發生錯誤 (std::basic_ios<CharT,Traits>的公共成員函式)
bad	檢查是否發生不可恢復的錯誤 (std::basic_ios<CharT,Traits>的公共成員函式)
operator!	檢查是否發生錯誤（fail() 的同義詞） (std::basic_ios<CharT,Traits>的公共成員函式)
operator bool	檢查是否沒有發生錯誤（!fail() 的同義詞） (std::basic_ios<CharT,Traits>的公共成員函式)
rdstate	返回狀態標誌 (std::basic_ios<CharT,Traits>的公共成員函式)
setstate	設定狀態標誌 (std::basic_ios<CharT,Traits>的公共成員函式)
clear	修改狀態標誌 (std::basic_ios<CharT,Traits>的公共成員函式)
格式化
copyfmt	複製格式化資訊 (std::basic_ios<CharT,Traits>的公共成員函式)
fill	管理填充字元 (std::basic_ios<CharT,Traits>的公共成員函式)
雜項
exceptions	管理異常掩碼 (std::basic_ios<CharT,Traits>的公共成員函式)
imbue	設定區域設定 (std::basic_ios<CharT,Traits>的公共成員函式)
rdbuf	管理關聯的流緩衝區 (std::basic_ios<CharT,Traits>的公共成員函式)
tie	管理繫結的流 (std::basic_ios<CharT,Traits>的公共成員函式)
narrow	窄化字元 (std::basic_ios<CharT,Traits>的公共成員函式)
widen	寬化字元 (std::basic_ios<CharT,Traits>的公共成員函式)

繼承自 std::ios_base

成員函式

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

成員型別和常量
型別	解釋
openmode	流開啟模式型別 還定義了以下常量 常量 解釋 app 每次寫入前定位到流的末尾 二進位制 以二進位制模式開啟 in 為讀取開啟 out 為寫入開啟 trunc 開啟時丟棄流的內容 ate 開啟後立即定位到流的末尾 noreplace (C++23) 以獨佔模式開啟 (型別定義)
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 (型別定義)
iostate	流狀態型別 還定義了以下常量 常量 解釋 goodbit 無錯誤 badbit 不可恢復的流錯誤 failbit 輸入/輸出操作失敗（格式化或提取錯誤） eofbit 關聯的輸入序列已到達檔案末尾 (型別定義)
seekdir	定位方向型別 還定義了以下常量 常量 解釋 beg 流的起始位置 end 流的結束位置 cur 流位置指示器的當前位置 (型別定義)
event	指定事件型別 (列舉)
event_callback	回撥函式型別 (型別定義)