QMessageLogger Class
QMessageLogger クラスはログ・メッセージを生成します。詳細...
Header: | #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(); } } }
QMessageLogContext 、qDebug()、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)
function のline にfile のログ・メッセージを記録する QMessageLogger を構築します。QMessageLogger(file, line, function, "default") と同等です。
[constexpr]
QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)
function のline にあるfile のcategory メッセージを記録する 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 ストリームを使用して情報メッセージをログに記録します。
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()も参照して ください。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。