QTextStreamだけじゃない！Qtにおけるテキスト・バイナリ処理の代替手法

2025-05-27

QTextStream (クラス) とは

QTextStreamは、Qtフレームワークが提供する便利なクラスで、テキストデータの読み書きを簡単に行うためのものです。ファイル、標準入出力（コンソール）、あるいはQByteArrayなどのデバイスに対して、テキストとしてフォーマットされたデータを扱う際に利用されます。

C++の標準ライブラリにあるstd::iostream（std::cin、std::cout、std::fstreamなど）に似ていますが、QTextStreamはQtのデータ型（QStringなど）との連携がより自然で、Unicodeや様々な文字エンコーディングの扱いを容易にするための機能が充実しています。

主な特徴とできること

デバイスへの接続
QFile（ファイル）、QIODevice（汎用的なI/Oデバイス）、QByteArray（メモリ上のバイト配列）、QString（文字列）など、様々なI/Oデバイスに接続して使用できます。
```
QFile file("output.txt");
if (file.open(QFile::WriteOnly | QFile::Text)) {
    QTextStream out(&file); // ファイルに接続
    out << "Hello, Qt!" << endl;
}
```

テキストの読み書き
C++のストリーム演算子（<<と>>）を使用して、テキストデータを読み書きできます。これにより、C++の組み込み型（int, doubleなど）やQtの主要なデータ型（QString, QVariantなど）を簡単にテキスト形式で処理できます。

// 書き込み
QTextStream out(stdout); // 標準出力に接続
QString name = "太郎";
int age = 30;
out << "名前: " << name << ", 年齢: " << age << "歳" << endl;

// 読み込み
QTextStream in(stdin); // 標準入力に接続
QString inputLine = in.readLine(); // 1行読み込み

フォーマット設定
数値の表示形式（基数、フィールド幅、精度など）、浮動小数点数の表記方法（固定小数点、科学表記など）などを設定できます。
```
QTextStream out(stdout);
out.setRealNumberPrecision(2); // 浮動小数点数の精度を2桁に設定
out << 3.14159265 << endl; // 出力: 3.14
```
行単位の読み書き
readLine()関数で1行ずつ読み込んだり、endlマニピュレータで行を終了させて改行を書き込んだりできます。

QTextStreamを使う利点

使いやすさ
C++のストリームに慣れている開発者にとっては直感的に使用できます。
Qtのデータ型との統合
QStringなどのQtの強力な文字列クラスとシームレスに連携できます。

バイナリデータには不向き
QTextStreamはテキストデータを扱うためのものであり、バイナリデータを読み書きするにはQDataStreamを使用するべきです。

文字化け（エンコーディングの問題）

原因
- 読み込み時と書き出し時で、QTextStreamに設定された文字エンコーディングが、実際のファイルのエンコーディングと一致していない。
- 異なるOS（WindowsとmacOS/Linux）間でファイルをやり取りする場合、デフォルトのエンコーディングが異なるために発生しやすい。
- ソースコードのエンコーディングと、QStringリテラルのエンコーディングが一致していない（これはQTextStream直接の問題ではないが、関連して文字化けを引き起こすことがある）。
- ファイルから読み込んだテキストが意味不明な記号や文字の羅列になる。
- 書き出したテキストファイルが、他のエディタで開くと文字化けする。
- 特定の文字（例: 「﨑」「髙」のような特殊な漢字や絵文字）だけが正しく表示されない。

ファイルが開けない、または読み書きできない

QTextStream自体はI/Oデバイスに接続して動作するため、根本的な問題はQFileなどのデバイス側にあることが多いです。

トラブルシューティング
1. QFile::open()の戻り値を確認
  常にif (!file.open(...))で成功を確認し、失敗した場合はQFile::errorString()でエラーメッセージを取得してデバッグ情報を出力します。
```
QFile file("non_existent_dir/output.txt"); // 例: 存在しないディレクトリ
if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
    qDebug() << "ファイルを開けませんでした:" << file.errorString();
    return;
}
```
2. 絶対パスを使用する
  相対パスは実行ファイルの場所によって変わるため、デバッグが難しい場合があります。開発中は一時的に絶対パスで試してみるのが有効です。
3. 権限の確認
  ファイルやディレクトリの読み書き権限を確認します。特にLinux/macOSでは注意が必要です。
4. QDir::mkpath()でディレクトリを作成する
  ファイル書き込み前に、対象ディレクトリが存在することを確認し、必要であれば作成します。
