std::setw
来自cppreference.com
在标头 <iomanip> 定义 | ||
/* 未指定 */ setw(int n ); | ||
用于表达式 out << std::setw(n) 或 in >> std::setw(n) 时，设置流 out 或 in 的 width 参数为 n。
有些操作会将宽度重置为零（见下文），所以需要为多个操作设置宽度时可能需要多次调用 std::setw。
目录 |
[编辑]参数
| n | - | width 的新值 |
[编辑]返回值
一个满足以下条件但未指定类型的对象：
- 如果 out 是具有 std::basic_ostream<CharT, Traits> 类型的对象，那么表达式 out << setw(n)：
- 具有 std::basic_ostream<CharT, Traits>& 类型
- 值为 out
- 行为如同调用 f(out, n)
- 如果 in 是具有 std::basic_istream<CharT, Traits> 类型的对象，那么表达式 in >> setw(n)：
- 具有 std::basic_istream<CharT, Traits>& 类型
- 值为 in
- 行为如同调用 f(in, n)
其中函数 f 定义如下：
void f(std::ios_base& str, int n){// 设置宽度 str.width(n);}
[编辑]注解
如果调用了下列任何函数，那么流的宽度属性将被重置为零（表示“不指定”）：
- 输入
- 输出
- basic_ostream::operator<<() 的接收算术类型和 void 指针的重载（在 num_put::put() 的阶段 3）
- operator<<(basic_ostream&, char) 和 operator<<(basic_ostream&, char*)
- operator<<(basic_ostream&, basic_string&)
- std::put_money（在 money_put::put() 内）
- std::quoted（以输出流使用时）
此修改器在输入与输出上的确切效果在每个输入/输出函数都会有不同，会在每个 operator<< 和 operator>> 重载的页面单独描述。
[编辑]示例
运行此代码
#include <iomanip>#include <iostream>#include <sstream> int main(){std::cout<<"没有 setw：["<<42<<"]\n"<<"setw(6)：["<< std::setw(6)<<42<<"]\n"<<"没有 setw，并输出多个元素：["<<89<<12<<34<<"]\n"<<"setw(6)，并输出多个元素：["<<89<< std::setw(6)<<12<<34<<"]\n"; std::istringstream is("hello, world");char arr[10]; is >> std::setw(6)>> arr;std::cout<<"有 setw(6) 时从 \""<< is.str()<<"\" 输入会得到 \""<< arr <<"\"\n";}
输出：
没有 setw：[42] setw(6)：[ 42] 没有 setw，并输出多个元素：[891234] setw(6)，并输出多个元素：[89 1234] 有 setw(6) 时从 "hello, world" 输入会得到 "hello"
[编辑]缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 183 | C++98 | setw 只能用于具有 std::ostream 或 std::istream 类型的流 | 可以用于所有字符流 |
[编辑]参阅
| 管理字段宽度 ( std::ios_base 的公开成员函数) | |
| 更改填充字符 (函数模板) | |
| 设置填充字符的布置 (函数) | |
| 控制是否使用前缀指示数值基数 (函数) |
