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.