QTextStreamのエラーはこれで解決！Status列挙型と代替メソッド詳解

2025-05-27

`enum QTextStream::Status` のメンバー

QTextStream オブジェクトの status() メソッドを呼び出すことで、現在のストリームの状態を取得できます。これにより、読み書き操作が成功したかどうか、またはどのような種類のエラーが発生したかを確認し、適切なエラー処理を行うことができます。

#include <QFile>
#include <QTextStream>
#include <QDebug>

int main() {
    QFile file("my_file.txt");

    // 書き込みの例
    if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        QTextStream out(&file);
        out << "Hello, Qt!";
        if (out.status() == QTextStream::Ok) {
            qDebug() << "書き込み成功: " << out.status();
        } else {
            qDebug() << "書き込みエラー: " << out.status();
        }
        file.close();
    } else {
        qDebug() << "ファイルオープンエラー (書き込み)";
    }

    // 読み込みの例
    if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        QTextStream in(&file);
        QString line = in.readLine();
        if (in.status() == QTextStream::Ok) {
            qDebug() << "読み込み成功: " << line << ", Status: " << in.status();
        } else if (in.status() == QTextStream::ReadPastEnd) {
            qDebug() << "読み込み終端に到達: " << in.status();
        } else if (in.status() == QTextStream::ReadCorruptData) {
            qDebug() << "破損データ読み込みエラー: " << in.status();
        } else {
            qDebug() << "読み込みエラー: " << in.status();
        }
        file.close();
    } else {
        qDebug() << "ファイルオープンエラー (読み込み)";
    }

    return 0;
}

`QTextStream::Status` に関連する一般的なエラーとトラブルシューティング

QTextStream::Ok ではない場合

最も基本的なエラーは、操作後に status() が QTextStream::Ok 以外の値を返す場合です。これは何らかの問題が発生したことを示しています。

トラブルシューティング
- QIODevice の確認
  まず、QTextStream が操作している基となる QIODevice (例: QFile) の状態を確認します。QFile::open() の戻り値や QFile::error() メソッドを使用して、ファイルオープン自体が成功しているかを確認してください。
- パスの確認
  ファイルパスが正しいか、誤字脱字がないかを確認します。相対パスを使用している場合は、カレントディレクトリが想定通りかを確認してください。
- アクセス権限の確認
  アプリケーションがファイルに対して読み書きの権限を持っているかを確認します。特に、書き込み操作で WriteFailed が返される場合は、権限の問題が考えられます。
- ディスク容量の確認
  書き込み操作の場合、ディスクに十分な空き容量があるかを確認します。
- ファイルのロック
  他のアプリケーションやプロセスがファイルを開いているために、アクセスできない場合があります。
- エラーメッセージの表示
  ユーザーフレンドリーなエラーメッセージを表示し、ユーザーに問題解決のためのヒントを提供することが重要です。
- ファイルが見つからない、またはアクセス権限がない。
- ディスク容量が不足している。
- デバイスが切断された（例：USBドライブ）。
- ファイルが他のプロセスによってロックされている。
- エンコーディングの問題。

QTextStream::ReadPastEnd

データの終端を超えて読み込みを試みた場合に発生します。

トラブルシューティング
- atEnd() の使用
  読み込みループに入る前に、または各読み込み操作の前に QTextStream::atEnd() を使用して、ストリームの終わりに達しているかどうかを確認します。
```
QTextStream in(&file);
while (!in.atEnd()) {
    QString line = in.readLine();
    // データの処理
}
```
- readLineInto() の使用
  Qt 5.9以降では、QTextStream::readLineInto(QString *line) メソッドが便利です。これは、読み込みが成功した場合に true を返し、終端に達した場合やエラーが発生した場合に false を返します。
```
QTextStream in(&file);
QString line;
while (in.readLineInto(&line)) {
    // データの処理
}
```
- データ構造の整合性
  ファイルのデータ構造が期待通りであることを確認します。例えば、行数をカウントしているのに、ファイルが途中で終わっているような場合。
一般的な原因
- ファイルの終わりに達した後、さらに読み込み操作（例: readLine(), readAll(), operator>>) を行った。
- ループ処理の条件が適切でなく、データの終わりを検出する前に読み込みを続行している。

