QDebug Class

メンバ関数のドキュメント

[explicit, since 6.9] QDebug::QDebug(QByteArray *byteArray)

指定されたbyteArray に書き込むデバッグストリームを構築します。

データはUTF-8でエンコードされますが、Windowsなどでは、システムのロケールとは異なる場合があります。

このコンストラクタでインスタンス化されたオブジェクトの場合、データはバッファに格納され、Qt::flush などを使用してストリームがフラッシュされるまでバイト配列には書き込まれません。

この関数は Qt 6.9 で導入されました。

QTextStream manipulatorsも参照してください 。

[explicit] QDebug::QDebug(QIODevice *device)

指定されたdevice に書き込むデバッグストリームを作成します。

[explicit] QDebug::QDebug(QString *string)

指定されたstring に書き込みを行うデバッグストリームを構築します。

[explicit] QDebug::QDebug(QtMsgType t)

メッセージタイプ `t` のハンドラへ書き込みを行うデバッグストリームを構築します。

QDebug::QDebug(const QDebug &o)

別のデバッグストリーム `o` のコピーを作成します。

[noexcept] QDebug::~QDebug()

書き込み待ちのデータをすべてフラッシュし、デバッグストリームを破棄します。

bool QDebug::autoInsertSpaces() const

このQDebug インスタンスが書き込みの間に自動的にスペースを挿入するかどうかを判定し、true を返します。

setAutoInsertSpaces() およびQDebugStateSaverも参照してください 。

QDebug &QDebug::maybeQuote(char c = '"')

引用符の自動挿入に関する現在の設定に応じて、文字「c 」をデバッグストリームに書き込み、そのストリームへの参照を返します。

デフォルトの文字は二重引用符" です。

quote() およびnoquote()も参照してください 。

QDebug &QDebug::maybeSpace()

デバッグストリームにスペース文字を書き込みます。この処理は、スペースの自動挿入に関する現在の設定に応じて行われ、ストリームへの参照を返します。

space() およびnospace()も参照してください 。

QDebug &QDebug::noquote()

QChar 、QString 、およびQByteArray のコンテンツの周囲への引用符の自動挿入を無効にし、ストリームへの参照を返します。

引用符の挿入が無効になっている場合、これらの型は引用符なしで出力され、非表示文字のエスケープも行われません。

quote() およびmaybeQuote()も参照してください 。

QDebug &QDebug::nospace()

スペースの自動挿入を無効にし、ストリームへの参照を返します。

space() およびmaybeSpace()も参照してください 。

QDebug &QDebug::quote()

QChar 、QString 、およびQByteArray のコンテンツを自動的に引用符で囲むようにし、ストリームへの参照を返します。

引用符の付加はデフォルトで有効になっています。

noquote() およびmaybeQuote()も参照してください 。

[noexcept, since 6.7] bool QDebug::quoteStrings() const

このQDebug インスタンスが、ストリームとして渡された文字列をクォート処理する場合（これがデフォルトです）、true を返します。

この関数は Qt 6.7 で導入されました。

QDebugStateSaver 、quote()、noquote()、およびsetQuoteStrings()も参照してください 。

QDebug &QDebug::resetFormat()

ストリームの書式設定オプションをリセットし、構築時の元の状態に戻します。

space() およびquote()も参照してください 。

void QDebug::setAutoInsertSpaces(bool b)

b が true の場合、書き込みの間にスペースが自動的に挿入されます。そうでない場合は、スペースの自動挿入は無効になります。

autoInsertSpaces() およびQDebugStateSaverも参照してください 。

[since 6.7] void QDebug::setQuoteStrings(bool b)

b がtrue の場合、このQDebug インスタンスにストリームで渡される文字列のクォーティングを有効にします。それ以外の場合は、クォーティングは無効になります。

デフォルトでは、文字列はクォートされます。

この関数は Qt 6.7 で導入されました。

QDebugStateSaver 、quote()、noquote()、およびquoteStrings()も参照してください 。

