C++ setw() 関数はフィールドの幅を設定するために使用されます。構文形式は次のとおりです:

setw(n)

n は幅を表し、数値で指定します。

setw() 関数は、直後の出力にのみ影響します。

直後の出力フィールドの長さが n より小さい場合、そのフィールドの前にスペースを埋めて補います。出力フィールドの長さが n より大きい場合は、全体がそのまま出力されます。

以下の例は、setw() 関数の使用法を示しています:

例

#include <iostream>
#include <iomanip>

using namespace std;

int main()
{
    // 先頭に幅4を設定しますが、後続の サンプル の文字長が4より大きいため、効果がありません
    cout << setw(4) << "サンプル" << endl;
    // 中間位置に幅4を設定しますが、後続の サンプル の文字長が4より大きいため、効果がありません
    cout << "サンプル" << setw(4) << "サンプル" << endl;
    // 先頭に間隔14を設定します。後続の サンプル の文字数は6なので、前に8つのスペースを補います
    cout << setw(14) << "サンプル" << endl;
    // 中間位置に間隔14を設定します。後続の サンプル の文字数は6なので、前に8つのスペースを補います
    cout << "サンプル" << setw(14) << "サンプル" << endl;
    return 0;
}

上記コードの出力結果は次のとおりです:

サンプル
サンプルサンプル
        サンプル
サンプル        サンプル

setw() のデフォルトの埋め込み内容はスペースであり、setfill()組み合わせて使用することで、他の文字を埋め込むように設定できます。

例

#include <iostream>
#include <iomanip>

using namespace std;

int main()
{
    cout << setfill('*')  << setw(14) << "サンプル" << endl;
    return 0;
}

上記コードの出力結果は次のとおりです:

********サンプル