QTextStream::ReadCorruptData

ストリームが破損したデータを読み込もうとした場合に発生します。これは通常、エンコーディングの問題と関連しています。

トラブルシューティング
- エンコーディングの確認と設定
  - ファイルを読み込む際に、正しいエンコーディング（例: UTF-8, Shift-JIS, EUC-JP）を指定しているか確認します。QTextStream::setCodec() を使用して明示的にエンコーディングを設定します。
```
QTextStream in(&file);
// 例えばUTF-8のファイルを読み込む場合
in.setCodec("UTF-8");
// または、特定のロケールに合わせる場合
// in.setCodec(QTextCodec::codecForLocale());
```
  - Windows環境で作成されたテキストファイル（UTF-8 BOM付きなど）をLinuxで読み込む場合など、プラットフォーム間でエンコーディングの違いが生じやすいので注意が必要です。
- バイナリファイルの読み込み
  バイナリファイルを扱う場合は、QTextStream ではなく QDataStream や QFile の read() / write() メソッドを直接使用することを検討してください。QTextStream はテキストデータに特化しています。
- データソースの確認
  データが破損している場合は、そのデータがどこから来たのか（ダウンロード、他のアプリケーションからのエクスポートなど）を確認し、データ生成元に問題がないか調査します。
一般的な原因
- ファイルが想定しているエンコーディング（文字コード）と異なるエンコーディングで保存されている。
- バイナリファイルに対してテキストストリームとして読み込みを試みている。

QTextStream::WriteFailed

基となるデバイスへの書き込みに失敗した場合に発生します。

トラブルシューティング
- QIODevice の確認
  QFile::open() が成功したか、QFile::error() でエラータイプを確認します。
- ディスク容量
  書き込みを行う前に、ターゲットドライブに十分な空き容量があるかを確認します。
- 書き込み権限
  アプリケーションがターゲットディレクトリへの書き込み権限を持っているかを確認します。特にシステムディレクトリや保護された場所への書き込みは制限されている場合があります。
- ファイルのロック
  他のプロセスがファイルを開いている可能性があります。もし可能であれば、ファイルを閉じるようにユーザーに促すか、一時ファイルを使用するなどの対策を検討します。
- パスの有効性
  ファイルパスにオペレーティングシステムで許可されない文字が含まれていないかを確認します。
- flush() の使用
  QTextStream は内部バッファを持っています。書き込み操作後に flush() を呼び出して、バッファの内容を強制的にデバイスに書き出すことで、リアルタイムなエラー検出に役立つ場合があります。ただし、頻繁な flush() はパフォーマンスに影響を与える可能性があります。通常はファイルクローズ時に自動的にフラッシュされます。
一般的な原因
- ディスクの空き容量不足。
- ファイルへの書き込み権限がない。
- ファイルが他のプロセスによってロックされている。
- ネットワークドライブやUSBドライブが切断された。
- ファイルパスが無効である（例：不正な文字が含まれている）。

例外処理
Qt はC++の例外を使用しないのが一般的ですが、QTextStream::status() を確認することで、エラー処理をコードに組み込むことができます。
バッファリング
QTextStream は内部的にバッファリングを行います。これによりパフォーマンスが向上しますが、エラーがすぐに報告されない場合があります。特に書き込みエラーの場合、flush() を明示的に呼び出すか、ファイルを閉じるまで WriteFailed が検出されないことがあります。
QFile::open() と QTextStream::status()
QFile::open() が成功したとしても、その後に QTextStream を介した操作でエラーが発生することはあり得ます。そのため、QFile::open() のチェックだけでなく、QTextStream::status() も適宜確認することが重要です。

ファイルへの書き込みと WriteFailed の検出

この例では、ファイルにテキストを書き込み、書き込み操作が失敗した場合（例: ディスク容量不足、アクセス権限なし）に QTextStream::WriteFailed を検出する方法を示します。