void QDebug::setVerbosity(int verbosityLevel)

ストリームの詳細度をverbosityLevel に設定します。

指定可能な範囲は 0 から 7 です。デフォルト値は 2 です。

verbosity() およびVerbosityLevelも参照してください 。

QDebug &QDebug::space()

デバッグストリームにスペース文字を書き込み、そのストリームへの参照を返します。

このストリームは、今後の書き込みにおいてスペースの自動挿入が有効になっていることを記憶します。

nospace() およびmaybeSpace()も参照してください 。

[noexcept] void QDebug::swap(QDebug &other)

このデバッグストリームインスタンスをother と入れ替えます。この操作は非常に高速で、失敗することはありません。

[static, since 6.9] template <typename T> QByteArray QDebug::toBytes(const T &object)

これは、`object ` を `QDebug::toString(object).toUtf8()` に渡すのと同じですが、より効率的です。

この関数は Qt 6.9 で導入されました。

toString()も参照してください 。

[static, since 6.0] template <typename T> QString QDebug::toString(const T &object)

object を、文字列を操作するQDebug インスタンスにストリームし、その文字列を返します。

この関数は、デバッグのためにオブジェクトのテキスト表現が必要であるが、operator<< を使用できない場合に役立ちます。例えば：

QString str = QDebug::toString(list);

文字列は `nospace()` を使用してストリーム化されます。

この関数はQt 6.0で導入されました。

toBytes()も参照してください 。

int QDebug::verbosity() const

デバッグストリームの詳細度を返します。

ストリーミング演算子は、この値を確認して詳細な出力が望まれるかどうかを判断し、レベルに応じてより多くの情報を出力することができます。値が大きいほど、より多くの情報が求められていることを示します。

許容される範囲は 0 から 7 です。デフォルト値は 2 です。

setVerbosity() およびVerbosityLevelも参照してください 。

QDebug &QDebug::verbosity(int verbosityLevel)

ストリームの詳細度をverbosityLevel に設定し、ストリームへの参照を返します。

許容される範囲は 0 から 7 です。デフォルト値は 2 です。

verbosity()、setVerbosity()、およびVerbosityLevelも参照してください 。

[since 6.0] QDebug &QDebug::operator<<(QByteArrayView t)

観測されたバイト配列のデータ `t` をストリームに書き込み、そのストリームへの参照を返します。

通常、QDebug はデータを引用符で囲んで出力し、制御文字や非US-ASCII文字をCのエスケープシーケンス（\xAB ）に変換します。これにより、出力は常に7ビット互換となり、必要に応じて出力から文字列をコピーしてC++ソースコードに貼り付けることができます。

変換を行わずに非表示文字を出力するには、noquote() の機能を有効にしてください。なお、一部のQDebug バックエンドは 8 ビットクリーンではない場合があることに注意してください。

例については、QByteArray のオーバーロードを参照してください。

この関数は Qt 6.0 で導入されました。

QDebug &QDebug::operator<<(QChar t)

文字「t 」をストリームに書き込み、そのストリームへの参照を返します。 通常、QDebug は、制御文字およびUS-ASCII以外の文字を、CのエスケープシーケンスまたはそのUnicode値（\u1234 ）として出力します。変換を行わずに非表示文字を出力するには、noquote()機能を有効にしてください。ただし、一部のQDebug バックエンドは8ビットクリーンではない場合があり、t を表現できない可能性があることに注意してください。

QDebug &QDebug::operator<<(QLatin1StringView t)

文字列「t 」をストリームに書き込み、そのストリームへの参照を返します。通常、QDebug は文字列を引用符で囲んで出力し、非表示文字をその Unicode 値に変換します（\u1234 ）。

変換を行わずに非表示文字を出力するには、noquote() 機能を有効にしてください。なお、一部のQDebug バックエンドは 8 ビットクリーンではない場合があることに注意してください。

