QLoggingCategory Class

Documentation des macros

[since 6.5] Q_DECLARE_EXPORTED_LOGGING_CATEGORY(name, EXPORT_MACRO)

Déclare une catégorie de journalisation name. Cette macro permet de déclarer une catégorie de journalisation commune, partagée entre différentes parties du programme.

Cela fonctionne exactement comme ` Q_DECLARE_LOGGING_CATEGORY()`. Cependant, la catégorie de journalisation déclarée par cette macro est en outre qualifiée par ` EXPORT_MACRO`. Cela s'avère utile si la catégorie de journalisation doit être exportée depuis une bibliothèque dynamique.

Par exemple :

Q_DECLARE_EXPORTED_LOGGING_CATEGORY(lcCore, LIB_EXPORT_MACRO)

Cette macro doit être utilisée en dehors d’une classe ou d’une fonction.

Cette macro a été introduite dans Qt 6.5.

Voir également Q_LOGGING_CATEGORY() et Q_DECLARE_LOGGING_CATEGORY().

Q_DECLARE_LOGGING_CATEGORY(name)

Déclare une catégorie de journalisation name. Cette macro permet de déclarer une catégorie de journalisation commune partagée dans différentes parties du programme.

Cette macro doit être utilisée en dehors d'une classe ou d'une méthode.

Voir également Q_LOGGING_CATEGORY() et Q_DECLARE_EXPORTED_LOGGING_CATEGORY().

Q_LOGGING_CATEGORY(name, string)

Définit une catégorie de journalisation name et la rend configurable sous l'identifiant string. Par défaut, tous les types de messages sont activés.

Une seule unité de traduction dans une bibliothèque ou un exécutable peut définir une catégorie portant un nom spécifique. L'objet QLoggingCategory, défini implicitement, est créé lors de sa première utilisation, de manière sûre pour les threads.

Cette macro doit être utilisée en dehors d’une classe ou d’une méthode.

Voir également Q_DECLARE_LOGGING_CATEGORY() et Q_DECLARE_EXPORTED_LOGGING_CATEGORY().

Q_LOGGING_CATEGORY(name, string, msgType)

Définit une catégorie de journalisation name et la rend configurable sous l’identifiant string. Par défaut, les messages de niveau « QtMsgType », « msgType » et de gravité supérieure sont activés ; les types de gravité inférieure sont désactivés.

Une seule unité de traduction dans une bibliothèque ou un exécutable peut définir une catégorie portant un nom spécifique. L’objet QLoggingCategory, défini implicitement, est créé lors de sa première utilisation, de manière sûre pour les threads.

Cette macro doit être utilisée en dehors d’une classe ou d’une méthode.

Voir également Q_DECLARE_LOGGING_CATEGORY().

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string)

Définit une catégorie de journalisation statique name et la rend configurable sous l'identifiant string. Par défaut, tous les types de messages sont activés.

La catégorie de journalisation est créée à l’aide du qualificateur static afin que vous ne puissiez y accéder que dans la même unité de traduction. Cela permet d’éviter les conflits de symboles accidentels.

L'objet QLoggingCategory défini implicitement est créé lors de sa première utilisation, de manière sûre pour les threads.

Cette macro doit être utilisée en dehors d’une classe ou d’une méthode.

Cette macro a été introduite dans Qt 6.9.

Voir aussi Q_LOGGING_CATEGORY().

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

Définit une catégorie de journalisation statique name et la rend configurable sous l'identifiant string. Par défaut, les messages de niveau « QtMsgType », « msgType » et de gravité supérieure sont activés ; les messages de gravité inférieure sont désactivés.

La catégorie de journalisation est créée à l’aide du qualificateur static afin que vous ne puissiez y accéder que dans la même unité de traduction. Cela permet d’éviter les conflits de symboles accidentels.

L’objet QLoggingCategory, défini implicitement, est créé lors de sa première utilisation, de manière sûre pour les threads.

Cette macro doit être utilisée en dehors d’une classe ou d’une méthode.

