Qt QTextStream::padChar()徹底解説：テキスト整形とエラー対処法

2025-05-27

QTextStream::padChar() は、Qtの QTextStream クラスが提供する関数で、**フィールドの埋め草文字（パディング文字）**を取得するために使用されます。

QTextStream は、テキストの読み書きを行うための便利なインターフェースを提供します。特にテキストを整形して出力する際に、指定したフィールド幅に合わせて空白などを埋める「パディング」という機能があります。このパディングに使用される文字を設定したり、取得したりするのが padChar() および setPadChar() 関数です。

どのようなときに使うのか？

例えば、数字や文字列を特定の幅（例えば10文字）で揃えて出力したい場合、指定した幅に満たない部分を埋めるために使われます。

例

#include <QTextStream>
#include <QString>
#include <QDebug>

int main() {
    QString output;
    QTextStream stream(&output);

    // フィールド幅を10に設定し、右寄せにする
    stream.setFieldWidth(10);
    stream.setFieldAlignment(QTextStream::AlignRight);

    // デフォルトの埋め草文字（スペース）でパディング
    stream << "Hello" << "\n";
    stream << 123 << "\n";

    // 埋め草文字を '*' に設定
    stream.setPadChar('*');
    stream << "World" << "\n";
    stream << 45 << "\n";

    qDebug() << output;

    return 0;
}

出力例

"     Hello\n"
"       123\n"
"*****World\n"
"********45\n"

この例では、setPadChar('*') を呼び出すことで、それ以降の出力においてパディング文字がスペースから * に変更されていることがわかります。

padChar() 関数は、現在の QTextStream オブジェクトに設定されている埋め草文字を QChar 型で返します。通常、デフォルトではスペース ' ' が使用されます。

この埋め草文字は、setPadChar() 関数で変更することができます。
テキスト出力時のフィールドパディングに使用される現在の埋め草文字（パディング文字）を返します。
QTextStream クラスのメンバ関数です。

QTextStream::padChar() 自体が直接エラーを引き起こすことは稀ですが、パディング機能全体 (setFieldWidth(), setFieldAlignment() などを含む) の設定や使い方に関連して、期待通りの出力が得られない、または文字化けが発生するといった問題が起こることがあります。

意図しないパディング文字が表示される

問題
setPadChar() で指定したはずの文字が、出力結果に反映されていない、またはデフォルトのスペースが表示され続けている。

考えられる原因とトラブルシューティング

QChar 以外の型を渡している (C++)
setPadChar() は QChar 型の引数を取ります。誤って char 型などを渡した場合、意図しない文字がパディング文字として扱われる可能性があります（暗黙の型変換による）。 解決策: 必ず QChar 型のリテラル ('c') または QChar オブジェクトを渡すようにしてください。
```
// 良い例
stream.setPadChar('X');
stream.setPadChar(QChar(0x20)); // スペースのUnicode値

// 避けるべき例 (誤解を招く可能性)
// stream.setPadChar(97); // 'a' になるが、意図が不明瞭
```
フィールド幅が不足している
setFieldWidth() で設定したフィールド幅が、出力する文字列の長さよりも短い場合、パディングは行われません。パディングは、文字列がフィールド幅に満たない場合にのみ適用されます。 解決策: 出力したい文字列の長さを考慮し、適切な setFieldWidth() を設定してください。
```
QTextStream stream(&output);
stream.setPadChar('*');
stream.setFieldWidth(5); // フィールド幅が短い
stream << "LongString" << "\n"; // パディングは行われない

stream.setFieldWidth(12); // フィールド幅が適切
stream << "LongString" << "\n"; // ***LongString のようにパディングされる
```
setPadChar() の呼び出し位置
setPadChar() は、その後にストリームに書き込まれるデータに対して影響を与えます。もし、setPadChar() を呼び出す前にデータが書き込まれてしまうと、そのデータには以前のパディング文字（通常はスペース）が適用されてしまいます。 解決策: パディングを適用したい出力の前に、必ず setPadChar() を呼び出してください。
```
QTextStream stream(&output);
stream << "No padding char set yet: " << qSetFieldWidth(10) << "Data" << "\n"; // デフォルトのスペース
stream.setPadChar('*'); // ここで設定
stream << "Padding char set: " << qSetFieldWidth(10) << "Data" << "\n"; // ここから * が適用される
```

全くパディングが行われない

