QDebug Class

メンバ関数 ドキュメント

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

これらの演算子は、Char が以下のいずれかである場合にのみ、オーバーロード解決に参加します。

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

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

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

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

QT_SUPPORTS_INT128も参照してください 。

[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.0] template <typename T> QString QDebug::toString(const T &object)

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

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

    QTRY_VERIFY2(list.isEmpty(), qPrintable(QString::fromLatin1(
        "Expected list to be empty, but it has the following items: %1")).arg(QDebug::toString(list)));

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

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

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 で導入されました。

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";                 // escape character
    qDebug() << ba;              // prints: "\x1B"

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

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

QDebug 、文字'b'が前の16進エスケープシーケンスの一部として解釈されないように、CおよびC++言語が文字列リテラルを連結する方法で、文字列を閉じて開き直す必要があったことに注意。

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";                 // escape character
    qDebug() << s;              // prints: "\u001B"

    s = "\u00AD";               // SOFT HYPHEN
    qDebug() << s;              // prints: "\u00AD"

    s = "\u00E1";               // LATIN SMALL LETTER A WITH ACUTE
    qDebug() << s;              // prints: "á"

    s = "a\u0301";              // "a" followed by COMBINING ACUTE ACCENT
    qDebug() << s;              // prints: "á";

    s = "\u0430\u0301";         // CYRILLIC SMALL LETTER A followed by COMBINING ACUTE ACCENT
    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)

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

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

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 デバッグ・ストリームをこのストリームに割り当て、このストリームへの参照を返します。