QLoggingCategory Class

Documentation sur les macros

[since 6.5] Q_DECLARE_EXPORTED_LOGGING_CATEGORY(name, EXPORT_MACRO)

Déclare une catégorie de journalisation name. Cette macro peut être utilisée pour déclarer une catégorie de journalisation commune à différentes parties du programme.

Elle fonctionne exactement comme Q_DECLARE_LOGGING_CATEGORY(). Cependant, la catégorie de journalisation déclarée par cette macro est qualifiée par EXPORT_MACRO. Ceci est utile si la catégorie de journalisation doit être exportée à partir d'une bibliothèque dynamique.

Par exemple, cette macro doit être utilisée en dehors d'une bibliothèque dynamique :

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 aussi Q_LOGGING_CATEGORY() et Q_DECLARE_LOGGING_CATEGORY().

Q_DECLARE_LOGGING_CATEGORY(name)

Déclare une catégorie de journalisation name. La macro peut être utilisée pour 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 aussi 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 avec un nom spécifique. L'objet QLoggingCategory, défini implicitement, est créé lors de la première utilisation, à l'abri des threads.

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

Voir aussi 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 QtMsgType msgType et plus graves 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 avec un nom spécifique. L'objet QLoggingCategory implicitement défini est créé lors de la première utilisation, à l'abri des threads.

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

Voir aussi 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 de sorte que vous ne puissiez y accéder que dans la même unité de traduction. Cela permet d'éviter les collisions accidentelles de symboles.

L'objet QLoggingCategory, défini implicitement, est créé lors de la première utilisation, à l'abri des 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 QtMsgType msgType et plus graves sont activés, les types de gravité inférieure sont désactivés.

La catégorie de journalisation est créée à l'aide du qualificateur static, de sorte qu'elle n'est accessible que dans la même unité de traduction. Cela permet d'éviter les collisions accidentelles de symboles.

L'objet QLoggingCategory, défini implicitement, est créé lors de la première utilisation, à l'abri des 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 dans la catégorie de journalisation, category.

La macro se développe en code qui vérifie si QLoggingCategory::isCriticalEnabled() est évalué à 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");
    qCCritical(category) << "a critical message";

Voir aussi QDebug::qCritical().

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

Enregistre un message critique, message, dans la catégorie d'enregistrement, category. message peut contenir des caractères de remplacement à remplacer par des arguments supplémentaires, comme dans la fonction printf() du langage C.

Exemple :

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

Voir aussi qCritical(const char *, ...).

qCDebug(category)

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

La macro se développe en code qui vérifie si QLoggingCategory::isDebugEnabled() est évalué à 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 d'enregistrement, category. message peut contenir des caractères de remplacement à remplacer par des arguments supplémentaires, comme la fonction printf() du langage C.

Exemple :

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

Voir aussi qDebug(const char *, ...).

[since 6.5] qCFatal(category)

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

Si vous utilisez le gestionnaire de messages par défaut, le flux retourné sera interrompu pour créer un core dump. Sous Windows, pour les versions de débogage, cette fonction renvoie une adresse _CRT_ERROR qui vous permet 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 aussi QDebug::qFatal().

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

Enregistre un message fatal, message, dans la catégorie d'enregistrement, category. message peut contenir des caractères de remplacement à remplacer par des arguments supplémentaires, comme la fonction printf() du langage 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 s'interrompra pour créer un core dump. Sous Windows, pour les versions de débogage, cette fonction signalera une adresse _CRT_ERROR vous permettant de connecter un débogueur à l'application.

Cette macro a été introduite dans Qt 6.5.

Voir aussi qFatal(const char *, ...).

qCInfo(category)

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

La macro se développe en code qui vérifie si QLoggingCategory::isInfoEnabled() est évalué à 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");
    qCInfo(category) << "an informational message";

Voir aussi QDebug::qInfo().

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

Enregistre un message d'information, message, dans la catégorie d'enregistrement, category. message peut contenir des caractères de remplacement à remplacer par des arguments supplémentaires, comme la fonction printf() du langage C.

Exemple :

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

Voir aussi qInfo(const char *, ...).

qCWarning(category)

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

La macro se développe en code qui vérifie si QLoggingCategory::isWarningEnabled() est évalué à 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 d'enregistrement, category. message peut contenir des caractères de remplacement à remplacer par des arguments supplémentaires, comme dans la fonction printf() du langage C.

Exemple :

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

Voir aussi qWarning(const char *, ...).