問題
setPadChar() も setFieldWidth() も設定しているのに、パディングが全く表示されない。

考えられる原因とトラブルシューティング

setFieldAlignment() の影響
setFieldAlignment() で QTextStream::AlignAbsolute や QTextStream::AlignLeft など、アラインメントの設定によってはパディングの動作が異なる場合があります。特に AlignLeft の場合、パディング文字は右側に埋められます。 解決策: 目的のアラインメントとパディングの組み合わせが正しいか確認してください。

QTextStream stream(&output);
stream.setPadChar('-');
stream.setFieldWidth(10);

stream.setFieldAlignment(QTextStream::AlignRight); // 右寄せ、左にパディング
stream << "Data" << "\n"; // ------Data

stream.setFieldAlignment(QTextStream::AlignLeft);  // 左寄せ、右にパディング
stream << "Data" << "\n"; // Data------

stream.setFieldAlignment(QTextStream::AlignCenter); // 中央寄せ、両側にパディング
stream << "Data" << "\n"; // ---Data---

setFieldWidth() が設定されていない
setPadChar() は単独では意味をなしません。パディングを機能させるためには、必ず setFieldWidth() でフィールド幅を指定する必要があります。 解決策: setFieldWidth() を忘れずに設定してください。
```
QTextStream stream(&output);
stream.setPadChar('-');
// stream.setFieldWidth(10); // これがないとパディングされない！
stream << "Data" << "\n";
```

文字化けが発生する

考えられる原因とトラブルシューティング

開発環境の文字コード設定
ソースコードファイルの文字コードが、コンパイラやQtが想定する文字コードと異なっている場合、QChar('あ') のようなリテラルが正しく解釈されず、意図しない文字が padChar として設定されることがあります。 解決策: 開発環境（IDEなど）の文字コード設定を、ソースコードのエンコーディング（通常はUTF-8 with BOMなし）と一致させてください。
エンコーディングの不一致
QTextStream はデフォルトでUTF-8を使用しますが、出力先のデバイス（ファイルやコンソール）のエンコーディングが異なる場合、文字化けが発生します。padChar() で設定する文字も、このエンコーディングの影響を受けます。 解決策: QTextStream::setEncoding() を使用して、出力先のエンコーディングと QTextStream のエンコーディングを一致させてください。
```
QTextStream stream(&output);
// システムのロケールに合わせたエンコーディングを使用
stream.setEncoding(QStringConverter::System);
// あるいは特定のエンコーディング（例: Shift-JIS）
// stream.setEncoding(QStringConverter::ShiftJis);

stream.setPadChar(QChar(L'あ')); // L'あ' でワイド文字リテラルを使用
stream.setFieldWidth(10);
stream << "データ" << "\n";
```
注意点: QChar は単一のUnicodeコードポイントを表します。絵文字などの複合文字を padChar として設定すると、期待通りの表示にならない場合があります。これは、QChar があくまで単一のコードポイントを扱うためです。

QTextStream の状態がリセットされる

問題
一度設定した padChar() や setFieldWidth() が、途中でリセットされてしまう。

考えられる原因とトラブルシューティング

新しい QTextStream オブジェクトの作成
別の QTextStream オブジェクトを作成した場合、それは独自の書式設定を持ち、前のオブジェクトの設定は引き継がれません。 解決策: 既存の QTextStream オブジェクトを使い続けるか、新しいオブジェクトにも同じ書式設定を適用してください。
reset() 関数
QTextStream::reset() 関数を呼び出すと、フィールド幅、アラインメント、数値の書式設定、パディング文字など、すべての書式設定がデフォルトの状態にリセットされます。 解決策: reset() を呼び出す場合は、その後で必要な書式設定を再度行う必要があります。意図せず reset() を呼び出していないか確認してください。

QTextStream::padChar() 自体はシンプルな機能ですが、setFieldWidth() や setFieldAlignment() との連携、そしてエンコーディングの問題が絡むと、複雑な挙動に見えることがあります。問題が発生した際は、以下の点を確認しながらトラブルシューティングを進めてください。

setPadChar() と setFieldWidth() はセットで設定されているか。
setPadChar() の呼び出しは、パディングを適用したい出力の前に行われているか。
フィールド幅は、出力する文字列の長さを考慮して適切に設定されているか。
QTextStream のエンコーディングと、出力先のエンコーディングは一致しているか。
reset() 関数を意図せず呼び出していないか。

