<QtLogging> - Qt Logging Types

Makro-Dokumentation

qCritical(const char *message, ...)

Ruft den Message-Handler mit der kritischen Meldung message auf. Wenn kein Message-Handler installiert ist, wird die Meldung in stderr ausgegeben. Unter Windows wird die Nachricht an den Debugger gesendet. Unter QNX wird die Nachricht an slogger2 gesendet.

Diese Funktion nimmt eine Formatzeichenkette und eine Liste von Argumenten entgegen, ähnlich wie die C-Funktion printf(). Das Format sollte eine Latin-1 Zeichenkette sein.

Beispiel:

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

Wenn Sie <QtDebug> einschließen, ist auch eine bequemere Syntax verfügbar:

qCritical() << "Brush:" << myQBrush << "Other value:" << i;

Zwischen den Elementen wird ein Leerzeichen eingefügt, und am Ende wird ein Zeilenumbruch angehängt.

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

Zu Debugging-Zwecken ist es manchmal praktisch, das Programm bei kritischen Meldungen abbrechen zu lassen. Dadurch können Sie den Kernspeicherauszug untersuchen oder einen Debugger anschließen - siehe auch qFatal(). Um dies zu ermöglichen, setzen Sie die Umgebungsvariable QT_FATAL_CRITICALS auf eine Zahl n. Das Programm bricht dann bei der n-ten kritischen Meldung ab. Das heißt, wenn die Umgebungsvariable auf 1 gesetzt ist, wird es beim ersten Aufruf beendet; wenn sie den Wert 10 enthält, wird es beim zehnten Aufruf beendet. Jeder nicht-numerische Wert in der Umgebungsvariablen ist gleichbedeutend mit 1.

Hinweis: Dieses Makro ist thread-sicher.

Siehe auch qCCritical(), qDebug(), qInfo(), qWarning(), qFatal(), qInstallMessageHandler(), und Debugging-Techniken.

qDebug(const char *message, ...)

Ruft den Message-Handler mit der Debug-Meldung message auf. Wenn kein Message-Handler installiert wurde, wird die Nachricht in stderr ausgegeben. Unter Windows wird die Nachricht an die Konsole gesendet, wenn es sich um eine Konsolenanwendung handelt; andernfalls wird sie an den Debugger gesendet. Unter QNX wird die Nachricht an slogger2 gesendet. Diese Funktion tut nichts, wenn QT_NO_DEBUG_OUTPUT während der Kompilierung definiert wurde.

Wenn Sie der Funktion eine Formatzeichenkette und eine Liste von Argumenten übergeben, arbeitet sie ähnlich wie die C-Funktion printf(). Das Format sollte eine Latin-1 Zeichenkette sein.

Beispiel:

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

Wenn Sie <QtDebug> einbinden, ist auch eine bequemere Syntax verfügbar:

qDebug() << "Brush:" << myQBrush << "Other value:" << i;

Mit dieser Syntax gibt die Funktion ein QDebug Objekt zurück, das für die Verwendung des QtDebugMsg Nachrichtentyps konfiguriert ist. Sie setzt automatisch ein einzelnes Leerzeichen zwischen die einzelnen Elemente und gibt am Ende einen Zeilenumbruch aus. Sie unterstützt viele C++- und Qt-Typen.

Um die Ausgabe zur Laufzeit zu unterdrücken, installieren Sie Ihren eigenen Message-Handler mit qInstallMessageHandler().

Hinweis: Dieses Makro ist thread-sicher.

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

qFatal(const char *message, ...)

Ruft den Message-Handler mit der fatalen Meldung message auf. Wenn kein Message-Handler installiert ist, wird die Meldung in stderr ausgegeben. Unter Windows wird die Nachricht an den Debugger gesendet. Unter QNX wird die Nachricht an slogger2 gesendet.

Wenn Sie den Standard Message Handler verwenden, bricht diese Funktion ab, um einen Core Dump zu erstellen. Unter Windows, für Debug-Builds, meldet diese Funktion einen _CRT_ERROR, der es Ihnen ermöglicht, einen Debugger mit der Anwendung zu verbinden.