例については、QString のオーバーロードを参照してください。

QDebug &QDebug::operator<<(QStringView s)

文字列ビュー `s` をストリームに書き出し、そのストリームへの参照を返します。通常、QDebug は文字列を引用符で囲んで出力し、非表示文字をその Unicode 値に変換します（\u1234 ）。

変換を行わずに非表示文字を出力するには、noquote() の機能を有効にしてください。なお、一部のQDebug バックエンドは 8 ビット対応ではない場合があることに注意してください。

例については、QString のオーバーロードを参照してください。

[since 6.0] QDebug &QDebug::operator<<(QUtf8StringView s)

文字列ビュー `s` をストリームに書き込み、そのストリームへの参照を返します。

通常、QDebug はデータを引用符で囲んで出力し、制御文字や非US-ASCII文字をCのエスケープシーケンス（\xAB ）に変換します。これにより、出力は常に7ビット互換となり、必要に応じて出力から文字列をコピーしてC++ソースコードに貼り付けることができます。

変換を行わずに非表示文字を出力するには、noquote() 機能を有効にしてください。なお、一部のQDebug バックエンドは 8 ビットクリーンではない場合があることに注意してください。

この関数は Qt 6.0 で導入されました。

128ビット整数i のテキスト表現を出力します。

これらの関数は Qt 6.7 で導入されました。

関連項目： QT_SUPPORTS_INT128 。

QDebug &QDebug::operator<<(bool t)

ブール値 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(char t)

文字列 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(char16_t t)

UTF-16文字「t 」をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(char32_t t)

UTF-32文字「t 」をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(const QByteArray &t)

バイト配列 `t` をストリームに書き込み、そのストリームへの参照を返します。 通常、QDebug は配列を引用符で囲んで出力し、制御文字や非US-ASCII文字をCのエスケープシーケンス（\xAB ）に変換します。これにより、出力は常に7ビット互換となり、必要に応じて出力から文字列をコピーしてC++ソースコードに貼り戻すことができます。

変換なしで非表示文字を出力するには、noquote() 機能を有効にしてください。なお、一部のQDebug バックエンドは 8 ビットクリーンではない場合があることに注意してください。

出力の例：

QByteArray ba;

ba= "a";
qDebug().noquote() << ba;    // prints: a
qDebug() << ba;              // prints: "a"

ba= "\"a\r\n\"";
qDebug() << ba;              // prints: "\"a\r\n\""

ba= "\033";                 // エスケープ文字
qDebug() << ba;              // prints: "\x1B"

ba= "\xC3\xA1";
qDebug() << ba;              // prints: "\xC3\xA1"

ba=QByteArray("a\0b", 3);
qDebug() << ba;               // prints: "\a\x00""b"

QDebug では、C や C++ 言語で文字列リテラルを連結する際と同様の方法で、文字列を一度閉じてから再度開く必要があった点に注目してください。そうすることで、文字「b」が前の16進エスケープシーケンスの一部として解釈されるのを防ぐことができます。

QDebug &QDebug::operator<<(const QString &t)

文字列 `t` をストリームに書き込み、そのストリームへの参照を返します。通常、QDebug は、引用符で囲まれた文字列を出力し、非表示文字をその Unicode 値に変換します（\u1234 ）。

変換を行わずに非表示文字を出力するには、noquote() 機能を有効にしてください。なお、一部のQDebug バックエンドは 8 ビット対応ではない場合があることに注意してください。

出力例：

QString s;

s= "a";
qDebug().noquote() << s;    // prints: a
qDebug() << s;              // prints: "a"

s= "\"a\r\n\"";
qDebug() << s;              // prints: "\"a\r\n\""

s= "\033";                 // エスケープ文字
qDebug() << s;              // prints: "\u001B"

s= "\u00AD";               // ソフトハイフン
qDebug() << s;              // prints: "\u00AD"

s= "\u00E1";               // アクサンテギュ付きラテン小文字の A
qDebug() << s;              // prints: "á"