QTextStream::padChar() は、主にテキストの書式設定、特にパディング（埋め草）を行う際に使用されます。ここでは、様々なシナリオでの使用例を紹介します。

基本的なパディング（スペース埋め）

最も一般的な使用例は、デフォルトのスペース文字でパディングを行う場合です。setPadChar() を明示的に呼ばなくても、デフォルトでスペースが使われます。

#include <QCoreApplication>
#include <QTextStream>
#include <QString>
#include <QDebug> // デバッグ出力用

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString outputString;
    QTextStream stream(&outputString);

    // フィールド幅を10文字に設定
    stream.setFieldWidth(10);

    // デフォルトのパディング文字（スペース）で右寄せ
    stream.setFieldAlignment(QTextStream::AlignRight);
    stream << "Hello" << "\n";
    stream << 123 << "\n";

    // 左寄せ
    stream.setFieldAlignment(QTextStream::AlignLeft);
    stream << "World" << "\n";
    stream << 456 << "\n";

    qDebug() << "--- 基本的なパディング (スペース) ---";
    qDebug().noquote() << outputString; // noquote() で QString の引用符を削除して表示

    return a.exec();
}

出力例

--- 基本的なパディング (スペース) ---
     Hello
       123
World     
456

パディング文字の変更

setPadChar() を使って、パディングに使う文字をスペース以外に変更する例です。

#include <QCoreApplication>
#include <QTextStream>
#include <QString>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString outputString;
    QTextStream stream(&outputString);

    stream.setFieldWidth(10);
    stream.setFieldAlignment(QTextStream::AlignRight);

    // パディング文字を '*' に設定
    stream.setPadChar('*');
    stream << "Item1" << "\n";
    stream << 789 << "\n";

    // パディング文字を '#' に変更し、左寄せ
    stream.setPadChar('#');
    stream.setFieldAlignment(QTextStream::AlignLeft);
    stream << "Item2" << "\n";
    stream << 1011 << "\n";

    // パディング文字を現在の設定から取得
    QChar currentPadChar = stream.padChar();
    qDebug() << "Current pad char:" << currentPadChar;

    qDebug() << "--- パディング文字の変更 ---";
    qDebug().noquote() << outputString;

    return a.exec();
}

出力例

Current pad char: '#' 
--- パディング文字の変更 ---
*****Item1
*******789
Item2#####
1011######

中央寄せでのパディング

QTextStream::AlignCenter を使用して、中央寄せでパディングを行う例です。この場合、左右にパディング文字が均等に（または片側に多く）配置されます。

#include <QCoreApplication>
#include <QTextStream>
#include <QString>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString outputString;
    QTextStream stream(&outputString);

    stream.setFieldWidth(15); // フィールド幅を少し広めに設定
    stream.setPadChar('-');
    stream.setFieldAlignment(QTextStream::AlignCenter);

    stream << "Centered Text" << "\n";
    stream << "Short" << "\n";
    stream << 12345 << "\n";

    qDebug() << "--- 中央寄せでのパディング ---";
    qDebug().noquote() << outputString;

    return a.exec();
}

出力例

--- 中央寄せでのパディング ---
-Centered Text-
-----Short-----
---12345----

qSetFieldWidth と qSetPadChar マニピュレータの使用

QTextStream は、qSetFieldWidth や qSetPadChar といったマニピュレータを提供しており、ストリームに直接挿入することで一時的に設定を変更できます。これは、特定の出力に対してのみ書式を適用したい場合に便利です。

#include <QCoreApplication>
#include <QTextStream>
#include <QString>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString outputString;
    QTextStream stream(&outputString);

    // デフォルトの設定 (スペース、幅0) で出力
    stream << "Default: " << "ValueA" << "\n";

    // マニピュレータを使って一時的に書式を設定
    stream << "Formatted: "
           << qSetFieldWidth(10) // フィールド幅を10に
           << qSetPadChar('=')   // パディング文字を '=' に
           << QTextStream::AlignLeft // 左寄せ
           << "ValueB" << "\n";

    // 別の書式を一時的に設定
    stream << "Another: "
           << qSetFieldWidth(8)  // フィールド幅を8に
           << qSetPadChar('.')   // パディング文字を '.' に
           << QTextStream::AlignRight // 右寄せ
           << "ValueC" << "\n";

    // ストリームの設定は、マニピュレータ適用後も継続される点に注意
    stream << "After manipulators: " << "ValueD" << "\n";

    qDebug() << "--- マニピュレータの使用 ---";
    qDebug().noquote() << outputString;

    return a.exec();
}

