QMessageLogger Class

QMessageLogger クラスはログ・メッセージを生成します。詳細...

ヘッダ #include <QMessageLogger>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

パブリックな型

パブリック関数

QMessageLogger()
QMessageLogger(const char *file, int line, const char *function)
QMessageLogger(const char *file, int line, const char *function, const char *category)
QDebug critical() const
QDebug critical(QMessageLogger::CategoryFunction catFunc) const
QDebug critical(const QLoggingCategory &cat) const
void critical(const char *msg, ...) const
void critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void critical(const QLoggingCategory &cat, const char *msg, ...) const
QDebug debug() const
QDebug debug(QMessageLogger::CategoryFunction catFunc) const
QDebug debug(const QLoggingCategory &cat) const
void debug(const char *msg, ...) const
void debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void debug(const QLoggingCategory &cat, const char *msg, ...) const
(since 6.5) QDebug fatal() const
(since 6.5) QDebug fatal(QMessageLogger::CategoryFunction catFunc) const
(since 6.5) QDebug fatal(const QLoggingCategory &cat) const
void fatal(const char *msg, ...) const
(since 6.5) void fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
(since 6.5) void fatal(const QLoggingCategory &cat, const char *msg, ...) const
QDebug info() const
QDebug info(QMessageLogger::CategoryFunction catFunc) const
QDebug info(const QLoggingCategory &cat) const
void info(const char *msg, ...) const
void info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void info(const QLoggingCategory &cat, const char *msg, ...) const
QDebug warning() const
QDebug warning(QMessageLogger::CategoryFunction catFunc) const
QDebug warning(const QLoggingCategory &cat) const
void warning(const char *msg, ...) const
void warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void warning(const QLoggingCategory &cat, const char *msg, ...) const

詳細説明

QMessageLoggerは、Qtロギングフレームワーク用のメッセージを生成するために使用されます。通常、qDebug(),qInfo(),qWarning(),qCritical,qFatal() 関数を通して使用しますが、これらは実際にはマクロです:例えば、qDebug() は QMessageLogger(__FILE__, __LINE__,Q_FUNC_INFO) に展開されます。debug() はデバッグビルド用で、QMessageLogger(0, 0, 0).debug() はリリースビルド用です。

直接使用する例としては、QMLなどのスクリプト言語に起因するエラーを転送することがあります:

    void statusChanged(QQmlComponent::Status status) {
        if (status == QQmlComponent::Error) {
            for (const QQmlError &error: std::as_const(component->errors())) {
                const QByteArray file = error.url().toEncoded();
                QMessageLogger(file.constData(), error.line(), 0).debug() << error.description();
            }
        }
    }

QMessageLogContextqDebug()、qInfo()、qWarning()、qCritical()、qFatal()も参照

メンバ型ドキュメント

QMessageLogger::CategoryFunction

これは、以下のシグネチャを持つ関数へのポインタの typedef である:

    const QLoggingCategory &category();

Q_DECLARE_LOGGING_CATEGORY マクロはこのシグネチャを持つ関数宣言を生成し、Q_LOGGING_CATEGORY はその定義を生成する。

QLoggingCategoryも参照のこと

メンバ関数ドキュメント

[constexpr] QMessageLogger::QMessageLogger()

デフォルトの QMessageLogger を構築します。コンテキスト情報を指定するには、他のコンストラクタを参照してください。

[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function)

functionlinefile のログメッセージを記録する QMessageLogger を構築します。QMessageLogger(file, line, function, "default") と同じです。

[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)

functionlinefilecategory メッセージを記録する QMessageLogger を構築します。

QLoggingCategoryも参照してください

QDebug QMessageLogger::critical() const

QDebug ストリームを使ってクリティカル・メッセージをログに記録する。

qCritical() およびQDebugも参照のこと

QDebug QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc) const

QDebug ストリームを使用して、catFunc が返すカテゴリにクリティカル・メッセージをログに記録する。

qCCritical() およびQDebugも参照のこと

QDebug QMessageLogger::critical(const QLoggingCategory &cat) const

QDebug ストリームを使用して、クリティカル・メッセージをcat カテゴリに記録する。

qCCritical() およびQDebugも参照のこと

void QMessageLogger::critical(const char *msg, ...) const

msg の書式で指定されたクリティカル・メッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCritical()も参照のこと

void QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc によって返されたコンテキストに対して、msg の書式で指定されたクリティカルメッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCCritical()も参照のこと

void QMessageLogger::critical(const QLoggingCategory &cat, const char *msg, ...) const

cat のコンテキストに対して、msg の書式で指定されたクリティカルメッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCCritical()も参照のこと

