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	回调函数类型 (类型定义)