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 allgemeine Protokollierungskategorie zu deklarieren, die in verschiedenen Teilen des Programms gemeinsam genutzt wird.

Dies funktioniert genau wie ` Q_DECLARE_LOGGING_CATEGORY()`. Die durch dieses Makro deklarierte Protokollierungskategorie wird jedoch zusätzlich mit ` EXPORT_MACRO` qualifiziert. Dies ist nützlich, wenn die Protokollierungskategorie aus einer dynamischen Bibliothek exportiert werden soll.

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 allgemeine Protokollierungskategorie zu deklarieren, die in verschiedenen Teilen des Programms gemeinsam genutzt 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)

Definiert eine Protokollierungskategorie „ name “ und macht diese unter dem Bezeichner „ string “ konfigurierbar. Standardmäßig sind alle Meldungstypen aktiviert.

In einer Bibliothek oder einer ausführbaren Datei darf nur eine Übersetzungseinheit eine Kategorie mit einem bestimmten Namen definieren. Das implizit definierte Objekt „ QLoggingCategory “ wird bei der ersten Verwendung auf threadsichere 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)

Definiert eine Protokollierungskategorie „ name “ und macht sie unter dem Bezeichner „ string “ konfigurierbar. Standardmäßig sind Meldungen der Schweregrade „ QtMsgType “, „ msgType “ und höher aktiviert; Meldungen mit niedrigerem Schweregrad sind deaktiviert.

In einer Bibliothek oder einer ausführbaren Datei darf nur eine Übersetzungseinheit eine Kategorie mit einem bestimmten Namen definieren. Das implizit definierte Objekt „ QLoggingCategory “ wird bei der ersten Verwendung auf threadsichere Weise erstellt.

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

Siehe auch ` Q_DECLARE_LOGGING_CATEGORY()`.

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string)

Definiert eine statische Protokollierungskategorie „ name “ und macht sie unter dem Bezeichner „ string “ konfigurierbar. Standardmäßig sind alle Meldungstypen aktiviert.

Die Protokollierungskategorie wird mit dem Qualifizierer „ static “ erstellt, sodass Sie nur innerhalb derselben Übersetzungseinheit darauf zugreifen können. Dadurch werden versehentliche Symbolkonflikte vermieden.

Das implizit definierte Objekt ` QLoggingCategory ` wird bei der ersten Verwendung threadsicher angelegt.

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

Dieses Makro wurde in Qt 6.9 eingeführt.

Siehe auch ` Q_LOGGING_CATEGORY()`.

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string, msgType)

Definiert eine statische Protokollierungskategorie „ name “ und macht sie unter dem Bezeichner „ string “ konfigurierbar. Standardmäßig sind Meldungen der Schweregrade „ QtMsgType “, „ msgType “ und höher aktiviert; Meldungen mit niedrigerem Schweregrad sind deaktiviert.

Die Protokollierungskategorie wird unter Verwendung des Qualifizierers „ static “ erstellt, sodass Sie nur innerhalb derselben Übersetzungseinheit darauf zugreifen können. Dadurch werden versehentliche Symbolkonflikte vermieden.

Das implizit definierte Objekt „ QLoggingCategory “ wird bei der ersten Verwendung threadsicher erstellt.

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

Dieses Makro wurde in Qt 6.9 eingeführt.

Siehe auch ` Q_LOGGING_CATEGORY()`.

qCCritical(category)

Gibt einen Ausgabestrom für kritische Meldungen in der Protokollierungskategorie „ category “ zurück.

Das Makro wird zu Code erweitert, der prüft, ob „ QLoggingCategory::isCriticalEnabled()“ den Wert „ true “ ergibt. Ist dies der Fall, werden die Stream-Argumente verarbeitet und an den Nachrichtenhandler gesendet.

Beispiel:

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

Siehe auch ` QDebug::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(const char *, ...).

qCDebug(category)

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

Das Makro wird zu Code erweitert, der prüft, ob QLoggingCategory::isDebugEnabled() den Wert true ergibt. Ist dies der Fall, werden die Stream-Argumente verarbeitet und an den Nachrichten-Handler gesendet.

Beispiel:

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

Siehe auch ` QDebug::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 bei der C-Funktion printf().

Beispiel:

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

Siehe auch ` qDebug(const char *, ...)`.

[since 6.5] qCFatal(category)

Gibt einen Ausgabestrom für schwerwiegende Meldungen in der Protokollierungskategorie „ category “ zurück.

Wenn Sie den Standard-Meldungshandler verwenden, bricht der zurückgegebene Stream ab, um einen Core-Dump zu erstellen. Unter Windows meldet diese Funktion bei Debug-Builds ein „ _CRT_ERROR “, wodurch Sie einen Debugger an die Anwendung anschließen können.

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 ` QDebug::qFatal()`.

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

Protokolliert eine schwerwiegende 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");
    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 “, sodass Sie einen Debugger an die Anwendung anschließen können.

Dieses Makro wurde in Qt 6.5 eingeführt.

Siehe auch ` qFatal(const char *, ...)`.

qCInfo(category)

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

Das Makro wird zu Code erweitert, der prüft, ob „ QLoggingCategory::isInfoEnabled()“ den Wert „ true “ ergibt. Ist dies der Fall, werden die Stream-Argumente verarbeitet und an den Nachrichten-Handler gesendet.

Beispiel:

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

Siehe auch ` QDebug::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“ (const char *, ...).

qCWarning(category)

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

Das Makro wird zu Code erweitert, der prüft, ob „ QLoggingCategory::isWarningEnabled()“ den Wert „ true “ ergibt. Ist dies der Fall, werden die Stream-Argumente verarbeitet und an den Nachrichtenhandler gesendet.

Beispiel:

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

Siehe auch ` QDebug::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 bei der C-Funktion printf().

Beispiel:

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

Siehe auch qWarning(const char *, ...).