QDebug QMessageLogger::debug() const

QDebug ストリームを使ってデバッグ・メッセージを記録する。

qDebug() およびQDebugも参照のこと

QDebug QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc) const

QDebug ストリームを使用して、catFunc によって返されたカテゴリにデバッグメッセージをログに記録する。

qCDebug() およびQDebugも参照のこと

QDebug QMessageLogger::debug(const QLoggingCategory &cat) const

QDebug ストリームを使用して、デバッグメッセージをcat カテゴリに記録する。

qCDebug() およびQDebugも参照のこと

void QMessageLogger::debug(const char *msg, ...) const

msg の書式で指定されたデバッグメッセージをログに記録する。msg で指定される追加パラメータを使用することもできる。

qDebug()も参照のこと

void QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc によって返されたコンテキストに対して、msg の書式で指定されたデバッグメッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCDebug()も参照のこと

void QMessageLogger::debug(const QLoggingCategory &cat, const char *msg, ...) const

コンテキストcat に対して、フォーマットmsg で指定されたデバッグメッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCDebug()も参照のこと

[since 6.5] QDebug QMessageLogger::fatal() const

QDebug ストリームを使用して致命的なメッセージをログに記録します。

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

qFatal() およびQDebugも参照してください

[since 6.5] QDebug QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc) const

QDebug ストリームを使用して、catFunc によって返されたカテゴリに致命的なメッセージをログに記録します。

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

qCFatal() およびQDebugも参照してください

[since 6.5] QDebug QMessageLogger::fatal(const QLoggingCategory &cat) const

QDebug ストリームを使用して、致命的なメッセージをcat カテゴリに記録します。

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

qCFatal() およびQDebugも参照してください

[noexcept] void QMessageLogger::fatal(const char *msg, ...) const

msg の書式で指定された致命的メッセージをログに記録する。msg で指定される追加パラメータを使用することもできる。

qFatal()も参照のこと

[noexcept, since 6.5] void QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc によって返されたコンテキストに対して、msg の書式で指定された致命的メッセージをログに記録する。msg で指定された追加のパラメータを使用することもできます。

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

qCFatal()も参照してください

[noexcept, since 6.5] void QMessageLogger::fatal(const QLoggingCategory &cat, const char *msg, ...) const

cat のコンテキストに対してmsg の書式で指定された致命的メッセージをログに記録する。msg で指定された追加パラメータを使用することもできます。

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

qCFatal()も参照してください

QDebug QMessageLogger::info() const

QDebug ストリームを使用して情報メッセージをログに記録する。

qInfo() およびQDebugも参照のこと

QDebug QMessageLogger::info(QMessageLogger::CategoryFunction catFunc) const

QDebug ストリームを使用して、catFunc によって返されたカテゴリに情報メッセージを記録する。

qCInfo() およびQDebugも参照のこと

QDebug QMessageLogger::info(const QLoggingCategory &cat) const

QDebug ストリームを使用して、cat カテゴリに情報メッセージを記録する。

qCInfo() およびQDebugも参照のこと

void QMessageLogger::info(const char *msg, ...) const

msg の書式で指定された情報メッセージをログに記録する。msg で指定される追加パラメータを使用することもできる。

qInfo()も参照のこと

void QMessageLogger::info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc によって返されたコンテキストに対して、msg の書式で指定された情報メッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCInfo()も参照のこと

void QMessageLogger::info(const QLoggingCategory &cat, const char *msg, ...) const

コンテキストcat に対して、フォーマットmsg で指定された情報メッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCInfo()も参照のこと

QDebug QMessageLogger::warning() const

QDebug ストリームを使って警告メッセージをログに記録する。

qWarning() およびQDebugも参照

QDebug QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc) const

QDebug ストリームを使用して、catFunc が返すカテゴリに警告メッセージをログに記録する。

qCWarning() およびQDebugも参照のこと

QDebug QMessageLogger::warning(const QLoggingCategory &cat) const

QDebug ストリームを使用して、警告メッセージをcat カテゴリに記録する。

qCWarning() およびQDebugも参照のこと

void QMessageLogger::warning(const char *msg, ...) const

フォーマットmsg で指定された警告メッセージをログに記録する。msg で指定される追加パラメータを使用することもできる。

qWarning()も参照のこと

void QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

catFunc によって返されたコンテキストに対して、msg の書式で指定された警告メッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCWarning()も参照のこと

void QMessageLogger::warning(const QLoggingCategory &cat, const char *msg, ...) const

コンテキストcat に対して、フォーマットmsg で指定された警告メッセージをログに記録する。msg で指定された追加のパラメータを使用することもできる。

qCWarning()も参照のこと

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.