Diese Funktion nimmt einen Format-String und eine Liste von Argumenten entgegen, ähnlich wie die C-Funktion printf().

Beispiel:

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

Um die Ausgabe zur Laufzeit zu unterdrücken, installieren Sie Ihren eigenen Message-Handler mit qInstallMessageHandler().

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

qInfo(const char *message, ...)

Ruft den Message-Handler mit der informativen Nachricht message auf. Wenn kein Message-Handler installiert wurde, wird die Nachricht in stderr ausgegeben. Unter Windows wird die Nachricht an die Konsole gesendet, wenn es sich um eine Konsolenanwendung handelt; andernfalls wird sie an den Debugger gesendet. Unter QNX wird die Nachricht an slogger2 gesendet. Diese Funktion tut nichts, wenn QT_NO_INFO_OUTPUT während der Kompilierung definiert wurde.

Wenn Sie der Funktion einen Format-String und eine Liste von Argumenten übergeben, arbeitet sie ähnlich wie die C-Funktion printf(). Das Format sollte eine Latin-1 Zeichenkette sein.

Beispiel:

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

Wenn Sie <QtDebug> einbinden, ist auch eine bequemere Syntax verfügbar:

qInfo() << "Brush:" << myQBrush << "Other value:" << i;

Mit dieser Syntax gibt die Funktion ein QDebug Objekt zurück, das für die Verwendung des QtInfoMsg Nachrichtentyps konfiguriert ist. Sie setzt automatisch ein einzelnes Leerzeichen zwischen die einzelnen Elemente und gibt am Ende einen Zeilenumbruch aus. Sie unterstützt viele C++- und Qt-Typen.

Um die Ausgabe zur Laufzeit zu unterdrücken, installieren Sie Ihren eigenen Message-Handler mit qInstallMessageHandler().

Hinweis: Dieses Makro ist thread-sicher.

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

qWarning(const char *message, ...)

Ruft den Message-Handler mit der Warnmeldung message auf. Wenn kein Message-Handler installiert ist, wird die Meldung in stderr ausgegeben. Unter Windows wird die Nachricht an den Debugger gesendet. Unter QNX wird die Nachricht an slogger2 gesendet.

Diese Funktion nimmt eine Formatzeichenkette und eine Liste von Argumenten entgegen, ähnlich wie die C-Funktion printf(). Das Format sollte eine Latin-1 Zeichenkette sein.

Beispiel:

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

Wenn Sie <QtDebug> einbinden, ist auch eine bequemere Syntax verfügbar:

qWarning() << "Brush:" << myQBrush << "Other value:" << i;

Diese Syntax fügt ein Leerzeichen zwischen den einzelnen Elementen ein und hängt am Ende einen Zeilenumbruch an.

Diese Funktion bewirkt nichts, wenn QT_NO_WARNING_OUTPUT während der Kompilierung definiert wurde. Um die Ausgabe zur Laufzeit zu unterdrücken, können Sie logging rules setzen oder eine eigene filter registrieren.

Zu Debugging-Zwecken ist es manchmal praktisch, das Programm bei Warnmeldungen abbrechen zu lassen. Dadurch können Sie den Kernspeicherauszug untersuchen oder einen Debugger anschließen - siehe auch qFatal(). Um dies zu ermöglichen, setzen Sie die Umgebungsvariable QT_FATAL_WARNINGS auf eine Zahl n. Das Programm bricht dann bei der n-ten Warnung ab. Das heißt, wenn die Umgebungsvariable auf 1 gesetzt ist, wird es beim ersten Aufruf beendet; wenn sie den Wert 10 enthält, wird es beim zehnten Aufruf beendet. Jeder nicht-numerische Wert in der Umgebungsvariablen ist gleichbedeutend mit 1.

Hinweis: Dieses Makro ist thread-sicher.

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