```
QDir dir(QFileInfo("output.txt").dir().path());
if (!dir.exists()) {
    dir.mkpath("."); // カレントディレクトリを作成
}
```
5. ファイルを確実に閉じる
  書き込み後、file.close()を呼び出すか、QFileオブジェクトがスコープを抜けるのを待ちます。QTextStreamは内部バッファを持つため、flush()を呼び出すことで明示的に書き込みを確定させることもできます。
原因
- パスの間違い
  ファイルが存在しない、または指定されたパスが間違っている。
- パーミッションの問題
  読み書き権限がない。
- ファイルロック
  他のプロセスがファイルをロックしている。
- オープンモードの不一致
  書き込みモードで開こうとしているのに、読み込みモードでしか開いていない、など。
- ディレクトリの存在
  書き込み先ディレクトリが存在しない。
症状
- QFile::open()がfalseを返す。
- QTextStreamへの書き込みが反映されない、または読み込みが空になる。

QTextStreamとQFileの内部状態の不一致

QTextStreamは内部にバッファを持っており、直接QFileのメソッド（例: QFile::readAll(), QFile::readLine())と併用すると、ストリームの位置がずれることがあります。

トラブルシューティング
1. どちらか一方に統一する
  QFileに接続されたQTextStreamを使用する場合は、そのファイルに対するすべての読み書き操作をQTextStreamを通して行うべきです。
```
QFile file("data.txt");
if (file.open(QIODevice::ReadWrite | QIODevice::Text)) {
    QTextStream stream(&file);

    // QTextStreamで書き込み
    stream << "ライン1" << endl;
    stream << "ライン2" << endl;
    stream.flush(); // バッファをフラッシュ

    // ポジションを先頭に戻す
    file.seek(0); // QIODevice::seek()はQTextStreamのバッファをクリアしません
    // QTextStream::seek()を使用する
    stream.seek(0);

    // QTextStreamで読み込み
    QString line1 = stream.readLine();
    QString line2 = stream.readLine();
    qDebug() << line1 << line2;
}
```
2. QTextStream::seek()を使用する
  ストリームの読み書き位置を変更したい場合は、QFile::seek()ではなくQTextStream::seek()を使用してください。これは内部バッファを適切に処理します。
3. 書き込み後のflush()とclose()
  書き込み操作後、ファイルにデータが確実に書き込まれたことを保証するために、QTextStream::flush()を呼び出すか、QFile::close()（またはQTextStreamオブジェクトの破棄）を行うことが重要です。
原因
- QTextStreamは自身のバッファを通じてI/Oを行うため、QFileの直接の操作はそのバッファを考慮しません。
症状
- QTextStreamで一部を読み込んだ後、QFileで残りを読もうとすると期待しない結果になる。
- QTextStreamで書き込み後、QFileで読み込もうとすると古いデータが見える、または何も見えない。

atEnd()の誤解（特にstdinの場合）

QTextStream::atEnd()は、ストリームの終わりに達したかどうかを判断しますが、stdin（標準入力）に対して使う場合に注意が必要です。

トラブルシューティング

stdinから読み込む場合は、atEnd()に頼るのではなく、readLine()が空の文字列を返すかどうかや、特定の終了条件（例: ユーザーが特定のコマンドを入力するまで）でループを抜けるようにします。

例:

QTextStream in(stdin);
qDebug() << "何か入力してください (終了するには 'quit' と入力):";
while (true) {
    QString line = in.readLine();
    if (line.isNull() || line.toLower() == "quit") { // line.isNull()はEOF（Ctrl+D/Zなど）の場合
        break;
    }
    qDebug() << "入力されたもの:" << line;
}

原因
- stdinは通常、入力が利用可能になるまでブロックします。QTextStreamは、まだ入力がない場合にatEnd()をtrueと報告することがあります。これは、データストリームの終わりを意味するのではなく、単に「現時点で読み込むデータがない」ことを意味します。
症状
- 標準入力から読み込んでいる最中なのに、atEnd()がtrueを返すことがある。

数値のパースエラー

文字列から数値を読み込む際に、予期しない値になることがあります。

トラブルシューティング
1. status()でエラーを確認
  QTextStream::status()を使って、読み込み操作後にエラーが発生していないか確認できます。