出力例

--- マニピュレータの使用 ---
Default: ValueA
Formatted: ValueB========
Another: .ValueC
After manipulators: .ValueD

重要な注意点
qSetFieldWidth や qSetPadChar のようなマニピュレータは、一度適用されると、その後のストリーム出力に影響を与え続けます。C++標準ライブラリの std::setw のように、次の要素にのみ適用されるわけではありません。そのため、特定のフィールドにのみパディングを適用したい場合は、その後に qSetFieldWidth(0) でフィールド幅をリセットするなどの工夫が必要です。

qSetFieldWidth(0) でフィールド幅をリセットする

上記の問題を解決するため、パディングを一時的に適用し、その後でフィールド幅をリセットする例です。

#include <QCoreApplication>
#include <QTextStream>
#include <QString>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString outputString;
    QTextStream stream(&outputString);

    stream << "Item: ";
    stream << qSetFieldWidth(10) // フィールド幅を10に設定
           << qSetPadChar('-')   // パディング文字を'-'に設定
           << QTextStream::AlignRight
           << "DATA"
           << qSetFieldWidth(0)  // フィールド幅を0にリセット (パディング無効化)
           << " (Processed)" << "\n"; // ここからはパディングなし

    stream << "Next Item: ";
    stream << "RawData" << "\n"; // パディングは適用されない

    qDebug() << "--- フィールド幅のリセット ---";
    qDebug().noquote() << outputString;

    return a.exec();
}

--- フィールド幅のリセット ---
Item: ------DATA (Processed)
Next Item: RawData

QTextStream::padChar() が行う「指定されたフィールド幅に達するまで文字を埋める」というパディング処理は、主に以下の方法で代替可能です。

QString のパディング関数 (QString::leftJustified, QString::rightJustified, QString::repeated)

QString クラス自体が、文字列のパディングや繰り返し生成のための便利なメソッドを提供しています。これらは QTextStream を介さずに直接 QString オブジェクトを操作するため、より柔軟な制御が可能です。

a. QString::leftJustified(width, fillChar, trunc) 文字列を左寄せにし、指定された width に達するまで fillChar で右側を埋めます。trunc が true の場合、width を超える部分は切り捨てられます。

b. QString::rightJustified(width, fillChar, trunc) 文字列を右寄せにし、指定された width に達するまで fillChar で左側を埋めます。

c. QString::repeated(count) 指定された回数だけ文字列を繰り返して新しい文字列を生成します。これをパディング文字として利用できます。

例

#include <QCoreApplication>
#include <QString>
#include <QDebug>

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    QString text = "Data";
    int width = 10;
    QChar fillChar = '*';

    // 左寄せ、右に '*' でパディング
    QString leftPadded = text.leftJustified(width, fillChar);
    qDebug() << "Left Justified:" << leftPadded; // "Data******"

    // 右寄せ、左に '*' でパディング
    QString rightPadded = text.rightJustified(width, fillChar);
    qDebug() << "Right Justified:" << rightPadded; // "******Data"

    // ' ' でパディング (デフォルト)
    QString defaultPadded = text.rightJustified(width);
    qDebug() << "Default Pad (Space):" << defaultPadded; // "      Data"

    // 繰り返し文字と組み合わせて中央寄せ (手動で計算)
    QString centerText = "Hello";
    int centerWidth = 15;
    QChar centerFillChar = '-';
    int padLength = centerWidth - centerText.length();
    int leftPad = padLength / 2;
    int rightPad = padLength - leftPad;

    QString centered = QString(centerFillChar).repeated(leftPad) +
                       centerText +
                       QString(centerFillChar).repeated(rightPad);
    qDebug() << "Centered (Manual):" << centered; // "----Hello----"

    return a.exec();
}

利点

結果が QString として直接得られるため、さらに加工しやすい。
より細かな制御が可能（例: trunc パラメータで切り捨てを制御）。
QTextStream の状態（フィールド幅やパディング文字）に影響されず、個々の文字列に対して独立してパディングを適用できる。

欠点

中央寄せは手動でパディング文字の数を計算する必要がある。
複数の項目をテーブル形式で整形する場合など、連続した出力には QTextStream の方が効率的かもしれない。

