QLoggingCategory Class

マクロのドキュメント

[since 6.5] Q_DECLARE_EXPORTED_LOGGING_CATEGORY(name, EXPORT_MACRO)

ロギングカテゴリ「name 」を宣言します。このマクロを使用すると、プログラムのさまざまな部分で共有される共通のロギングカテゴリを宣言できます。

これは `Q_DECLARE_LOGGING_CATEGORY()` とまったく同じように動作します。ただし、このマクロによって宣言されるロギングカテゴリには、さらに `EXPORT_MACRO` という修飾が追加されます。これは、ロギングカテゴリをダイナミックライブラリからエクスポートする必要がある場合に役立ちます。

例：

Q_DECLARE_EXPORTED_LOGGING_CATEGORY(lcCore, LIB_EXPORT_MACRO)

このマクロは、クラスや関数の外側で使用する必要があります。

このマクロは Qt 6.5 で導入されました。

Q_LOGGING_CATEGORY() およびQ_DECLARE_LOGGING_CATEGORY()も参照してください 。

Q_DECLARE_LOGGING_CATEGORY(name)

ロギングカテゴリ「name 」を宣言します。このマクロは、プログラムのさまざまな部分で共有される共通のロギングカテゴリを宣言するために使用できます。

このマクロは、クラスやメソッドの外側で使用する必要があります。

Q_LOGGING_CATEGORY() およびQ_DECLARE_EXPORTED_LOGGING_CATEGORY()も参照してください 。

Q_LOGGING_CATEGORY(name, string)

ロギングカテゴリ「name 」を定義し、string 識別子の下で設定可能にします。デフォルトでは、すべてのメッセージタイプが有効になっています。

ライブラリまたは実行ファイル内の翻訳単位のうち、特定の名前を持つカテゴリを定義できるのは 1 つだけです。暗黙的に定義されたQLoggingCategory オブジェクトは、初回使用時にスレッドセーフな方法で作成されます。

このマクロは、クラスやメソッドの外で使用する必要があります。

Q_DECLARE_LOGGING_CATEGORY() およびQ_DECLARE_EXPORTED_LOGGING_CATEGORY()も参照してください 。

Q_LOGGING_CATEGORY(name, string, msgType)

ロギングカテゴリ「name 」を定義し、string という識別子の下で設定可能にします。デフォルトでは、QtMsgType 、msgType 、およびそれより深刻なレベルのメッセージが有効になっており、深刻度が低いタイプのメッセージは無効になっています。

ライブラリまたは実行ファイル内では、特定の名前を持つカテゴリを定義できる翻訳単位は1つだけです。暗黙的に定義されたQLoggingCategory オブジェクトは、最初の使用時にスレッドセーフな方法で作成されます。

このマクロは、クラスやメソッドの外側で使用する必要があります。

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

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string)

静的ロギングカテゴリ「name 」を定義し、string という識別子の下で設定可能にします。デフォルトでは、すべてのメッセージタイプが有効になっています。

このロギングカテゴリは、static 修飾子を使用して作成されるため、同じ翻訳単位内でのみアクセス可能です。これにより、意図しないシンボル競合を回避できます。

暗黙的に定義されたQLoggingCategory オブジェクトは、初回使用時にスレッドセーフな方法で作成されます。

このマクロは、クラスやメソッドの外側で使用する必要があります。

このマクロは Qt 6.9 で導入されました。

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

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string, msgType)

静的なロギングカテゴリ「name 」を定義し、string という識別子の下で設定可能にします。デフォルトでは、QtMsgType 、msgType およびそれ以上の深刻度のメッセージが有効になっており、それより深刻度の低いタイプは無効になっています。

このロギングカテゴリは、static 修飾子を使用して作成されるため、同じ翻訳単位内でのみアクセス可能です。これにより、意図しないシンボル衝突を回避できます。

暗黙的に定義されたQLoggingCategory オブジェクトは、初回使用時にスレッドセーフな方法で生成されます。

このマクロは、クラスやメソッドの外側で使用する必要があります。

このマクロは Qt 6.9 で導入されました。

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

qCCritical(category)

ロギングカテゴリ「category 」の重大なメッセージ用の出力ストリームを返します。

このマクロは、QLoggingCategory::isCriticalEnabled() の評価結果が `true` となるかどうかを調べるコードに展開されます。その場合、ストリームの引数が処理され、メッセージハンドラに送信されます。

例:

    QLoggingCategory category("driver.usb");
    qCCritical(category) << "a critical message";