```
int value;
in >> value;
if (in.status() == QTextStream::ReadError) {
    qDebug() << "数値の読み込みエラー";
}
```
2. QString::toInt(), QString::toDouble()の利用
  行全体をreadLine()で読み込み、その後QStringのメソッド（toInt(), toDouble(), toLongLong()など）を使って数値をパースする方が、エラーハンドリングがしやすく安全です。これらのメソッドは変換の成功/失敗を示すブール値を返すオーバーロードを持ちます。
```
QString line = in.readLine();
bool ok;
int value = line.toInt(&ok);
if (!ok) {
    qDebug() << "数値への変換に失敗しました:" << line;
}
```
3. ロケールの影響の考慮
  浮動小数点数の小数点記号は、ロケールによって「.」（ピリオド）または「,」（カンマ）のどちらかになります。QTextStream::setLocale()を使用して、特定のロケール設定を強制できます。通常はQtがシステムのロケールを自動検出しますが、ファイルが特定のロケール形式で書かれている場合は明示的に設定すると良いでしょう。
原因
- 文字列に数値として解釈できない文字が含まれている。
- ロケール設定（小数点記号など）が影響している。
- ストリームの終わりに達しているのに読み込もうとしている。
症状
- stream >> intValue; のように読み込んだ値が0になったり、不正な値になる。

ファイルへのテキスト書き込み

最も基本的な例として、テキストをファイルに書き込む方法です。

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

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

    // 1. QFile オブジェクトの作成とファイル名の指定
    QString filename = "my_text_file.txt";
    QFile file(filename);

    // 2. ファイルを書き込みモードで開く
    // QIODevice::WriteOnly: 書き込み専用で開く
    // QIODevice::Text: テキストモードで開く（改行コードの自動変換など）
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        qDebug() << "ファイルを開けませんでした:" << file.errorString();
        return 1; // エラー終了
    }

    // 3. QTextStream オブジェクトを作成し、QFile に接続
    QTextStream out(&file);

    // 4. 文字エンコーディングの設定 (非常に重要！)
    // 日本語を扱う場合、UTF-8 を強く推奨します。
    // setCodec() を設定しない場合、システムのデフォルトロケールが使用されます。
    out.setCodec("UTF-8");

    // 5. テキストをストリームに書き込む
    // << 演算子を使って、QString, int, double など様々な型を書き込めます。
    // endl: 改行を書き込み、ストリームをフラッシュ（バッファの内容を書き出す）します。
    out << "こんにちは、Qt!" << endl;
    out << "これは QTextStream のサンプルです。" << endl;
    out << "数値: " << 12345 << endl;
    out << "浮動小数点数: " << 3.14159 << endl;
    out << "最後の行です。" << endl;

    // 6. ファイルを閉じる
    // QTextStream オブジェクトがスコープを抜けると自動的にフラッシュされ、
    // QFile オブジェクトがスコープを抜けると自動的に閉じられますが、
    // 明示的に閉じることをお勧めします。
    file.close();

    qDebug() << "ファイル '" << filename << "' に書き込みが完了しました。";

    return 0;
}

実行結果
my_text_file.txt というファイルが作成され、以下の内容が書き込まれます。

こんにちは、Qt!
これは QTextStream のサンプルです。
数値: 12345
浮動小数点数: 3.14159
最後の行です。

ファイルからのテキスト読み込み

先ほど書き込んだファイルを読み込む例です。

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

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

    QString filename = "my_text_file.txt";
    QFile file(filename);

    // 1. ファイルを読み込みモードで開く
    // QIODevice::ReadOnly: 読み込み専用で開く
    // QIODevice::Text: テキストモードで開く
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        qDebug() << "ファイルを開けませんでした:" << file.errorString();
        return 1;
    }

    // 2. QTextStream オブジェクトを作成し、QFile に接続
    QTextStream in(&file);

    // 3. 文字エンコーディングの設定 (書き込み時と同じエンコーディングにする)
    in.setCodec("UTF-8");

    // 4. テキストをストリームから読み込む
    qDebug() << "--- ファイル内容の読み込み ---";
    while (!in.atEnd()) { // ストリームの終わりに達するまでループ
        QString line = in.readLine(); // 1行ずつ読み込む
        qDebug() << line;
    }

    // 5. ファイルを閉じる
    file.close();

    qDebug() << "ファイルの読み込みが完了しました。";

    return 0;
}

実行結果

--- ファイル内容の読み込み ---
こんにちは、Qt!
これは QTextStream のサンプルです。
数値: 12345
浮動小数点数: 3.14159
最後の行です。
ファイルの読み込みが完了しました。