C++ 標準ライブラリのストリーム操作 (<iomanip>)

Qtアプリケーションでも、C++標準ライブラリのストリーム (std::cout, std::ofstream など) を使用する場合、<iomanip> ヘッダに含まれるマニピュレータを使ってパディングを行うことができます。

std::left, std::right, std::internal: アラインメントを設定します。
std::setfill(char): パディングに使用する文字を設定します。これは一度設定すると、明示的に変更しない限り有効です。
std::setw(width): 次に出力される項目のフィールド幅を設定します。QTextStream とは異なり、これは次の項目にのみ適用され、その後はリセットされます。

例

#include <iostream> // std::cout, std::endl
#include <iomanip>  // std::setw, std::setfill, std::left, std::right
#include <string>   // std::string

int main()
{
    std::string s1 = "Alpha";
    std::string s2 = "Beta";
    int i1 = 123;
    double d1 = 45.67;

    std::cout << "--- C++ Standard Stream Padding ---" << std::endl;

    // デフォルト (右寄せ、スペース埋め)
    std::cout << std::setw(10) << s1 << std::endl; // "     Alpha"

    // 左寄せ、スペース埋め
    std::cout << std::left << std::setw(10) << s2 << std::endl; // "Beta      "

    // 右寄せ、'*' で埋め
    std::cout << std::right << std::setfill('*') << std::setw(10) << i1 << std::endl; // "*******123"

    // 左寄せ、'-' で埋め
    std::cout << std::left << std::setfill('-') << std::setw(15) << d1 << std::endl; // "45.67----------"

    // setfill() は永続的、setw() は一時的
    std::cout << std::setw(10) << "Next" << std::endl; // "Next------" (setfill('-')が継続)

    // setfill() をリセット (デフォルトのスペースに戻す)
    std::cout << std::setfill(' ') << std::setw(10) << "Final" << std::endl; // "     Final"

    return 0;
}

利点

std::setw が次の項目にのみ適用されるため、より細かく書式を制御しやすい場合がある。
C++標準に準拠しており、Qtに依存しない。

欠点

出力先が std::cout や std::ofstream に限定される。
QDebug や QString との連携が QTextStream ほどシームレスではない。
Qtのシグナル/スロットやオブジェクトモデルとの直接的な統合はない。

手動での文字列操作

最も基本的な方法ですが、QString::arg() やループ、条件分岐を組み合わせて、手動でパディング文字列を構築することも可能です。

例

#include <QCoreApplication>
#include <QString>
#include <QDebug>

// 手動で右寄せパディングを行う関数
QString rightPad(const QString& text, int width, QChar fillChar) {
    if (text.length() >= width) {
        return text; // 幅より長い場合はそのまま返す
    }
    return QString(fillChar).repeated(width - text.length()) + text;
}

// 手動で左寄せパディングを行う関数
QString leftPad(const QString& text, int width, QChar fillChar) {
    if (text.length() >= width) {
        return text;
    }
    return text + QString(fillChar).repeated(width - text.length());
}

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    qDebug() << "--- 手動での文字列操作 ---";
    qDebug() << "Manual Right Pad:" << rightPad("Value", 10, '0'); // "00000Value"
    qDebug() << "Manual Left Pad:" << leftPad("Key", 8, '_');     // "Key_____"

    // QString::sprintf や arg() を使った例（少し複雑）
    QString formattedString = QString("%1").arg("Name", -10, QChar('.')); // 左寄せ、'.'でパディング
    qDebug() << "QString::arg():" << formattedString; // "Name......"

    // 数値のゼロ埋め (よくあるパターン)
    int number = 7;
    QString zeroPaddedNum = QString("%1").arg(number, 3, QChar('0'), QChar::AlignRight); // 3桁で右寄せ、'0'埋め
    qDebug() << "Zero-padded Number:" << zeroPaddedNum; // "007"

    return a.exec();
}

利点

Qtや標準ライブラリの特定のストリームインターフェースに縛られない。
最大限の柔軟性があり、あらゆるパディングロジックを実装できる。

デバッグが複雑になる可能性がある。
コード量が増え、汎用的な処理を書くのが面倒になる。

Qt QTextStream::device()徹底解説: テキスト処理の核となるQIODeviceとは？