Cette macro a été introduite dans Qt 6.9.

Voir aussi Q_LOGGING_CATEGORY().

qCCritical(category)

Renvoie un flux de sortie pour les messages critiques de la catégorie de journalisation « category ».

La macro se développe en un code qui vérifie si ` QLoggingCategory::isCriticalEnabled()` renvoie ` true`. Si tel est le cas, les arguments du flux sont traités et envoyés au gestionnaire de messages.

Exemple :

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

Voir également QDebug::qCritical().

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

Enregistre un message critique, message, dans la catégorie de journalisation category. message peut contenir des espaces réservés destinés à être remplacés par des arguments supplémentaires, à l'instar de la fonction printf() en C.

Exemple :

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

Voir également qCritical(const char *, ...).

qCDebug(category)

Renvoie un flux de sortie pour les messages de débogage de la catégorie de journalisation « category ».

La macro se développe en un code qui vérifie si la fonction ` QLoggingCategory::isDebugEnabled()` renvoie la valeur ` true`. Si c'est le cas, les arguments du flux sont traités et envoyés au gestionnaire de messages.

Exemple :

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

Voir aussi QDebug::qDebug().

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

Enregistre un message de débogage, message, dans la catégorie de journalisation category. message peut contenir des espaces réservés destinés à être remplacés par des arguments supplémentaires, à l'instar de la fonction printf() en C.

Exemple :

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

Voir également qDebug(const char *, ...).

[since 6.5] qCFatal(category)

Renvoie un flux de sortie pour les messages fatals de la catégorie de journalisation « category ».

Si vous utilisez le gestionnaire de messages par défaut, le flux renvoyé provoquera un arrêt forcé de l'application afin de créer un vidage de mémoire. Sous Windows, pour les versions de débogage, cette fonction signalera une erreur de type « _CRT_ERROR », ce qui vous permettra de connecter un débogueur à l'application.

Exemple :

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

Cette macro a été introduite dans Qt 6.5.

Voir également QDebug::qFatal().

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

Enregistre un message critique, message, dans la catégorie de journalisation category. message peut contenir des espaces réservés destinés à être remplacés par des arguments supplémentaires, à l'instar de la fonction printf() en C.

Exemple :

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

Si vous utilisez le gestionnaire de messages par défaut, cette fonction provoquera un arrêt forcé afin de créer un vidage de mémoire. Sous Windows, pour les versions de débogage, cette fonction signalera une « _CRT_ERROR » (erreur fatale), ce qui vous permettra de connecter un débogueur à l’application.

Cette macro a été introduite dans Qt 6.5.

Voir également qFatal(const char *, ...).

qCInfo(category)

Renvoie un flux de sortie pour les messages d'information de la catégorie de journalisation « category ».

La macro se développe en un code qui vérifie si la fonction ` QLoggingCategory::isInfoEnabled()` renvoie ` true`. Si tel est le cas, les arguments du flux sont traités et envoyés au gestionnaire de messages.

Exemple :

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

Voir aussi QDebug::qInfo().

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

Enregistre un message d'information, message, dans la catégorie de journalisation category. message peut contenir des espaces réservés destinés à être remplacés par des arguments supplémentaires, à l'instar de la fonction printf() du langage C.

Exemple :

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

Voir également qInfo(const char *, ...).

qCWarning(category)

Renvoie un flux de sortie pour les messages d'avertissement de la catégorie de journalisation « category ».

La macro se développe en un code qui vérifie si QLoggingCategory::isWarningEnabled() donne true. Si c'est le cas, les arguments du flux sont traités et envoyés au gestionnaire de messages.

Exemple :

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

Voir aussi QDebug::qWarning().

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

Enregistre un message d'avertissement, message, dans la catégorie de journalisation category. La chaîne message peut contenir des espaces réservés destinés à être remplacés par des arguments supplémentaires, à l'instar de la fonction printf() du langage C.

Exemple :

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

Voir également qWarning(const char *, ...).