std:: basic_ostream
|
定义于头文件
<ostream>
|
||
|
template
<
class
CharT,
|
||
类模板
basic_ostream
提供对字符流的高级输出操作支持。支持的操作包括格式化输出(如整数值)和非格式化输出(如原始字符和字符数组)。该功能通过
basic_streambuf
类提供的接口实现,并通过
basic_ios
基类进行访问。在典型实现中,
basic_ostream
没有非继承的数据成员。
继承关系图
提供了常见字符类型的多个类型定义:
|
定义于头文件
<ostream>
|
|
| 类型 | 定义 |
std::ostream
|
std :: basic_ostream < char > |
std::wostream
|
std :: basic_ostream < wchar_t > |
目录 |
全局对象
标准库提供了六个全局
basic_ostream
对象:
|
定义于头文件
<iostream>
|
|
|
写入标准C输出流
stdout
(全局对象) |
|
|
写入标准C错误流
stderr
,无缓冲
(全局对象) |
|
|
写入标准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
|
成员函数
|
构造对象
(公开成员函数) |
|
|
[virtual]
|
析构对象
(虚公开成员函数) |
|
(C++11)
|
从另一个
basic_ostream
移动赋值
(受保护成员函数) |
格式化输出 |
|
|
插入格式化数据
(公开成员函数) |
|
非格式化输出 |
|
|
插入单个字符
(公开成员函数) |
|
|
插入字符块
(公开成员函数) |
|
定位操作 |
|
|
返回输出位置指示器
(公开成员函数) |
|
|
设置输出位置指示器
(公开成员函数) |
|
其他功能 |
|
|
与底层存储设备同步
(公开成员函数) |
|
|
(C++11)
|
交换流对象(关联缓冲区除外)
(受保护成员函数) |
成员类
|
实现流输出操作准备的基础逻辑
(公开成员类) |
非成员函数
|
插入字符数据或插入到右值流
(函数模板) |
|
|
(C++23)
|
输出参数的
格式化
表示
(函数模板) |
|
(C++23)
|
输出参数的
格式化
表示并附加
'
\n
'
(函数模板) |
|
(C++23)
|
使用
类型擦除
的参数表示执行Unicode感知输出
(函数) |
|
(C++23)
|
使用
类型擦除
的参数表示输出字符数据
(函数) |
继承自 std:: basic_ios
成员类型
| 成员类型 | 定义 |
char_type
|
CharT
|
traits_type
|
Traits
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
成员函数
状态函数 |
|
|
检查是否未发生错误(即I/O操作可用)
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
检查是否到达文件末尾
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
检查是否发生错误
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
检查是否发生不可恢复错误
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
检查是否发生错误(
fail()
的同义词)
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
检查是否未发生错误(
!
fail()
的同义词)
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
返回状态标志
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
设置状态标志
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
修改状态标志
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
格式化 |
|
|
复制格式化信息
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
管理填充字符
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
杂项 |
|
|
管理异常掩码
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
设置本地化环境
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
管理关联的流缓冲区
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
管理绑定的流
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
字符窄化
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
|
字符宽化
(
std::basic_ios<CharT,Traits>
的公开成员函数)
|
|
继承自 std:: ios_base
成员函数
格式化 |
|
|
管理格式标志
(
std::ios_base
的公开成员函数)
|
|
|
设置特定格式标志
(
std::ios_base
的公开成员函数)
|
|
|
清除特定格式标志
(
std::ios_base
的公开成员函数)
|
|
|
管理浮点数运算的十进制精度
(
std::ios_base
的公开成员函数)
|
|
|
管理字段宽度
(
std::ios_base
的公开成员函数)
|
|
本地化 |
|
|
设置本地化环境
(
std::ios_base
的公开成员函数)
|
|
|
返回当前本地化环境
(
std::ios_base
的公开成员函数)
|
|
内部可扩展数组 |
|
|
[static]
|
返回一个全局唯一的整数,该整数可安全用作
pword()
和
iword()
的索引
(
std::ios_base
的公开静态成员函数)
|
|
必要时调整私有存储大小并访问指定索引处的
long
元素
(
std::ios_base
的公开成员函数)
|
|
|
必要时调整私有存储大小并访问指定索引处的
void
*
元素
(
std::ios_base
的公开成员函数)
|
|
杂项 |
|
|
注册事件回调函数
(
std::ios_base
的公开成员函数)
|
|
|
[static]
|
设置C++与C I/O库是否可互操作
(
std::ios_base
的公开静态成员函数)
|
成员类 |
|
|
流异常
(
std::ios_base
的公开成员类)
|
|
|
初始化标准流对象
(
std::ios_base
的公开成员类)
|
|
成员类型与常量 |
|||||||||||||||||||||||||||||||||||||||
| 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||
|
流打开模式类型
同时定义以下常量:
(类型定义) |
|||||||||||||||||||||||||||||||||||||||
|
格式化标志类型
同时定义以下常量:
(类型定义) |
|||||||||||||||||||||||||||||||||||||||
|
流状态类型
同时定义以下常量:
(类型定义) |
|||||||||||||||||||||||||||||||||||||||
|
寻址方向类型
同时定义以下常量:
(类型定义) |
|||||||||||||||||||||||||||||||||||||||
|
指定事件类型
(枚举) |
|||||||||||||||||||||||||||||||||||||||
|
回调函数类型
(typedef) |
|||||||||||||||||||||||||||||||||||||||