Auf dieser Seite

QMessageLogger Class

Die Klasse „QMessageLogger“ generiert Protokollmeldungen. Mehr...

Header: #include <QMessageLogger>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Öffentliche Typen

Öffentliche Funktionen

QMessageLogger()
QMessageLogger(const char *file, int line, const char *function)
QMessageLogger(const char *file, int line, const char *function, const char *category)
QDebug critical() const
QDebug critical(QMessageLogger::CategoryFunction catFunc) const
QDebug critical(const QLoggingCategory &cat) const
void critical(const char *msg, ...) const
void critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void critical(const QLoggingCategory &cat, const char *msg, ...) const
QDebug debug() const
QDebug debug(QMessageLogger::CategoryFunction catFunc) const
QDebug debug(const QLoggingCategory &cat) const
void debug(const char *msg, ...) const
void debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void debug(const QLoggingCategory &cat, const char *msg, ...) const
(since 6.5) QDebug fatal() const
(since 6.5) QDebug fatal(QMessageLogger::CategoryFunction catFunc) const
(since 6.5) QDebug fatal(const QLoggingCategory &cat) const
void fatal(const char *msg, ...) const
(since 6.5) void fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
(since 6.5) void fatal(const QLoggingCategory &cat, const char *msg, ...) const
QDebug info() const
QDebug info(QMessageLogger::CategoryFunction catFunc) const
QDebug info(const QLoggingCategory &cat) const
void info(const char *msg, ...) const
void info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void info(const QLoggingCategory &cat, const char *msg, ...) const
QDebug warning() const
QDebug warning(QMessageLogger::CategoryFunction catFunc) const
QDebug warning(const QLoggingCategory &cat) const
void warning(const char *msg, ...) const
void warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
void warning(const QLoggingCategory &cat, const char *msg, ...) const

Ausführliche Beschreibung

QMessageLogger wird zur Erzeugung von Meldungen für das Qt-Logging-Framework verwendet. In der Regel wird es über die Funktionen „ qDebug()“, „ qInfo()“, „ qWarning()“, „ qCritical “ oder „ qFatal()“ verwendet, bei denen es sich eigentlich um Makros handelt: Beispielsweise wird „ qDebug()“ zu „QMessageLogger(__FILE__, __LINE__, Q_FUNC_INFO “ erweitert. „debug()“ für Debug-Builds und „QMessageLogger(0, 0, 0)“. „debug()“ für Release-Builds.

Ein Beispiel für die direkte Verwendung ist die Weiterleitung von Fehlern, die aus einer Skriptsprache stammen, z. B. QML:

    void statusChanged(QQmlComponent::Status status) {
        if (status == QQmlComponent::Error) {
            for (const QQmlError &error: std::as_const(component->errors())) {
                const QByteArray file = error.url().toEncoded();
                QMessageLogger(file.constData(), error.line(), 0).debug() << error.description();
            }
        }
    }

Siehe auch QMessageLogContext, qDebug(), qInfo(), qWarning(), qCritical() und qFatal().

Dokumentation zu Mitgliedstypen

QMessageLogger::CategoryFunction

Dies ist ein `typedef` für einen Zeiger auf eine Funktion mit der folgenden Signatur:

    const QLoggingCategory &category();

Das Makro „ Q_DECLARE_LOGGING_CATEGORY “ generiert eine Funktionsdeklaration mit dieser Signatur, und „ Q_LOGGING_CATEGORY “ generiert deren Definition.

Siehe auch QLoggingCategory.

Dokumentation zu Mitgliedsfunktionen

[constexpr] QMessageLogger::QMessageLogger()

Erstellt einen QMessageLogger mit Standardwerten. Informationen zur Angabe von Kontextdaten finden Sie bei den anderen Konstruktoren.

[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function)

Erstellt einen QMessageLogger, um Protokollmeldungen für „ file “ unter „ line “ in „ function “ aufzuzeichnen. Dies entspricht QMessageLogger(file, line, function, „default“).

[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)

Erstellt einen QMessageLogger zur Protokollierung von „ category “-Meldungen für „ file “ unter line in function.

Siehe auch QLoggingCategory.

QDebug QMessageLogger::critical() const

Protokolliert eine kritische Meldung mithilfe eines „ QDebug “-Streams

Siehe auch „ qCritical()“ und „ QDebug “.

QDebug QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc) const

Protokolliert eine kritische Meldung in der von catFunc zurückgegebenen Kategorie unter Verwendung eines QDebug -Streams.

Siehe auch qCCritical() und QDebug.

QDebug QMessageLogger::critical(const QLoggingCategory &cat) const

Protokolliert eine kritische Meldung in der Kategorie „ cat “ mithilfe eines „ QDebug “-Streams.

Siehe auch „ qCCritical()“ und „ QDebug “.

void QMessageLogger::critical(const char *msg, ...) const

Protokolliert eine kritische Meldung, die mit dem Format msg angegeben wird. Es können zusätzliche Parameter verwendet werden, die durch msg festgelegt werden.

Siehe auch qCritical().

void QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

Protokolliert eine kritische Meldung, die mit dem Format „ msg “ für den von „ catFunc “ zurückgegebenen Kontext angegeben wird. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Siehe auch qCCritical().

void QMessageLogger::critical(const QLoggingCategory &cat, const char *msg, ...) const

Protokolliert eine kritische Meldung, die mit dem Format „ msg “ für den Kontext „ cat “ angegeben wurde. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Siehe auch ` qCCritical()`.

QDebug QMessageLogger::debug() const

Protokolliert eine Debug-Meldung mithilfe eines „ QDebug “-Streams

Siehe auch „ qDebug()“ und „ QDebug “.

QDebug QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc) const

