std::setw

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (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>
/* 未指定 */ 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++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 183	C++98	setw 只能與流一起使用 型別 std::ostream 或 std::istream	可用於任何 字元流

另請參閱

width	管理欄位寬度 (std::ios_base 的公共成員函式)
setfill	更改填充字元 (函式模板)
internalleftright	設定填充字元的位置 (函式)
showbasenoshowbase	控制是否使用字首指示數字基數 (函式)