標準入出力（コンソール）での使用

QTextStream は stdin（標準入力）や stdout（標準出力）にも接続できます。

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

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

    // 標準出力への書き込み
    QTextStream cout(stdout);
    cout.setCodec("UTF-8"); // コンソールのエンコーディングに合わせる

    cout << "あなたの名前を入力してください: " << Qt::flush; // Qt::flush は endl と同じくバッファをフラッシュしますが、改行はしません。

    // 標準入力からの読み込み
    QTextStream cin(stdin);
    cin.setCodec("UTF-8"); // コンソールのエンコーディングに合わせる

    QString name = cin.readLine(); // 1行読み込む

    cout << "こんにちは、" << name << "さん！" << endl;

    // 数値を読み込む例
    cout << "年齢を入力してください: " << Qt::flush;
    bool ok;
    QString ageStr = cin.readLine();
    int age = ageStr.toInt(&ok); // 文字列から整数に変換

    if (ok) {
        cout << "あなたの年齢は " << age << " 歳ですね。" << endl;
    } else {
        cout << "無効な年齢が入力されました。" << endl;
    }

    return 0;
}

実行例（コンソールでの対話）

あなたの名前を入力してください: 太郎
こんにちは、太郎さん！
年齢を入力してください: 30
あなたの年齢は 30 歳ですね。

QString（文字列）への書き込みとからの読み込み

QTextStream は QString（文字列）にも直接接続できます。これは、メモリ内でテキストを整形したりパースしたりする場合に便利です。

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

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

    // --- QString への書き込み ---
    QString myString; // 空の QString を用意
    QTextStream out(&myString, QIODevice::WriteOnly); // QString に接続

    out.setCodec("UTF-8"); // 必要に応じてエンコーディング設定

    out << "名前: " << "山田 太郎" << endl;
    out << "年齢: " << 25 << "歳" << endl;
    out << "趣味: " << "読書, 映画鑑賞" << endl;

    // ストリームがスコープを抜けるか、明示的にフラッシュしないと
    // myString に内容は書き込まれない場合があります。
    out.flush(); // 明示的にフラッシュ

    qDebug() << "生成された文字列:\n" << myString;

    // --- QString からの読み込み ---
    QString data = "商品名: ノートPC\n価格: 85000\n在庫: True";
    QTextStream in(&data, QIODevice::ReadOnly); // 既存の QString に接続

    in.setCodec("UTF-8");

    QString productName;
    int price;
    bool inStock;

    // 1行目: 商品名
    QString line1 = in.readLine();
    if (line1.startsWith("商品名: ")) {
        productName = line1.mid(QString("商品名: ").length());
    }

    // 2行目: 価格
    QString line2 = in.readLine();
    if (line2.startsWith("価格: ")) {
        bool ok;
        price = line2.mid(QString("価格: ").length()).toInt(&ok);
        if (!ok) price = -1; // パース失敗
    }

    // 3行目: 在庫
    QString line3 = in.readLine();
    if (line3.startsWith("在庫: ")) {
        inStock = (line3.mid(QString("在庫: ").length()).toLower() == "true");
    }

    qDebug() << "\n--- 文字列からの読み込み結果 ---";
    qDebug() << "商品名:" << productName;
    qDebug() << "価格:" << price;
    qDebug() << "在庫:" << inStock;

    return 0;
}

生成された文字列:
 "名前: 山田 太郎
年齢: 25歳
趣味: 読書, 映画鑑賞
"

--- 文字列からの読み込み結果 ---
商品名: "ノートPC"
価格: 85000
在庫: true

QTextStream は、人間が読める形式のテキストデータ（例: 設定ファイル、ログファイル、CSVファイルなど）を扱うのに優れています。しかし、以下のようなケースでは、他の方法を検討する価値があります。

用途
Qt のデータ型（QPoint、QImage、カスタムクラスなど）を、プラットフォームに依存しないバイナリ形式で効率的に保存・復元したい場合。
代替
QDataStream
説明
QDataStream は、Qt の基本的なデータ型やカスタム型を、バイトオーダー（エンディアン）やデータ幅の違いを吸収してバイナリ形式で読み書きするためのクラスです。QTextStream がテキスト表現を扱うのに対し、QDataStream はデータの実際のバイナリ表現を扱います。パフォーマンスが重要で、ファイルが人間が読める必要がない場合に最適です。

例

#include <QFile>
#include <QDataStream>
#include <QPoint>
#include <QDebug>