#include <QCoreApplication>
#include <QFile>
#include <QTextStream>
#include <QDebug>
#include <QDir> // QDir::homePath() を使用するために必要

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

    // 書き込みテスト用のファイルパス
    // 存在しないディレクトリを指定するなどして、書き込み失敗をシミュレートできます
    // 例: QDir::homePath() + "/non_existent_dir/output.txt"
    // または、読み取り専用の場所に書き込もうとする
    QString filePath = QDir::homePath() + "/my_output_file.txt"; // 通常は書き込み可能な場所

    QFile file(filePath);
    QTextStream out(&file);

    // ファイルを書き込みモードで開く
    // QIODevice::Truncate はファイルが存在すれば内容を消去します
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text | QIODevice::Truncate)) {
        qDebug() << "エラー: ファイルを開けませんでした。理由:" << file.errorString();
        return 1; // アプリケーション終了
    }

    qDebug() << "ファイルを開きました: " << filePath;

    // テキストを書き込む
    out << "これはテスト用のテキストです。\n";
    out << "Qt QTextStream::Status の例。\n";

    // 強制的にバッファをフラッシュしてステータスを確認
    // 通常はファイルクローズ時に自動的にフラッシュされますが、
    // 書き込みエラーを早期に検出するために役立つ場合があります。
    out.flush();

    // QTextStream のステータスを確認
    if (out.status() == QTextStream::Ok) {
        qDebug() << "書き込み成功！";
    } else if (out.status() == QTextStream::WriteFailed) {
        qDebug() << "エラー: 書き込みに失敗しました！ QTextStream::WriteFailed.";
        qDebug() << "QFileエラー:" << file.errorString(); // QIODevice のエラーも確認
    } else {
        qDebug() << "エラー: 不明な QTextStream ステータス:" << out.status();
    }

    file.close(); // ファイルを閉じる
    qDebug() << "ファイルを閉じました。";

    return 0; // アプリケーション終了
}

シミュレーション方法

読み取り専用のファイルシステムに書き込もうとすると、QTextStream::WriteFailed が発生する可能性があります。
存在しないディレクトリに書き込もうとすると、QFile::open() が失敗する可能性があります。

ファイルからの読み込みと ReadPastEnd、ReadCorruptData の検出

この例では、ファイルからテキストを読み込み、読み込みの終端に達した場合 (ReadPastEnd) や、エンコーディングの問題などでデータが破損していると判断された場合 (ReadCorruptData) を検出する方法を示します。

#include <QCoreApplication>
#include <QFile>
#include <QTextStream>
#include <QDebug>
#include <QDir>
#include <QTextCodec> // エンコーディング設定のために必要

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

    QString filePath = QDir::homePath() + "/my_input_file.txt"; // 読み込みテスト用のファイルパス

    // テスト用のファイルを作成（異なるエンコーディングで保存するなどして、ReadCorruptDataをシミュレートできます）
    QFile initialFile(filePath);
    if (initialFile.open(QIODevice::WriteOnly | QIODevice::Text | QIODevice::Truncate)) {
        QTextStream out(&initialFile);
        out.setCodec("UTF-8"); // UTF-8 で書き込む
        out << "1行目のテキスト\n";
        out << "2行目のテキスト\n";
        out << "3行目のテキスト\n";
        initialFile.close();
        qDebug() << "テストファイルを作成しました: " << filePath;
    } else {
        qDebug() << "エラー: テストファイルを作成できませんでした。";
        return 1;
    }

    QFile file(filePath);
    QTextStream in(&file);

    // ファイルを読み込みモードで開く
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        qDebug() << "エラー: ファイルを開けませんでした。理由:" << file.errorString();
        return 1;
    }

    qDebug() << "ファイルを開きました: " << filePath;

    // エンコーディングを設定 (例: シミュレーションのため、意図的に間違ったエンコーディングを設定)
    // in.setCodec("Shift-JIS"); // これをコメントアウトしてUTF-8のファイルをShift-JISで読もうとするとReadCorruptDataが発生する可能性あり
    in.setCodec("UTF-8"); // 正しいエンコーディング

    QString line;
    int lineNumber = 0;

    while (!in.atEnd()) {
        line = in.readLine();
        lineNumber++;
        qDebug() << "読み込み行 " << lineNumber << ": " << line;

        // 各読み込み操作の後にステータスを確認
        if (in.status() == QTextStream::Ok) {
            // 正常
        } else if (in.status() == QTextStream::ReadPastEnd) {
            qDebug() << "注意: データの終端を超えて読み込みを試みました (理論上は atEnd() で回避されるはず)。";
            break;
        } else if (in.status() == QTextStream::ReadCorruptData) {
            qDebug() << "エラー: 破損したデータを読み込みました！ (エンコーディングの問題の可能性)";
            qDebug() << "現在のコーデック: " << in.codec()->name();
            break;
        } else {
            qDebug() << "エラー: 不明な QTextStream ステータス:" << in.status();
            break;
        }
    }

    // ループ終了後の最終ステータス確認 (atEnd() が true になったことによる終了を想定)
    if (in.status() == QTextStream::Ok) {
        qDebug() << "ファイル全体を正常に読み込みました。";
    } else if (in.status() == QTextStream::ReadPastEnd) {
        qDebug() << "読み込み終端に達しました。正常終了です。";
    } else {
        qDebug() << "最終的な QTextStream ステータスが Ok ではありません:" << in.status();
    }

    file.close();
    qDebug() << "ファイルを閉じました。";

    return 0;
}

