<QtLogging> - Qt Logging Types

Makro-Dokumentation

qCritical(const char *format, ...)

Protokolliert kritische Meldungen format an den zentralen Meldungshandler. format kann Formatangaben enthalten, die durch in zusätzlichen Argumenten angegebene Werte ersetzt werden.

Beispiel:

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

format kann Formatbezeichner wie %s für UTF-8-Zeichenketten oder %i für Ganzzahlen enthalten. Dies entspricht in etwa der Funktionsweise der C-Funktion ` printf() `. Weitere Details zur Formatierung finden Sie unter ` QString::asprintf()`.

Für mehr Komfort und eine umfassendere Typunterstützung können Sie auch QDebug::qCritical() verwenden, das dem Streaming-Paradigma folgt (ähnlich wie std::cout oder std::cerr).

Um die Ausgabe zur Laufzeit zu unterdrücken, können Sie logging rules definieren oder ein benutzerdefiniertes filter registrieren.

Zu Debugging-Zwecken ist es manchmal sinnvoll, das Programm bei kritischen Meldungen abbrechen zu lassen. So können Sie den Core-Dump untersuchen oder einen Debugger anhängen – siehe auch qFatal(). Um dies zu aktivieren, setzen Sie die Umgebungsvariable QT_FATAL_CRITICALS auf eine Zahl n. Das Programm wird dann bei der n-ten kritischen Meldung beendet. Das heißt, wenn die Umgebungsvariable auf 1 gesetzt ist, wird das Programm beim ersten Aufruf beendet; wenn sie den Wert 10 enthält, wird es beim 10. Aufruf beendet. Jeder nicht-numerische Wert in der Umgebungsvariable entspricht dem Wert 1.

Hinweis: Dieses Makro ist threadsicher.

Siehe auch QDebug::qCritical, qCCritical(), qDebug(), qInfo(), qWarning(), qFatal(), qInstallMessageHandler() sowie Debugging-Techniken.

qDebug(const char *format, ...)

Protokolliert die Debug-Meldung „ format “ im zentralen Meldungshandler. „ format “ kann Formatangaben enthalten, die durch in zusätzlichen Argumenten angegebene Werte ersetzt werden.

Beispiel:

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

format kann Formatbezeichner wie %s für UTF-8-Zeichenketten oder %i für Ganzzahlen enthalten. Dies ähnelt der Funktionsweise der C-Funktion „ printf() “. Weitere Details zur Formatierung finden Sie unter QString::asprintf().

Für mehr Komfort und eine umfassendere Typunterstützung können Sie auch QDebug::qDebug() verwenden, das dem Streaming-Paradigma folgt (ähnlich wie std::cout oder std::cerr).

Diese Funktion führt keine Aktion aus, wenn QT_NO_DEBUG_OUTPUT während der Kompilierung definiert wurde.

Um die Ausgabe zur Laufzeit zu unterdrücken, implementieren Sie Ihren eigenen Meldungshandler mit qInstallMessageHandler().

Hinweis: Dieses Makro ist threadsicher.

Siehe auch QDebug::qDebug(), qCDebug(), qInfo(), qWarning(), qCritical(), qFatal(), qInstallMessageHandler() und Debugging-Techniken.

qFatal(const char *format, ...)

Protokolliert die schwerwiegende Meldung „ format “ im zentralen Meldungshandler. „ format “ kann Formatangaben enthalten, die durch in zusätzlichen Argumenten angegebene Werte ersetzt werden.

Beispiel:

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

Wenn Sie den Standard-Meldungshandler verwenden, bricht diese Funktion ab, um einen Core-Dump zu erstellen. Unter Windows meldet diese Funktion bei Debug-Builds einen _CRT_ERROR, sodass Sie einen Debugger an die Anwendung anschließen können.

Um die Ausgabe zur Laufzeit zu unterdrücken, implementieren Sie Ihren eigenen Meldungshandler mit ` qInstallMessageHandler()`.

Siehe auch qCFatal(), qDebug(), qInfo(), qWarning(), qCritical(), qInstallMessageHandler() und Debugging-Techniken.

qInfo(const char *format, ...)

Protokolliert die Informationsmeldung „ format “ im zentralen Meldungshandler. „ format “ kann Formatangaben enthalten, die durch in zusätzlichen Argumenten angegebene Werte ersetzt werden.

Beispiel:

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

format kann Formatbezeichner wie „ %s “ für UTF-8-Zeichenketten oder „ %i “ für Ganzzahlen enthalten. Dies entspricht in etwa der Funktionsweise der C-Funktion „ printf() “. Weitere Details zur Formatierung finden Sie unter „ QString::asprintf()“.

Für mehr Komfort und eine umfassendere Typunterstützung können Sie auch QDebug::qInfo() verwenden, das dem Streaming-Paradigma folgt (ähnlich wie std::cout oder std::cerr).

Diese Funktion führt keine Aktion aus, wenn QT_NO_INFO_OUTPUT während der Kompilierung definiert wurde.

Um die Ausgabe zur Laufzeit zu unterdrücken, implementieren Sie Ihren eigenen Meldungshandler mit qInstallMessageHandler().

Hinweis: Dieses Makro ist threadsicher.

Siehe auch QDebug::qInfo(), qCInfo(), qDebug(), qWarning(), qCritical(), qFatal(), qInstallMessageHandler() und Debugging-Techniken.

qWarning(const char *format, ...)

Protokolliert die Warnmeldung „ format “ im zentralen Meldungshandler. „ format “ kann Formatangaben enthalten, die durch in zusätzlichen Argumenten angegebene Werte ersetzt werden.

Beispiel:

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

format kann Formatbezeichner wie %s für UTF-8-Zeichenketten oder %i für Ganzzahlen enthalten. Dies ähnelt der Funktionsweise der C-Funktion „ printf() “. Weitere Details zur Formatierung finden Sie unter QString::asprintf().

Für mehr Komfort und eine umfassendere Typunterstützung können Sie auch QDebug::qWarning() verwenden, das dem Streaming-Paradigma folgt (ähnlich wie std::cout oder std::cerr).

Diese Funktion führt keine Aktion aus, wenn QT_NO_WARNING_OUTPUT bei der Kompilierung definiert wurde. Um die Ausgabe zur Laufzeit zu unterdrücken, können Sie logging rules setzen oder ein benutzerdefiniertes filter registrieren.

Zu Debugging-Zwecken ist es manchmal sinnvoll, das Programm bei Warnmeldungen abbrechen zu lassen. So können Sie den Core-Dump untersuchen oder einen Debugger anschließen – siehe auch qFatal(). Um dies zu aktivieren, setzen Sie die Umgebungsvariable QT_FATAL_WARNINGS auf eine Zahl n. Das Programm wird dann bei der n-ten Warnung beendet. Das heißt, wenn die Umgebungsvariable auf 1 gesetzt ist, wird das Programm beim ersten Aufruf beendet; wenn sie den Wert 10 enthält, wird es beim 10. Aufruf beendet. Jeder nicht-numerische Wert in der Umgebungsvariable entspricht dem Wert 1.

Hinweis: Dieses Makro ist threadsicher.

Siehe auch QDebug::qWarning(), qCWarning(), qDebug(), qInfo(), qCritical(), qFatal(), qInstallMessageHandler() und Debugging-Techniken.