std::basic_ostream

来自cppreference.com
< cpp‎ | io
 
C++
 
输入/输出库
 
std::basic_ostream
全局对象
原文：
Global objects
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
成员函数
原文：
Member functions
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
(C++11)
格式化的输入
原文：
Formatted input
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
未格式化的输入
原文：
Unformatted input
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
定位
原文：
Positioning
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
杂项
原文：
Miscellaneous
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
(C++11)
会员类别
原文：
Member classes
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
非成员函数
原文：
Non-member functions
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
 
定义于头文件 <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 无非继承的数据成员。

cpp/io/ios basecpp/io/basic iosstd-basic ostream-inheritance.svg
关于这幅图像

继承图

亦提供二个对常见字符类型的特化：

定义于头文件 <ostream>
类型 定义
ostream basic_ostream<char>
wostream basic_ostream<wchar_t>

目录

[编辑] 全局对象

标准库提供六个全局 basic_ostream 对象。

定义于头文件 <iostream>
写入标准 C 输出流 stdout
(全局对象) [编辑]
写入标准 C 错误流 stderr ，无缓冲
(全局对象) [编辑]
写入标准 C 错误流 stderr
(全局对象) [编辑]

[编辑] 成员类型

成员类型 定义
char_type CharT[编辑]
traits_type Traits[编辑]
int_type Traits::int_type[编辑]
pos_type Traits::pos_type[编辑]
off_type Traits::off_type[编辑]

[编辑] 成员函数
构造对象
原文：
constructs the object
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
[虚]
解构的对象
原文：
destructs the object
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(虚公开成员函数) [编辑]
(C++11)
替换缓存对象
原文：
replaces the buffer object
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(受保护成员函数) [编辑]
有格式输出
插入格式化的数据
(公开成员函数) [编辑]
无格式输出
插入字符
原文：
inserts a character
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
插入字符块
原文：
inserts blocks of characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
寻位
返回输出位置指示器
原文：
returns the output position indicator
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
设置输出位置指示器
原文：
sets the output position indicator
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
杂项
与底层存储设备同步
原文：
synchronizes with the underlying storage device
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
(C++11)
交换流对象，除了相关的缓冲区
原文：
swaps stream objects, except for the associated buffer
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(受保护成员函数) [编辑]

[编辑] 成员类
实现这个流为输出操作准备的基本逻辑
原文：
implements basic logic for preparation of the stream for output operations
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员类) [编辑]

[编辑] 非成员函数

 插入字符数据
(函数) [编辑]

继承自 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 的公开成员函数) [编辑]
检查是否到达了文件末尾
(std::basic_ios 的公开成员函数) [编辑]
检查是否发生了可恢复的错误
(std::basic_ios 的公开成员函数) [编辑]
检查，如果已经发生了不可恢复的错误
原文：
checks if a non-recoverable error has occurred
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::basic_ios 的公开成员函数) [编辑]
检查是否有错误发生（fail() 的同义词）
(std::basic_ios 的公开成员函数) [编辑]
(C++11 前)
(C++11 起)
 检查是否没有发生错误（!fail()的同义词）
(std::basic_ios 的公开成员函数) [编辑]
返回状态标志
原文：
returns state flags
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::basic_ios 的公开成员函数) [编辑]
设置状态标志
原文：
sets state flags
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::basic_ios 的公开成员函数) [编辑]
清除错误和EOF标志
原文：
clears error and eof flags
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::basic_ios 的公开成员函数) [编辑]
格式化
复制格式化信息
(std::basic_ios 的公开成员函数) [编辑]
管理填充字符
(std::basic_ios 的公开成员函数) [编辑]
杂项
管理异常掩码
(std::basic_ios 的公开成员函数) [编辑]
设置语言环境
原文：
sets the locale
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::basic_ios 的公开成员函数) [编辑]
管理相关的流缓冲区
(std::basic_ios 的公开成员函数) [编辑]
管理绑定的流
(std::basic_ios 的公开成员函数) [编辑]
缩小字符
原文：
narrows characters
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::basic_ios 的公开成员函数) [编辑]
拓宽字符
(std::basic_ios 的公开成员函数) [编辑]

继承自 std::ios_base

成员函数

格式化
管理格式的标志
原文：
manages format flags
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::ios_base 的公开成员函数) [编辑]
设置特定格式的标志
原文：
sets specific format flag
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::ios_base 的公开成员函数) [编辑]
清除特定格式的标志
(std::ios_base 的公开成员函数) [编辑]
管理浮点操作的精度
(std::ios_base 的公开成员函数) [编辑]
管理域的宽度
(std::ios_base 的公开成员函数) [编辑]
语言环境
设置区域
(std::ios_base 的公开成员函数) [编辑]
返回当前的区域设置
原文：
returns current locale
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::ios_base 的公开成员函数) [编辑]
内部可扩展的数组
[静态]
 返回一个程序范围内唯一的整数，它可以安全用于 PWORD() 和 iword() 的下标