s= "a\u0301";              // "a" の後に「組み合わせ鋭アクセント」が続く
qDebug() << s;              // prints: "á";

s= "\u0430\u0301";         // キリル文字の小文字「A」の後に組み合わせアクセント（アクサンテギュ）が続く
qDebug() << s;              // prints: "а́"

QDebug &QDebug::operator<<(const char *t)

「\0 」で終了するUTF-8文字列（t ）をストリームに書き込み、そのストリームへの参照を返します。出力時には、この文字列は引用符で囲まれたりエスケープされたりすることはありません。QDebug は内部でUTF-16としてバッファリングされており、一部のバックエンドを使用するためにロケールのコーデックを用いて8ビットに変換する必要がある場合があり、その結果、文字化け（mojibake）が発生する可能性があることに注意してください。US-ASCII文字列に限定することを推奨します。

[since 6.0] QDebug &QDebug::operator<<(const char16_t *t)

「'\0'」で終了するUTF-16文字列（t ）をストリームに書き込み、そのストリームへの参照を返します。出力時に、この文字列は引用符で囲まれたりエスケープされたりすることはありません。QDebug は内部でUTF-16としてバッファリングされるため、一部のバックエンドを使用する際には、ロケールのコーデックを使用して8ビットに変換する必要があり、その結果、文字化け（mojibake）が発生する可能性があることに注意してください。US-ASCII文字列に限定することを推奨します。

この関数は Qt 6.0 で導入されました。

文字列または文字列ビュー `s ` をストリームに書き込み、そのストリームへの参照を返します。

これらの演算子は、Char が次のいずれかである場合にのみ、オーバーロード解決の対象となります。

• char
• char8_t（C++20のみ）
• char16_t
• char32_t
• wchar_t

これらの関数は Qt 6.5 で導入されました。

[since 6.7] template <typename T> requires if_streamable<T> QDebug &QDebug::operator<<(const std::optional<T> &opt)

opt （設定されていない場合はnullopt ）の内容を、このストリームに書き込みます。T は、QDebug へのストリーミングに対応している必要があります。

この関数は Qt 6.7 で導入されました。

[since 6.9] template <typename... Ts> requires if_streamable<Ts...> QDebug &QDebug::operator<<(const std::tuple<Ts...> &tuple)

tuple の内容をストリームに書き込みます。すべてのTs... は、QDebug へのストリーミングをサポートする必要があります。

この関数は Qt 6.9 で導入されました。

QDebug &QDebug::operator<<(const void *t)

ポインタ `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(double t)

64ビット浮動小数点数 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(float t)

32ビット浮動小数点数 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(int t)

符号付き整数 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(long t)

符号付き長整数 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(qint64 t)

符号付き64ビット整数 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(quint64 t)

その後、符号なし64ビット整数 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(short t)

符号付き短整数 `t` をストリームに書き込み、そのストリームへの参照を返します。

[since 6.6] template <typename Rep, typename Period> QDebug &QDebug::operator<<(std::chrono::duration<Rep, Period> duration)

duration の時間経過をストリームに出力し、そのストリームへの参照を返します。出力される文字列は、C++ 標準ライブラリが `std::ostream` で生成するものと同様に、経過時間の数値表現の後に時間単位が続く形式です。

単位はローカライズされません。

この関数は Qt 6.6 で導入されました。

[since 6.7] QDebug &QDebug::operator<<(std::nullopt_t)

ストリームにnulloptを書き込みます。

この関数は Qt 6.7 で導入されました。

QDebug &QDebug::operator<<(unsigned int t)

t という符号なし整数をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(unsigned long t)

署名なしの長い整数 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator<<(unsigned short t)

署名なしの短整数 `t` をストリームに書き込み、そのストリームへの参照を返します。

QDebug &QDebug::operator=(const QDebug &other)

other のデバッグストリームをこのストリームに割り当て、このストリームへの参照を返します。