std::setw

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

输入/输出库

I/O 操纵符

C 风格 I/O

缓冲

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98 中弃用)

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 中弃用)

ostrstream (C++98 中弃用)

strstream (C++98 中弃用)

同步的输出

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 << setw(n) 或 in >> setw(n) 时，设置流 out 或 in 的 width 参数准确为 n 。

参数

n

-

width 的新值

返回值

返回未指定类型对象，满足若 str 是 std::basic_ostream<CharT, Traits> 或 std::basic_istream<CharT, Traits> 类型流的名称，则表达式 str << setw(n) 或 str >> setw(n) 表现为如同执行下列代码：

str.width(n);

注意

若调用任何下列函数，则流的宽度属性将被设为零（表示“不指定”）：

• 输入

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

• 输出

• basic_ostream::operator<<() 的重载 1-7 （在 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 <sstream>
#include <iostream>
#include <iomanip>
 
int main()
{
    std::cout << "no setw:" << 42 << '\n'
              << "setw(6):" << std::setw(6) << 42 << '\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
setw(6), several elements: 89    1234
Input from "hello, world" with setw(6) gave "hello"

参阅

width	管理域的宽度 (std::ios_base 的公开成员函数)
setfill	更改填充字符 (函数模板)
internalleftright	设置填充字符的布置 (函数)