(std::ios_base 的公开静态成员函数) [编辑]
如果有必要的话，调整私有存储的大小，并且访问位于提供的下标的long元素
(std::ios_base 的公开成员函数) [编辑]
如果有必要的话，调整私有存储的大小，并且访问位于提供的下标的void*元素
原文：
resizes the private storage if necessary and access to the void* element at the given index
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::ios_base 的公开成员函数) [编辑]
杂项
注册事件回调函数
(std::ios_base 的公开成员函数) [编辑]
[静态]
 设置C++和C的IO库是否可以互操作
(std::ios_base 的公开静态成员函数) [编辑]
成员类
流异常
原文：
stream exception
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(std::ios_base 的公开成员类) [编辑]
初始化标准流对象
(std::ios_base 的公开成员类) [编辑]

成员类型和常量

类型 解释
流开放的模式类型

有以下常量的定义：

常数 解释[编辑]
app 每次写操作之前都移动到流的末尾[编辑]
binary 以二进制模式打开 [编辑]
in 以读取模式打开[编辑]
out 以写入模式打开[编辑]
trunc 打开时丢弃流的内容 [编辑]
ate 在打开后立即移动到流的末尾[编辑]
原文：
stream open mode type

The following constants are also defined:

常数 解释[编辑]
app 每次写操作之前都移动到流的末尾[编辑]
binary 以二进制模式打开 [编辑]
in 以读取模式打开[编辑]
out 以写入模式打开[编辑]
trunc 打开时丢弃流的内容 [编辑]
ate 在打开后立即移动到流的末尾[编辑]
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(typedef) [编辑]
格式化标志类型

有以下常量的定义：

常数 解释[编辑]
dec 对整数IO使用十进制 [编辑]
oct 对整数IO使用八进制 [编辑]
hex 对整数IO使用十六进制 [编辑]
basefield dec|oct|hex|0。用于屏蔽操作 [编辑]
left 左调整（在右侧添加填充字符） [编辑]
right 右调整（在左侧添加填充字符） [编辑]
internal 内部调整（在内部指定的点添加填充字符） [编辑]
adjustfield left|right|internal。用于屏蔽操作 [编辑]
scientific 以科学记数法生成浮点类型，或者如果和fixed一起设置，则使用十六进制记数法 [编辑]
fixed 以固定计数法生成浮点类型，或者如果和scientific一起设置，则使用十六进制记数法 [编辑]
floatfield scientific|fixed|(scientific|fixed)|0。用于屏蔽操作 [编辑]
boolalpha 在字母数字格式中插入和提取bool类型 [编辑]
showbase 生成一个的前缀表示数字的整数输出基地，需要的I / O货币的货币指标 [编辑]
showpoint 为所有浮点数输出都无条件生成一个小数点字符 [编辑]
showpos 为所有的非负数值输出生成+字符 [编辑]
skipws 在特定的输入操作之前跳过前导空白 [编辑]
unitbuf 在每次输出操作后都刷新输出流 [编辑]
uppercase 在特定的输出操作中，将特定的小写字母替换为它们的大写形式 [编辑]
原文：
formatting flags type

The following constants are also defined:

常数 解释[编辑]
dec 对整数IO使用十进制 [编辑]
oct 对整数IO使用八进制 [编辑]
hex 对整数IO使用十六进制 [编辑]
basefield dec|oct|hex|0。用于屏蔽操作 [编辑]
left 左调整（在右侧添加填充字符） [编辑]
right 右调整（在左侧添加填充字符） [编辑]
internal 内部调整（在内部指定的点添加填充字符） [编辑]
adjustfield left|right|internal。用于屏蔽操作 [编辑]
scientific 以科学记数法生成浮点类型，或者如果和fixed一起设置，则使用十六进制记数法 [编辑]
fixed 以固定计数法生成浮点类型，或者如果和scientific一起设置，则使用十六进制记数法 [编辑]
floatfield scientific|fixed|(scientific|fixed)|0。用于屏蔽操作 [编辑]
boolalpha 在字母数字格式中插入和提取bool类型 [编辑]
showbase 生成一个的前缀表示数字的整数输出基地，需要的I / O货币的货币指标 [编辑]
showpoint 为所有浮点数输出都无条件生成一个小数点字符 [编辑]
showpos 为所有的非负数值输出生成+字符 [编辑]
skipws 在特定的输入操作之前跳过前导空白 [编辑]
unitbuf 在每次输出操作后都刷新输出流 [编辑]
uppercase 在特定的输出操作中，将特定的小写字母替换为它们的大写形式 [编辑]
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(typedef) [编辑]
流类型的状态

亦定义下列常量：

常量 解释[编辑]
goodbit 无错误 [编辑]
badbit 不可恢复的流错误 [编辑]
failbit 输入/输出操作失败（格式化或提取错误） [编辑]
eofbit 关联的输出序列已抵达文件尾 [编辑]

(typedef) [编辑]
寻位方向类型

亦定义下列常量：

常量 解释[编辑]
beg 流的开始 [编辑]
end 流的结尾 [编辑]
cur 流位置指示器的当前位置 [编辑]

(typedef) [编辑]
指定事件类型
(枚举) [编辑]
回调函数类型
(typedef) [编辑]
来自“http://zh.cppreference.com/mwiki/index.php?title=cpp/io/basic_ostream&oldid=44464”