QDebug::qCritical()も参照してください 。

qCCritical(category, const char *message, ...)

「message 」というクリティカルなメッセージを、「category 」というロギングカテゴリに記録します。「message 」には、C言語のprintf()関数と同様に、追加の引数で置き換えられるプレースホルダーを含めることができます。

例：

    QLoggingCategory category("driver.usb");
    qCCritical(category, "a critical message logged into category %s", category.categoryName());

qCritical(const char *, ...)も参照してください 。

qCDebug(category)

ロギングカテゴリ「category 」のデバッグメッセージ用の出力ストリームを返します。

このマクロは、QLoggingCategory::isDebugEnabled() の評価結果がtrue となるかどうかを確認するコードに展開されます。その場合、ストリームの引数が処理され、メッセージハンドラに送信されます。

例:

    QLoggingCategory category("driver.usb");
    qCDebug(category) << "a debug message";

QDebug::qDebug()も参照してください 。

qCDebug(category, const char *message, ...)

ログカテゴリ「category 」に、デバッグメッセージ「message 」を記録します。message には、C言語のprintf()関数と同様に、追加の引数で置き換えられるプレースホルダーを含めることができます。

例：

    QLoggingCategory category("driver.usb");
    qCDebug(category, "a debug message logged into category %s", category.categoryName());

qDebug(const char *, ...)も参照してください 。

[since 6.5] qCFatal(category)

ロギングカテゴリ「category 」の致命的なメッセージ用の出力ストリームを返します。

デフォルトのメッセージハンドラを使用している場合、返されるストリームはアボートしてコアダンプを生成します。Windows では、デバッグビルドの場合、この関数は `_CRT_ERROR ` を報告し、デバッガをアプリケーションに接続できるようにします。

例:

    QLoggingCategory category("driver.usb");
    qCFatal(category) << "a fatal message. Program will be terminated!";

このマクロは Qt 6.5 で導入されました。

QDebug::qFatal()も参照してください 。

[since 6.5] qCFatal(category, const char *message, ...)

「message 」という致命的なメッセージを、「category 」というロギングカテゴリに記録します。「message 」には、C言語のprintf()関数と同様に、追加の引数で置き換えられるプレースホルダーが含まれている場合があります。

例：

    QLoggingCategory category("driver.usb");
    qCFatal(category, "a fatal message. Program will be terminated!");

デフォルトのメッセージハンドラを使用している場合、この関数はコアダンプを作成するために実行を中止します。Windows では、デバッグビルドの場合、この関数は `_CRT_ERROR ` を報告し、デバッガをアプリケーションに接続できるようにします。

このマクロは Qt 6.5 で導入されました。

「 qFatal(const char *, ...)」も参照してください 。

qCInfo(category)

ロギングカテゴリ「category 」の情報メッセージ用の出力ストリームを返します。

このマクロは、QLoggingCategory::isInfoEnabled() の評価結果がtrue となるかどうかを確認するコードに展開されます。その場合、ストリーム引数が処理され、メッセージハンドラに送信されます。

例:

    QLoggingCategory category("driver.usb");
    qCInfo(category) << "an informational message";

QDebug::qInfo()も参照してください 。

qCInfo(category, const char *message, ...)

「message 」という情報メッセージを、「category 」というロギングカテゴリに記録します。「message 」には、C言語のprintf()関数と同様に、追加の引数で置き換えられるプレースホルダーを含めることができます。

例：

    QLoggingCategory category("driver.usb");
    qCInfo(category, "an informational message logged into category %s", category.categoryName());

qInfo(const char *, ...)も参照してください 。

qCWarning(category)

ロギングカテゴリ「category 」の警告メッセージ用の出力ストリームを返します。

このマクロは、QLoggingCategory::isWarningEnabled() の評価結果がtrue となるかどうかを確認するコードに展開されます。その場合、ストリーム引数が処理され、メッセージハンドラに送信されます。

例：

    QLoggingCategory category("driver.usb");
    qCWarning(category) << "a warning message";

QDebug::qWarning()も参照してください 。

qCWarning(category, const char *message, ...)

「message 」という警告メッセージを、「category 」というロギングカテゴリに記録します。「message 」には、C言語のprintf()関数と同様に、追加の引数で置き換えられるプレースホルダーを含めることができます。

例：

    QLoggingCategory category("driver.usb");
    qCWarning(category, "a warning message logged into category %s", category.categoryName());

qWarning(const char *, ...)も参照してください 。