QMessageLogger Class
La classe QMessageLogger génère des messages de journalisation. En savoir plus...
| 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 framework de journalisation Qt. On l'utilise généralement via les fonctions qDebug(), qInfo(), qWarning(), qCritical ou qFatal(), qui sont en réalité 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 production.
Un exemple d’utilisation directe consiste à transmettre les 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 vers une fonction présentant 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 également QLoggingCategory.
Documentation sur les fonctions membres
[constexpr] QMessageLogger::QMessageLogger()
Crée un objet `QMessageLogger` par défaut. Consultez les autres constructeurs pour spécifier des informations de contexte.
[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function)
Crée un objet `QMessageLogger` pour enregistrer les messages de journalisation destinés à file à l'adresse line sur function. Cette méthode est équivalente à `QMessageLogger(file, line, function, "default")`.
[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)
Crée un objet QMessageLogger pour enregistrer les messages de « category » pour « file » à l'adresse line sur function.
Voir également QLoggingCategory.
QDebug QMessageLogger::critical() const
Enregistre un message critique à l'aide d'un flux « QDebug »
Voir également qCritical() et QDebug.
QDebug QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message critique dans la catégorie renvoyée par catFunc à l'aide d'un flux QDebug.
Voir également 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 également qCCritical() et QDebug.
void QMessageLogger::critical(const char *msg, ...) const
Enregistre un message critique défini selon le format msg. Des paramètres supplémentaires, définis par msg, peuvent être utilisés.
Voir également qCritical().
void QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message critique défini selon le format msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, définis par msg, peuvent être utilisés.
Voir également qCCritical().
void QMessageLogger::critical(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message critique défini au format msg pour le contexte cat. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir également qCCritical().
QDebug QMessageLogger::debug() const
Enregistre un message de débogage à l'aide d'un flux « QDebug »
Voir également ` qDebug()` et ` QDebug`.
QDebug QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message de débogage dans la catégorie renvoyée par ` catFunc ` à l'aide d'un flux ` QDebug `.
Voir également 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 également qCDebug() et QDebug.
void QMessageLogger::debug(const char *msg, ...) const
Enregistre un message de débogage dont le format est défini par ` msg`. Des paramètres supplémentaires, spécifiés par ` msg`, peuvent être utilisés.
Voir également qDebug().
void QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message de débogage dont le format est défini par msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, définis par msg, peuvent être utilisés.
Voir également qCDebug().
void QMessageLogger::debug(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message de débogage au format msg pour le contexte cat. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir également qCDebug().
[since 6.5] QDebug QMessageLogger::fatal() const
Enregistre un message d'erreur fatale à l'aide d'un flux de type « QDebug ».
Cette fonction a été introduite dans Qt 6.5.
Voir également ` 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 ` à l'aide d'un flux ` QDebug `.
Cette fonction a été introduite dans Qt 6.5.
Voir également qCFatal() et QDebug.
[since 6.5] QDebug QMessageLogger::fatal(const QLoggingCategory &cat) const
Enregistre un message fatal dans la catégorie « cat » à l'aide d'un flux « QDebug ».
Cette fonction a été introduite dans Qt 6.5.
Voir également ` qCFatal()` et ` QDebug`.
[noexcept] void QMessageLogger::fatal(const char *msg, ...) const
Enregistre un message fatal au format spécifié par ` msg`. Des paramètres supplémentaires, définis par ` msg`, peuvent être utilisés.
Voir également qFatal().
[noexcept, since 6.5] void QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message fatal au format msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, définis par msg, peuvent être utilisés.
Cette fonction a été introduite dans Qt 6.5.
Voir également qCFatal().
[noexcept, since 6.5] void QMessageLogger::fatal(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message fatal 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 également qCFatal().
QDebug QMessageLogger::info() const
Enregistre un message d'information à l'aide d'un flux « QDebug ».
Voir également qInfo() et QDebug.
QDebug QMessageLogger::info(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message d'information dans la catégorie renvoyée par catFunc à l'aide d'un flux QDebug.
Voir également 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 également ` qCInfo()` et ` QDebug`.
void QMessageLogger::info(const char *msg, ...) const
Enregistre un message d'information au format msg. Des paramètres supplémentaires, définis par msg, peuvent être utilisés.
Voir également qInfo().
void QMessageLogger::info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message d'information dont le format est défini par msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, définis par msg, peuvent être utilisés.
Voir également qCInfo().
void QMessageLogger::info(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message d'information défini selon le format msg pour le contexte cat. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir également qCInfo().
QDebug QMessageLogger::warning() const
Enregistre un message d'avertissement à l'aide d'un flux de type « QDebug »
Voir également qWarning() et QDebug.
QDebug QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc) const
Enregistre un message d'avertissement dans la catégorie renvoyée par catFunc à l'aide d'un flux QDebug.
Voir également 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 également qCWarning() et QDebug.
void QMessageLogger::warning(const char *msg, ...) const
Enregistre un message d'avertissement au format msg. Des paramètres supplémentaires, définis par msg, peuvent être utilisés.
Voir également qWarning().
void QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Enregistre un message d'avertissement au format msg pour le contexte renvoyé par catFunc. Des paramètres supplémentaires, spécifiés par msg, peuvent être utilisés.
Voir également qCWarning().
void QMessageLogger::warning(const QLoggingCategory &cat, const char *msg, ...) const
Enregistre un message d'avertissement au format msg pour le contexte cat. Des paramètres supplémentaires, définis par msg, peuvent être utilisés.
Voir également 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.
