std::setw

 

C++

编译器支持

独立式和托管式

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (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)

 

输入/输出操作符

浮点数格式化
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
整数格式化
setbase showbasenoshowbase	dechexoct
布尔值格式化
boolalphanoboolalpha
字段宽度和填充控制
setfill setw	internalleftright
其他格式化
showposnoshowpos	uppercasenouppercase
空白处理
ws ends	skipwsnoskipws
输出刷新
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushnoemit_on_flush (C++20)(C++20)
状态标志操作
resetiosflags	setiosflags
时间和货币 I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)
带引号的操作符
quoted (C++14)

 

在头文件 <iomanip> 中定义
/* 未指定 */ setw( int n );

当在表达式 out << std::setw(n) 或 in >> std::setw(n) 中使用时，将流 out 或 in 的 width 参数设置为 n。

某些操作会将宽度重置为零（请参见下文），因此可能需要重复调用 std::setw 来为多个操作设置宽度。

参数

n

-

宽度的新的值

返回值

一个未指定类型的对象，使得

• 如果 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)
{
    // set width
    str.width(n);
}

注意

如果调用以下任何函数，则流的宽度属性将重置为零（表示“未指定”）

• 输入

• operator>>(basic_istream&, basic_string&)
• operator>>(basic_istream&, char*)

• 输出

• 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 （当与输出流一起使用时）

此修饰符对输入和输出的确切影响因各个 I/O 函数而异，并在每个 operator<< 和 operator>> 重载页面中单独描述。

示例

运行此代码

#include <iomanip>
#include <iostream>
#include <sstream>
 
int main()
{
    std::cout << "no setw: [" << 42 << "]\n"
              << "setw(6): [" << std::setw(6) << 42 << "]\n"
              << "no setw, several elements: [" << 89 << 12 << 34 << "]\n"
              << "setw(6), several elements: [" << 89 << std::setw(6) << 12 << 34 << "]\n";
 
    std::istringstream is("hello, world");
    char arr[10];
 
    is >> std::setw(6) >> arr;
    std::cout << "Input from \"" << is.str() << "\" with setw(6) gave \""
              << arr << "\"\n";
}

输出

no setw: [42]
setw(6): [    42]
no setw, several elements: [891234]
setw(6), several elements: [89    1234]
Input from "hello, world" with setw(6) gave "hello"

缺陷报告

以下行为更改缺陷报告已追溯应用于先前发布的 C++ 标准。

DR	应用于	发布时的行为	正确行为
LWG 183	C++98	setw 只能与 类型为 std::ostream 或 std::istream 的流一起使用	可用于任何 字符流

参见

width	管理字段宽度 （std::ios_base 的公共成员函数）
setfill	更改填充字符 （函数模板）
internalleftright	设置填充字符的位置 （函数）
showbasenoshowbase	控制是否使用前缀来指示数字基数 （函数）