<QtLogging> - Qt Logging Types

Documentation sur les macros

qCritical(const char *format, ...)

Enregistre le message critique format dans le gestionnaire de messages central. format peut contenir des spécificateurs de format qui sont remplacés par des valeurs spécifiées dans des arguments supplémentaires.

Exemple :

void load(const QString &fileName)
{
    QFile file(fileName);
    if (!file.exists())
        qCritical("File '%s' does not exist!", qUtf8Printable(fileName));
}

format peut contenir des spécificateurs de format tels que %s pour les chaînes UTF-8 ou %i pour les entiers. Le fonctionnement est similaire à celui de la fonction C printf(). Pour plus de détails sur le formatage, voir QString::asprintf().

Pour plus de commodité et une meilleure prise en charge des types, vous pouvez également utiliser QDebug::qCritical(), qui suit le paradigme du flux (similaire à std::cout ou std::cerr).

Pour supprimer la sortie au moment de l'exécution, vous pouvez définir logging rules ou enregistrer un filter personnalisé.

À des fins de débogage, il est parfois pratique de laisser le programme s'interrompre en cas de messages critiques. Cela vous permet d'inspecter le vidage du noyau, ou d'attacher un débogueur - voir aussi qFatal(). Pour ce faire, définissez la variable d'environnement QT_FATAL_CRITICALS avec un nombre n. Le programme se termine alors pour le n-ième message critique. En d'autres termes, si la variable d'environnement a la valeur 1, le programme se terminera au premier appel ; si elle contient la valeur 10, il se terminera au dixième appel. Toute valeur non numérique dans la variable d'environnement est équivalente à 1.

Remarque : cette macro est à l'épreuve des threads.

Voir aussi QDebug::qCritical, qCCritical(), qDebug(), qInfo(), qWarning(), qFatal(), qInstallMessageHandler(), et Techniques de débogage.

qDebug(const char *format, ...)

Enregistre le message de débogage format dans le gestionnaire de messages central. format peut contenir des spécificateurs de format qui sont remplacés par des valeurs spécifiées dans des arguments supplémentaires.

Exemple :

qDebug("Items in list: %d", myList.size());

format peut contenir des spécificateurs de format tels que %s pour les chaînes UTF-8 ou %i pour les entiers. Le fonctionnement est similaire à celui de la fonction C printf(). Pour plus de détails sur le formatage, voir QString::asprintf().

Pour plus de commodité et une meilleure prise en charge des types, vous pouvez également utiliser QDebug::qDebug(), qui suit le paradigme du flux (similaire à std::cout ou std::cerr).

Cette fonction ne fait rien si QT_NO_DEBUG_OUTPUT a été défini lors de la compilation.

Pour supprimer la sortie au moment de l'exécution, installez votre propre gestionnaire de messages avec qInstallMessageHandler().

Remarque : cette macro est à l'épreuve des threads.

Voir aussi QDebug::qDebug(), qCDebug(), qInfo(), qWarning(), qCritical(), qFatal(), qInstallMessageHandler(), et Techniques de débogage.

qFatal(const char *format, ...)

Enregistre le message fatal format dans le gestionnaire de messages central. format peut contenir des spécificateurs de format qui sont remplacés par des valeurs spécifiées dans des arguments supplémentaires.

Exemple :

int divide_by_zero(int a, int b)
{
    if (b == 0)                                // program error
        qFatal("divide: cannot divide by zero");
    return a / b;
}

Si vous utilisez le gestionnaire de messages par défaut, cette fonction abandonnera la création d'un core dump. Sous Windows, pour les versions de débogage, cette fonction signalera un _CRT_ERROR vous permettant de connecter un débogueur à l'application.

Pour supprimer la sortie au moment de l'exécution, installez votre propre gestionnaire de messages avec qInstallMessageHandler().

Voir aussi qCFatal(), qDebug(), qInfo(), qWarning(), qCritical(), qInstallMessageHandler(), et Techniques de débogage.

qInfo(const char *format, ...)

Enregistre le message d'information format dans le gestionnaire de messages central. format peut contenir des spécificateurs de format qui sont remplacés par des valeurs spécifiées dans des arguments supplémentaires.

Exemple :

qInfo("Items in list: %d", myList.size());

format peut contenir des spécificateurs de format tels que %s pour les chaînes UTF-8 ou %i pour les entiers. Le fonctionnement est similaire à celui de la fonction C printf(). Pour plus de détails sur le formatage, voir QString::asprintf().

Pour plus de commodité et une meilleure prise en charge des types, vous pouvez également utiliser QDebug::qInfo(), qui suit le paradigme du flux (similaire à std::cout ou std::cerr).

Cette fonction ne fait rien si QT_NO_INFO_OUTPUT a été défini lors de la compilation.

Pour supprimer la sortie au moment de l'exécution, installez votre propre gestionnaire de messages à l'aide de qInstallMessageHandler().

Remarque : cette macro est à l'épreuve des threads.

Voir aussi QDebug::qInfo(), qCInfo(), qDebug(), qWarning(), qCritical(), qFatal(), qInstallMessageHandler(), et Techniques de débogage.

qWarning(const char *format, ...)

Enregistre le message d'avertissement format dans le gestionnaire central de messages. format peut contenir des spécificateurs de format qui sont remplacés par des valeurs spécifiées dans des arguments supplémentaires.

Exemple :

void f(int c)
{
    if (c > 200)
        qWarning("f: bad argument, c == %d", c);
}

format peut contenir des spécificateurs de format tels que %s pour les chaînes UTF-8 ou %i pour les entiers. Le fonctionnement est similaire à celui de la fonction C printf(). Pour plus de détails sur le formatage, voir QString::asprintf().

Pour plus de commodité et une meilleure prise en charge des types, vous pouvez également utiliser QDebug::qWarning(), qui suit le paradigme du flux (similaire à std::cout ou std::cerr).

Cette fonction ne fait rien si QT_NO_WARNING_OUTPUT a été défini lors de la compilation. Pour supprimer la sortie au moment de l'exécution, vous pouvez définir logging rules ou enregistrer un filter personnalisé.

À des fins de débogage, il est parfois pratique de laisser le programme s'interrompre en cas de messages d'avertissement. Cela vous permet d'inspecter le core dump, ou d'attacher un débogueur - voir aussi qFatal(). Pour ce faire, définissez la variable d'environnement QT_FATAL_WARNINGS avec un nombre n. Le programme se termine alors pour le n-ième avertissement. En d'autres termes, si la variable d'environnement a la valeur 1, le programme se terminera au premier appel ; si elle contient la valeur 10, il se terminera au dixième appel. Toute valeur non numérique dans la variable d'environnement est équivalente à 1.

Remarque : cette macro est à l'épreuve des threads.

Voir aussi QDebug::qWarning(), qCWarning(), qDebug(), qInfo(), qCritical(), qFatal(), qInstallMessageHandler(), et Techniques de débogage.