std::setw

 

C++

编译器支持

独立式和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (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)

 

输入/输出操纵符

浮点格式化
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>
/* unspecified */ 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)
{
    // set width
    str.width(n);
}

注解

如果调用以下任何函数，流的 width 属性将被重置为零（意味着“未指定”）

• 输入

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

• 输出

• 接受算术类型或 void 指针的 basic_ostream::operator<<() 重载（在 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	控制是否使用前缀来指示数字基数 (函数)