シミュレーション方法

ReadPastEnd
while (!in.atEnd()) の条件を削除して、in.readLine() をファイル終端に達した後も呼び出そうとすると発生しますが、通常は atEnd() で適切に制御されるため、このエラーは直接的に検出されることは少ないです。主な用途は、意図せずに終端を読み過ぎた場合にそれが分かる、というものです。

デバッグ時に QTextStream::Status の値が何を意味するのかを分かりやすくするために、列挙型を文字列に変換する関数を用意すると便利です。

#include <QString>
#include <QTextStream>

// QTextStream::Status を可読な文字列に変換するヘルパー関数
QString statusToString(QTextStream::Status status) {
    switch (status) {
        case QTextStream::Ok:
            return "Ok";
        case QTextStream::ReadPastEnd:
            return "ReadPastEnd";
        case QTextStream::ReadCorruptData:
            return "ReadCorruptData";
        case QTextStream::WriteFailed:
            return "WriteFailed";
        default:
            return QString("Unknown Status (%1)").arg(static_cast<int>(status));
    }
}

この関数を上記の例で使用すると、qDebug() << "書き込みエラー: " << statusToString(out.status()); のように、より分かりやすい出力が得られます。

`QTextStream::Status` を補完・代替するアプローチ

基底デバイス QIODevice のエラーチェック

QTextStream は、QFile や QTcpSocket などの QIODevice のサブクラス上で動作します。そのため、QTextStream のエラーは、多くの場合、基となる QIODevice のエラーに起因します。

QIODevice::errorString()
QIODevice の errorString() メソッドは、現在のエラーに関するユーザーフレンドリーな説明文字列を返します。これはデバッグやユーザーへのフィードバックに非常に役立ちます。
```
QFile file("non_existent_directory/output.txt");
if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    qDebug() << "エラーが発生しました: " << file.errorString();
    // 例: "No such file or directory"
}
```

QIODevice::error()
QIODevice クラス（QFile が継承している）には、QIODevice::FileError 列挙型を返す error() メソッドがあります。これにより、より詳細なファイル関連のエラータイプ（例: QFile::ReadError, QFile::WriteError, QFile::PermissionsError, QFile::OpenError など）を知ることができます。

QFile file("path/to/file.txt");
if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    qDebug() << "ファイルオープンエラー:" << file.errorString();
    // file.error() で具体的なエラーコードを取得
    if (file.error() == QFile::PermissionsError) {
        qDebug() << "権限がありません。";
    }
    return;
}
QTextStream out(&file);
out << "Some text.";
out.flush(); // 強制的に書き込みを試みる
if (out.status() == QTextStream::WriteFailed) {
    qDebug() << "QTextStream書き込み失敗。QFileエラーも確認:";
    qDebug() << file.errorString(); // こちらも確認
}
file.close();

QFile::open() の戻り値の確認
ファイルを開く際に、QFile::open() メソッドが成功したかどうかを最初に確認することが非常に重要です。これが失敗している場合、QTextStream を使った操作はそもそも不可能です。