もう少し詳しく説明します。QTextStreamは、テキストデータ（文字の並び）を読み書きするための便利なクラスです。ファイル、ネットワークソケット、メモリ上のデータなど、様々な「デバイス」に対して、統一された方法でテキストを扱うことができます。

Qt QTextStreamの一般的なエラーとトラブルシューティング：デストラクタの役割とは？

QtプログラミングにおけるQTextStream::~QTextStream()は、QTextStreamクラスのデストラクタを指します。C++では、クラス名にチルダ（~）を付けたものがデストラクタです。デストラクタは、そのクラスのオブジェクトが破棄される際に自動的に呼び出される特殊なメンバ関数です。

Qtプログラミング必見！QTextStreamとエンコーディングの代替手法

QTextStream::encoding()は、QTextStreamオブジェクトが現在使用しているテキストエンコーディング（文字コード）を取得するための関数です。QTextStreamは、Qtフレームワークでテキストの読み書きを行うためのクラスです。QFileなどのQIODevice（入出力デバイス）と連携して動作し、ファイルや文字列などのテキストデータを簡単に扱うことができます。

QTextStream::fieldAlignment()

具体的には、以下のいずれかの値を返します。QTextStream::AlignTrailing: 数値の場合、符号や基数プレフィックスが数値の直前に表示され、全体が右寄せされます。文字列の場合はAlignRightと同じです。QTextStream::AlignLeading: 数値の場合、符号や基数プレフィックス（例: "0x"）がフィールドの先頭に表示され、残りの部分は右寄せされます。文字列の場合はAlignLeftと同じです。

QTextStream::fieldWidth()でつまずかない！Qtのテキスト出力エラーと解決策

QTextStream::fieldWidth() は、Qtの QTextStream クラスのメンバ関数で、現在設定されている「フィールド幅」を返します。QTextStream は、ファイルやデバイス、文字列などに対してテキストの読み書きを行うためのクラスです。テキストを出力する際に、特定のフォーマットで出力したい場合に、この「フィールド幅」という概念が重要になります。

QTextStream::flush()は必要？Qtファイル書き込みのベストプラクティス

QTextStreamは、ファイルやデバイスに対してテキストデータを読み書きするためのQtのクラスです。データを書き込む際、通常はすぐに物理的なファイルやデバイスに書き込まれるわけではありません。効率化のため、データは一度「バッファ」と呼ばれる一時的なメモリ領域に蓄えられます。

日本語対応も安心！Qt QTextStreamでのBOM生成とエンコーディングのベストプラクティス

BOM は、Unicode テキストファイルで、そのファイルがどの UTF (UTF-8, UTF-16, UTF-32 など) でエンコードされているか、そしてバイトの順序 (エンディアン、Big-Endian か Little-Endian か) がどうなっているかを示すために、ファイルの先頭に挿入される特別なバイト列です。

QTextStreamで進数を操る：integerBase()とsetIntegerBase()の使い方

具体的には以下の通りです。基数の設定 setIntegerBase()関数を使って、読み書きする整数の基数を明示的に設定できます。例えば、16進数で読み書きしたい場合はsetIntegerBase(16)と設定します。デフォルトの動作読み取り時デフォルトでは0が返されます。これは、QTextStreamが数値のプレフィックス（例：0xは16進数、0から始まる場合は8進数）を自動的に検出して基数を判断することを意味します。書き込み時デフォルトでは10（10進数）が使用されます。

QtプログラミングにおけるQTextStream::locale()徹底解説

ロケールとは、ある特定の地域や文化圏における言語、日付と時刻の形式、数値の表現方法（小数点や桁区切り）、通貨記号などの慣習を定義する情報のことです。例えば、日本では小数点にピリオドを、桁区切りにカンマを使うのが一般的ですが、ヨーロッパの一部では小数点にカンマを、桁区切りにピリオドを使う場合があります。

【Qt入門】QTextStream::numberFlags()を使った数値出力のカスタマイズ方法

QTextStream::numberFlags() は、Qt プログラミングにおける QTextStream クラスのメンバ関数で、数値の出力形式を制御するためのフラグ群を取得します。QTextStream は、テキストの読み書きを便利に行うためのクラスで、ファイル、バイト配列、QString など、様々なI/Oデバイスを扱えます。数値を出力する際に、例えば16進数で表示するか、常に符号を表示するか、小数点以下の桁数を強制するか、といった細かな設定をしたい場合に numberFlags() で現在の設定を取得し、setNumberFlags() で変更します。