QLoggingCategory Class

Makro-Dokumentation

[since 6.5] Q_DECLARE_EXPORTED_LOGGING_CATEGORY(name, EXPORT_MACRO)

Deklariert eine Protokollierungskategorie name. Das Makro kann verwendet werden, um eine gemeinsame Protokollierungskategorie zu deklarieren, die in verschiedenen Teilen des Programms verwendet wird.

Dies funktioniert genauso wie Q_DECLARE_LOGGING_CATEGORY(). Allerdings wird die mit diesem Makro deklarierte Protokollierungskategorie zusätzlich mit EXPORT_MACRO qualifiziert. Dies ist nützlich, wenn die Protokollierungskategorie aus einer dynamischen Bibliothek exportiert werden muss.

Ein Beispiel:

Q_DECLARE_EXPORTED_LOGGING_CATEGORY(lcCore, LIB_EXPORT_MACRO)

Dieses Makro muss außerhalb einer Klasse oder Funktion verwendet werden.

Dieses Makro wurde in Qt 6.5 eingeführt.

Siehe auch Q_LOGGING_CATEGORY() und Q_DECLARE_LOGGING_CATEGORY().

Q_DECLARE_LOGGING_CATEGORY(name)

Deklariert eine Protokollierungskategorie name. Das Makro kann verwendet werden, um eine gemeinsame Protokollierungskategorie zu deklarieren, die in verschiedenen Teilen des Programms verwendet wird.

Dieses Makro muss außerhalb einer Klasse oder Methode verwendet werden.

Siehe auch Q_LOGGING_CATEGORY() und Q_DECLARE_EXPORTED_LOGGING_CATEGORY().

Q_LOGGING_CATEGORY(name, string)

Legt eine Protokollierungskategorie name fest und macht sie unter dem Bezeichner string konfigurierbar. Standardmäßig sind alle Nachrichtentypen aktiviert.

Nur eine Übersetzungseinheit in einer Bibliothek oder ausführbaren Datei kann eine Kategorie mit einem bestimmten Namen definieren. Das implizit definierte Objekt QLoggingCategory wird bei der ersten Verwendung auf eine thread-sichere Weise erstellt.

Dieses Makro muss außerhalb einer Klasse oder Methode verwendet werden.

Siehe auch Q_DECLARE_LOGGING_CATEGORY() und Q_DECLARE_EXPORTED_LOGGING_CATEGORY().

Q_LOGGING_CATEGORY(name, string, msgType)

Legt eine Protokollierungskategorie name fest und macht sie unter dem Bezeichner string konfigurierbar. Standardmäßig sind Meldungen von QtMsgType msgType und schwerwiegenderen Typen aktiviert, Typen mit einem geringeren Schweregrad sind deaktiviert.

Nur eine Übersetzungseinheit in einer Bibliothek oder ausführbaren Datei kann eine Kategorie mit einem bestimmten Namen definieren. Das implizit definierte Objekt QLoggingCategory wird bei der ersten Verwendung auf eine thread-sichere Weise erstellt.

Dieses Makro muss außerhalb einer Klasse oder Methode verwendet werden.

Siehe auch Q_DECLARE_LOGGING_CATEGORY().

qCCritical(category)

Gibt einen Ausgabestrom für kritische Nachrichten in der Protokollierungskategorie category zurück.

Das Makro erweitert sich zu einem Code, der prüft, ob QLoggingCategory::isCriticalEnabled() den Wert true ergibt. Wenn ja, werden die Stream-Argumente verarbeitet und an den Message-Handler gesendet.

Beispiel:

    QLoggingCategory category("driver.usb");
    qCCritical(category) << "a critical message";

Siehe auch qCritical().

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

Protokolliert eine kritische Meldung message in der Protokollierungskategorie category. message kann Platzhalter enthalten, die durch zusätzliche Argumente ersetzt werden, ähnlich wie bei der C-Funktion printf().

Beispiel:

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

Siehe auch qCritical().

qCDebug(category)

Gibt einen Ausgabestrom für Debug-Meldungen in der Protokollierungskategorie category zurück.

Das Makro erweitert sich zu einem Code, der prüft, ob QLoggingCategory::isDebugEnabled() den Wert true ergibt. Wenn ja, werden die Stream-Argumente verarbeitet und an den Message-Handler gesendet.

Beispiel:

    QLoggingCategory category("driver.usb");
    qCDebug(category) << "a debug message";

Siehe auch qDebug().

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

Protokolliert eine Debug-Meldung, message, in der Protokollierungskategorie, category. message kann Platzhalter enthalten, die durch zusätzliche Argumente ersetzt werden, ähnlich wie die C-Funktion printf().

Beispiel:

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

Siehe auch qDebug().

[since 6.5] qCFatal(category)

Gibt einen Ausgabestrom für fatale Meldungen in der Kategorie Protokollierung zurück, category.

Wenn Sie den Standard-Meldungs-Handler verwenden, bricht der zurückgegebene Stream ab, um einen Core-Dump zu erstellen. Unter Windows meldet diese Funktion bei Debug-Builds eine _CRT_ERROR, die es Ihnen ermöglicht, einen Debugger mit der Anwendung zu verbinden.

Beispiel:

    QLoggingCategory category("driver.usb");
    qCFatal(category) << "a fatal message. Program will be terminated!";

Dieses Makro wurde in Qt 6.5 eingeführt.

Siehe auch qFatal().

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

Protokolliert eine fatale Meldung, message, in der Protokollierungskategorie, category. message kann Platzhalter enthalten, die durch zusätzliche Argumente ersetzt werden, ähnlich wie die C-Funktion printf().

Beispiel:

    QLoggingCategory category("driver.usb");
    qCFatal(category, "a fatal message. Program will be terminated!");

Wenn Sie den Standard-Meldungshandler verwenden, bricht diese Funktion ab, um einen Core-Dump zu erstellen. Unter Windows meldet diese Funktion bei Debug-Builds eine _CRT_ERROR, die es Ihnen ermöglicht, einen Debugger mit der Anwendung zu verbinden.

Dieses Makro wurde in Qt 6.5 eingeführt.

Siehe auch qFatal().

qCInfo(category)

Gibt einen Ausgabestrom für Informationsmeldungen in der Protokollierungskategorie category zurück.

Das Makro erweitert sich zu einem Code, der prüft, ob QLoggingCategory::isInfoEnabled() den Wert true ergibt. Wenn ja, werden die Stream-Argumente verarbeitet und an den Message-Handler gesendet.

Beispiel:

    QLoggingCategory category("driver.usb");
    qCInfo(category) << "an informational message";

Siehe auch qInfo().

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

Protokolliert eine Informationsmeldung message in der Protokollierungskategorie category. message kann Platzhalter enthalten, die durch zusätzliche Argumente ersetzt werden, ähnlich wie bei der C-Funktion printf().

Beispiel:

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

Siehe auch qInfo().

qCWarning(category)

Gibt einen Ausgabestrom für Warnmeldungen in der Protokollierungskategorie category zurück.

Das Makro erweitert sich zu einem Code, der prüft, ob QLoggingCategory::isWarningEnabled() den Wert true ergibt. Wenn ja, werden die Stream-Argumente verarbeitet und an den Message-Handler gesendet.

Beispiel:

    QLoggingCategory category("driver.usb");
    qCWarning(category) << "a warning message";

Siehe auch qWarning().

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

Protokolliert eine Warnmeldung, message, in der Protokollierungskategorie, category. message kann Platzhalter enthalten, die durch zusätzliche Argumente ersetzt werden, ähnlich wie die C-Funktion printf().

Beispiel:

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

Siehe auch qWarning().