Protokolliert eine Debug-Meldung in der von ` catFunc ` zurückgegebenen Kategorie unter Verwendung eines ` QDebug `-Streams.

Siehe auch „ qCDebug()“ und „ QDebug “.

QDebug QMessageLogger::debug(const QLoggingCategory &cat) const

Protokolliert eine Debug-Meldung in der Kategorie „ cat “ mithilfe eines „ QDebug “-Streams.

Siehe auch „ qCDebug()“ und „ QDebug “.

void QMessageLogger::debug(const char *msg, ...) const

Protokolliert eine Debug-Meldung, die im Format „ msg “ angegeben wird. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Siehe auch qDebug().

void QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

Protokolliert eine Debug-Meldung, die im Format „ msg “ für den von „ catFunc “ zurückgegebenen Kontext angegeben wird. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Siehe auch qCDebug().

void QMessageLogger::debug(const QLoggingCategory &cat, const char *msg, ...) const

Protokolliert eine Debug-Meldung, die im Format „ msg “ für den Kontext „ cat “ angegeben wurde. Es können zusätzliche Parameter verwendet werden, die über „ msg “ angegeben werden.

Siehe auch qCDebug().

[since 6.5] QDebug QMessageLogger::fatal() const

Protokolliert eine schwerwiegende Meldung mithilfe eines „ QDebug “-Streams.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch „ qFatal()“ und „ QDebug “.

[since 6.5] QDebug QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc) const

Protokolliert eine schwerwiegende Meldung in der von „ catFunc “ zurückgegebenen Kategorie unter Verwendung eines „ QDebug “-Streams.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch „ qCFatal()“ und „ QDebug “.

[since 6.5] QDebug QMessageLogger::fatal(const QLoggingCategory &cat) const

Protokolliert eine schwerwiegende Meldung in der Kategorie „ cat “ mithilfe eines „ QDebug “-Streams.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch „ qCFatal()“ und „ QDebug “.

[noexcept] void QMessageLogger::fatal(const char *msg, ...) const

Protokolliert eine schwerwiegende Meldung, die mit dem Format „ msg “ angegeben wird. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Siehe auch qFatal().

[noexcept, since 6.5] void QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

Protokolliert eine schwerwiegende Meldung, die mit dem Format „ msg “ für den von ` catFunc` zurückgegebenen Kontext angegeben wird. Es können zusätzliche Parameter verwendet werden, die über ` msg` festgelegt werden.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch qCFatal().

[noexcept, since 6.5] void QMessageLogger::fatal(const QLoggingCategory &cat, const char *msg, ...) const

Protokolliert eine schwerwiegende Meldung, die mit dem Format „ msg “ für den Kontext „ cat “ angegeben wurde. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch ` qCFatal()`.

QDebug QMessageLogger::info() const

Protokolliert eine Informationsmeldung mithilfe eines „ QDebug “-Streams.

Siehe auch „ qInfo()“ und „ QDebug “.

QDebug QMessageLogger::info(QMessageLogger::CategoryFunction catFunc) const

Protokolliert eine Informationsmeldung in der von catFunc zurückgegebenen Kategorie unter Verwendung eines QDebug -Streams.

Siehe auch qCInfo() und QDebug.

QDebug QMessageLogger::info(const QLoggingCategory &cat) const

Protokolliert eine Informationsmeldung in der Kategorie „ cat “ mithilfe eines „ QDebug “-Streams.

Siehe auch „ qCInfo()“ und „ QDebug “.

void QMessageLogger::info(const char *msg, ...) const

Protokolliert eine Informationsmeldung, die mit dem Format „ msg “ angegeben wird. Es können zusätzliche Parameter verwendet werden, die durch „ msg “ festgelegt werden.

Siehe auch qInfo().

void QMessageLogger::info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

Protokolliert eine Informationsmeldung, die im Format „ msg “ für den von „ catFunc “ zurückgegebenen Kontext angegeben ist. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Siehe auch qCInfo().

void QMessageLogger::info(const QLoggingCategory &cat, const char *msg, ...) const

Protokolliert eine Informationsmeldung, die im Format „ msg “ für den Kontext „ cat “ angegeben wird. Es können zusätzliche Parameter verwendet werden, die über „ msg “ angegeben werden.

Siehe auch qCInfo().

QDebug QMessageLogger::warning() const

Protokolliert eine Warnmeldung mithilfe eines „ QDebug “-Streams

Siehe auch „ qWarning()“ und „ QDebug “.

QDebug QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc) const

Protokolliert eine Warnmeldung in der von ` catFunc ` zurückgegebenen Kategorie unter Verwendung eines ` QDebug `-Streams.

Siehe auch qCWarning() und QDebug.

QDebug QMessageLogger::warning(const QLoggingCategory &cat) const

Protokolliert eine Warnmeldung in der Kategorie „ cat “ mithilfe eines „ QDebug “-Streams.

Siehe auch „ qCWarning()“ und „ QDebug “.

void QMessageLogger::warning(const char *msg, ...) const

Protokolliert eine Warnmeldung, die mit dem Format „ msg “ angegeben wird. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Siehe auch qWarning().

void QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const

Protokolliert eine Warnmeldung im Format „ msg “ für den von „ catFunc “ zurückgegebenen Kontext. Es können zusätzliche Parameter verwendet werden, die über „ msg “ angegeben werden.

Siehe auch qCWarning().

void QMessageLogger::warning(const QLoggingCategory &cat, const char *msg, ...) const

Protokolliert eine Warnmeldung, die im Format „ msg “ für den Kontext „ cat “ angegeben ist. Es können zusätzliche Parameter verwendet werden, die über „ msg “ festgelegt werden.

Siehe auch qCWarning().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.