QMessageLogger Class
La classe QMessageLogger génère des messages de journalisation. Plus d'informations...
| En-tête : | #include <QMessageLogger> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Core)target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake : | QT += core |
Types publics
Fonctions publiques
| 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 |
Description détaillée
QMessageLogger est utilisé pour générer des messages pour le cadre de journalisation de Qt. On l'utilise généralement par l'intermédiaire des fonctions qDebug(), qInfo(), qWarning(), qCritical ou qFatal(), qui sont en fait des macros : Par exemple, qDebug() se développe en QMessageLogger(__FILE__, __LINE__, Q_FUNC_INFO).debug() pour les versions de débogage, et QMessageLogger(0, 0, 0).debug() pour les versions de mise à jour.
Un exemple d'utilisation directe est la transmission d'erreurs provenant d'un langage de script, par exemple 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(); } } }
Voir également QMessageLogContext, qDebug(), qInfo(), qWarning(), qCritical() et qFatal().
Documentation sur les types de membres
QMessageLogger::CategoryFunction
Il s'agit d'un typedef pour un pointeur sur une fonction avec la signature suivante :
const QLoggingCategory &category();
La macro Q_DECLARE_LOGGING_CATEGORY génère une déclaration de fonction avec cette signature, et Q_LOGGING_CATEGORY génère sa définition.
Voir aussi QLoggingCategory.
Documentation sur les fonctions membres
[constexpr] QMessageLogger::QMessageLogger()
Construit un QMessageLogger par défaut. Voir les autres constructeurs pour spécifier des informations contextuelles.
[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function)
Construit un QMessageLogger pour enregistrer les messages de file à line dans function. Ceci est équivalent à QMessageLogger(file, line, function, "default")
[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)
Construit un QMessageLogger pour enregistrer les messages category pour file à line dans function.
Voir aussi QLoggingCategory.
QDebug QMessageLogger::critical() const
Enregistre un message critique en utilisant un flux QDebug
Voir aussi qCritical() et QDebug.
QDebug QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message critique dans la catégorie renvoyée par catFunc en utilisant un flux QDebug.
Voir aussi qCCritical() et QDebug.
QDebug QMessageLogger::critical(const QLoggingCategory &cat) const
Enregistre un message critique dans la catégorie cat à l'aide d'un flux QDebug.
Voir aussi qCCritical() et QDebug.
void QMessageLogger::critical(const char *msg, ...) const
Enregistre un message critique spécifié au format msg. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCritical().
void QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message critique spécifié au format msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCCritical().
void QMessageLogger::critical(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message critique spécifié au format msg pour le contexte cat. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCCritical().
QDebug QMessageLogger::debug() const
Enregistre un message de débogage en utilisant un flux QDebug
Voir aussi qDebug() et QDebug.
QDebug QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message de débogage dans la catégorie renvoyée par catFunc en utilisant un flux QDebug.
Voir aussi qCDebug() et QDebug.
QDebug QMessageLogger::debug(const QLoggingCategory &cat) const
Enregistre un message de débogage dans la catégorie cat à l'aide d'un flux QDebug.
Voir aussi qCDebug() et QDebug.
void QMessageLogger::debug(const char *msg, ...) const
Enregistre un message de débogage spécifié au format msg. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qDebug().
void QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message de débogage spécifié au format msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCDebug().
void QMessageLogger::debug(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message de débogage spécifié au format msg pour le contexte cat. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCDebug().
[since 6.5] QDebug QMessageLogger::fatal() const
Enregistre un message fatal en utilisant un flux QDebug.
Cette fonction a été introduite dans Qt 6.5.
Voir aussi qFatal() et QDebug.
[since 6.5] QDebug QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message fatal dans la catégorie renvoyée par catFunc en utilisant un flux QDebug.
Cette fonction a été introduite dans Qt 6.5.
Voir aussi qCFatal() et QDebug.
[since 6.5] QDebug QMessageLogger::fatal(const QLoggingCategory &cat) const
Enregistre un message fatal dans la catégorie cat en utilisant un flux QDebug.
Cette fonction a été introduite dans Qt 6.5.
Voir aussi qCFatal() et QDebug.
[noexcept] void QMessageLogger::fatal(const char *msg, ...) const
Enregistre un message fatal spécifié au format msg. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qFatal().
[noexcept, since 6.5] void QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message fatal spécifié au format msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Cette fonction a été introduite dans Qt 6.5.
Voir aussi qCFatal().
[noexcept, since 6.5] void QMessageLogger::fatal(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message fatal spécifié au format msg pour le contexte cat. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Cette fonction a été introduite dans Qt 6.5.
Voir aussi qCFatal().
QDebug QMessageLogger::info() const
Enregistre un message d'information à l'aide d'un flux QDebug.
QDebug QMessageLogger::info(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message d'information dans la catégorie renvoyée par catFunc en utilisant un flux QDebug.
Voir aussi qCInfo() et QDebug.
QDebug QMessageLogger::info(const QLoggingCategory &cat) const
Enregistre un message d'information dans la catégorie cat à l'aide d'un flux QDebug.
Voir aussi qCInfo() et QDebug.
void QMessageLogger::info(const char *msg, ...) const
Enregistre un message d'information spécifié au format msg. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qInfo().
void QMessageLogger::info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message d'information spécifié au format msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCInfo().
void QMessageLogger::info(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message d'information spécifié au format msg pour le contexte cat. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCInfo().
QDebug QMessageLogger::warning() const
Enregistre un message d'avertissement en utilisant un flux QDebug
Voir aussi qWarning() et QDebug.
QDebug QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message d'avertissement dans la catégorie renvoyée par catFunc en utilisant un flux QDebug.
Voir aussi qCWarning() et QDebug.
QDebug QMessageLogger::warning(const QLoggingCategory &cat) const
Enregistre un message d'avertissement dans la catégorie cat à l'aide d'un flux QDebug.
Voir aussi qCWarning() et QDebug.
void QMessageLogger::warning(const char *msg, ...) const
Enregistre un message d'avertissement spécifié au format msg. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qWarning().
void QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message d'avertissement spécifié au format msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCWarning().
void QMessageLogger::warning(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message d'avertissement spécifié au format msg pour le contexte cat. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir aussi qCWarning().
© 2026 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.
