<QtLogging> - Qt Logging Types

Documentation sur les macros

qCritical(const char *format, ...)

Enregistre les messages critiques format dans le gestionnaire de messages central. format peut contenir des spécificateurs de format qui sont remplacés par les valeurs indiqué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. Cela fonctionne de manière similaire à la fonction C printf(). Pour plus de détails sur le formatage, consultez QString::asprintf().

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

Pour désactiver la sortie lors de l’exécution, vous pouvez définir logging rules ou enregistrer une fonction personnalisée filter.

À 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 de mémoire ou de connecter un débogueur — voir également qFatal(). Pour activer cette fonctionnalité, définissez la variable d’environnement QT_FATAL_CRITICALS sur un nombre n. Le programme s’arrête alors au n-ième message critique. Autrement dit, si la variable d’environnement est définie sur 1, le programme s’arrêtera dès le premier appel ; si elle contient la valeur 10, il s’arrêtera au 10e appel. Toute valeur non numérique dans la variable d’environnement équivaut à 1.

Remarque : cette macro est thread-safe.

Voir également 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. Le message format peut contenir des spécificateurs de format qui sont remplacés par les valeurs indiqué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. Ce fonctionnement est similaire à celui de la fonction C printf(). Pour plus de détails sur le formatage, consultez QString::asprintf().

Pour plus de commodité et une prise en charge étendue des types, vous pouvez également utiliser QDebug::qDebug(), qui suit le paradigme de flux (à l’instar de 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 lors de l'exécution, installez votre propre gestionnaire de messages avec qInstallMessageHandler().

Remarque : cette macro est thread-safe.

Voir également 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 les valeurs indiqué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 s'interrompt pour créer un vidage de mémoire. Sous Windows, pour les versions de débogage, cette fonction signale une erreur _CRT_ERROR, ce qui vous permet de connecter un débogueur à l'application.

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

Voir également 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 les valeurs indiqué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. Ce 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 prise en charge étendue des types, vous pouvez également utiliser QDebug::qInfo(), qui suit le paradigme de flux (à l’instar de 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 lors de l'exécution, installez votre propre gestionnaire de messages à l'aide de qInstallMessageHandler().

Remarque : cette macro est thread-safe.

Voir également 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 de messages central. Le message format peut contenir des spécificateurs de format qui sont remplacés par les valeurs indiqué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. Ce fonctionnement est similaire à celui de la fonction C printf(). Pour plus de détails sur le formatage, consultez QString::asprintf().

Pour plus de commodité et une prise en charge étendue des types, vous pouvez également utiliser QDebug::qWarning(), qui suit le paradigme de flux (à l’instar de 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 lors 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’arrêter en cas de messages d’avertissement. Cela vous permet d’inspecter le vidage de mémoire (core dump) ou de connecter un débogueur — voir également qFatal(). Pour activer cette fonctionnalité, définissez la variable d’environnement QT_FATAL_WARNINGS sur un nombre n. Le programme s’arrête alors au n-ième avertissement. Autrement dit, si la variable d’environnement est définie sur 1, le programme s’arrêtera dès le premier appel ; si elle contient la valeur 10, il s’arrêtera au 10e appel. Toute valeur non numérique dans la variable d’environnement équivaut à 1.

Remarque : cette macro est thread-safe.

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