QFile file("path/to/file.txt");
if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
    // ファイルが開けなかった場合のエラー処理
    qDebug() << "ファイルを開けませんでした:" << file.errorString();
    return;
}
// ここで QTextStream を使う
QTextStream in(&file);
// ...

読み込み操作の戻り値の利用

QTextStream の特定の読み込みメソッドは、操作が成功したかどうかを示す戻り値を持ちます。これらの戻り値をチェックすることで、一部の QTextStream::Status のケース（特に ReadPastEnd）を間接的に処理できます。

QTextStream::operator>>(type) の評価
C++ストリームと同様に、QTextStream の operator>> はストリームオブジェクトの参照を返します。この参照を bool コンテキストで評価することで、最後の操作が成功したかどうかを大まかに確認できます。ただし、これは非常に限定的であり、詳細なエラー情報（具体的にどのようなエラーか）は提供しません。
```
QTextStream in(&file);
int value;
if (in >> value) { // 読み込みが成功したか
    qDebug() << "数値を読み込みました: " << value;
} else {
    qDebug() << "数値の読み込みに失敗しました。";
    // この場合、in.status() を確認することで、具体的なエラー（例: 無効な数値形式）を特定できる
}
```

QTextStream::readLineInto(QString *target)
Qt 5.9 以降で導入されたこのメソッドは、行の読み込みに成功した場合は true を、読み込むべきデータが残っていない場合やエラーが発生した場合は false を返します。これは、atEnd() と readLine() を組み合わせたような、より簡潔なエラーチェックを提供します。

QTextStream in(&file);
QString line;
while (in.readLineInto(&line)) {
    qDebug() << "読み込んだ行: " << line;
}
// ここで in.status() が Ok 以外の場合、何らかのエラー（例: ReadCorruptData）が発生したと判断できる
if (in.status() != QTextStream::Ok && in.status() != QTextStream::ReadPastEnd) {
    qDebug() << "読み込み中にエラーが発生しました。ステータス:" << in.status();
}

QTextStream::atEnd()
これは最も一般的な代替手段であり、ファイル読み込みループで広く使用されます。ストリームの終わりに達したかどうかを判断します。これにより、ReadPastEnd ステータスになる前に読み込みを停止できます。

QTextStream in(&file);
while (!in.atEnd()) { // データの終わりに達していない間はループを続ける
    QString line = in.readLine();
    qDebug() << "読み込んだ行: " << line;
}
qDebug() << "ファイルの終わりに到達しました。";
// この時点で in.status() は QTextStream::Ok または QTextStream::ReadPastEnd になるはずです

個別のデータ変換の成功確認

QTextStream を使って文字列から数値などに変換する場合、QString の提供する変換メソッド（例: toInt(), toDouble()）の成功フラグを利用します。これは ReadCorruptData の原因となる可能性のある、データフォーマットの問題を特定するのに役立ちます。

QTextStream in(&file);
QString line = in.readLine();
bool ok;
int number = line.toInt(&ok); // 変換が成功したかどうかを 'ok' で受け取る
if (ok) {
    qDebug() << "数値を正常にパースしました: " << number;
} else {
    qDebug() << "文字列から数値への変換に失敗しました: " << line;
    // この場合、QTextStream::ReadCorruptData は発生しないかもしれないが、
    // 論理的なデータの破損（期待するフォーマットではない）を検出できる
}

特定のデータ型への変換エラー
QString::toInt(&ok) のような変換メソッドの成功フラグは、ストリーム自体がエラーでなくても、読み込んだデータが期待されるフォーマットではない場合に特に有効です。
読み込みループの場合
QTextStream::atEnd() を読み込みループの条件として使用することは必須です。そして、ループの終了後や、予期せぬ break の後に QTextStream::status() を確認することで、ReadPastEnd 以外のエラー（例えば、エンコーディングの問題による ReadCorruptData）が発生していないかを確認できます。Qt 5.9以降では readLineInto() も非常に便利です。
最も包括的なアプローチ
ファイルを開く際に QFile::open() と QFile::errorString() を確認し、その後 QTextStream の各操作後に QTextStream::status() をチェックするのが最も推奨される方法です。これにより、ファイルシステムレベルのエラーと、テキストストリームレベルのデータ整合性エラーの両方を捕捉できます。

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() で変更します。