// 書き込み
void writeBinaryData() {
    QFile file("data.bin");
    if (file.open(QIODevice::WriteOnly)) {
        QDataStream out(&file);
        out.setVersion(QDataStream::Qt_5_15); // Qtのバージョンを指定して互換性を保つ
        out << QPoint(10, 20) << QString("Hello Binary");
        file.close();
        qDebug() << "バイナリデータを書き込みました。";
    } else {
        qDebug() << "ファイルを開けませんでした (書き込み):" << file.errorString();
    }
}

// 読み込み
void readBinaryData() {
    QFile file("data.bin");
    if (file.open(QIODevice::ReadOnly)) {
        QDataStream in(&file);
        in.setVersion(QDataStream::Qt_5_15);
        QPoint p;
        QString s;
        in >> p >> s;
        file.close();
        qDebug() << "バイナリデータを読み込みました: Point =" << p << ", String =" << s;
    } else {
        qDebug() << "ファイルを開けませんでした (読み込み):" << file.errorString();
    }
}

構造化されたテキストデータ (JSON, XML) の処理

用途
設定、データ交換、Web APIとの連携など、JSON や XML 形式のデータを扱う場合。
代替
- JSON
  QJsonDocument, QJsonObject, QJsonArray
- XML
  QXmlStreamReader, QXmlStreamWriter (ストリームベース) または QDomDocument (DOMベース)
説明
- JSON
  Qt は JSON データを簡単にパース、生成、操作するための強力なクラスを提供しています。人間が読める形式でありながら、構造化されたデータ交換に適しています。
- XML
  XML は以前から広く使われている構造化データ形式です。Qt はストリームベースとDOMベースの2つの方法を提供します。ストリームベースはメモリ使用量が少なく、大規模なファイルに適しています。DOMベースはメモリにドキュメント全体をロードするため、小さなファイルや頻繁な変更に適しています。

JSONの例

#include <QFile>
#include <QJsonDocument>
#include <QJsonObject>
#include <QJsonArray>
#include <QDebug>

// JSON 書き込み
void writeJsonData() {
    QJsonObject rootObject;
    rootObject["name"] = "田中 太郎";
    rootObject["age"] = 30;

    QJsonArray hobbies;
    hobbies.append("読書");
    hobbies.append("旅行");
    rootObject["hobbies"] = hobbies;

    QJsonDocument doc(rootObject);
    QFile file("config.json");
    if (file.open(QIODevice::WriteOnly | QIODevice::Text)) {
        // toJson(QJsonDocument::Indented) で整形されたJSONを書き出す
        file.write(doc.toJson(QJsonDocument::Indented));
        file.close();
        qDebug() << "JSONデータを書き込みました。";
    } else {
        qDebug() << "ファイルを開けませんでした (JSON書き込み):" << file.errorString();
    }
}

// JSON 読み込み
void readJsonData() {
    QFile file("config.json");
    if (file.open(QIODevice::ReadOnly | QIODevice::Text)) {
        QByteArray jsonData = file.readAll();
        file.close();

        QJsonDocument doc = QJsonDocument::fromJson(jsonData);
        if (doc.isNull()) {
            qDebug() << "JSONのパースに失敗しました。";
            return;
        }

        if (doc.isObject()) {
            QJsonObject rootObject = doc.object();
            qDebug() << "名前:" << rootObject["name"].toString();
            qDebug() << "年齢:" << rootObject["age"].toInt();

            if (rootObject.contains("hobbies") && rootObject["hobbies"].isArray()) {
                QJsonArray hobbies = rootObject["hobbies"].toArray();
                QStringList hobbyList;
                for (const QJsonValue &value : hobbies) {
                    hobbyList.append(value.toString());
                }
                qDebug() << "趣味:" << hobbyList.join(", ");
            }
        }
    } else {
        qDebug() << "ファイルを開けませんでした (JSON読み込み):" << file.errorString();
    }
}

QTextStream は、人間が読めるテキストファイルを扱う際の「便利さ」と「Qtの型との親和性」が最大の強みです。しかし、以下の状況では、ここで挙げた代替手段を検討すると良いでしょう。

低レベルな制御/生のバイトデータ
QFile の直接メソッド
Qtに依存しない/シンプルなテキストI/O
C++標準ライブラリの std::fstream
構造化データ (JSON/XML)
QJsonDocument/QXmlStreamReader/QXmlStreamWriter
バイナリデータ
QDataStream

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