QMessageLogger Class
Die Klasse QMessageLogger erzeugt Logmeldungen. Mehr...
| Kopfzeile: | #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 |
Detaillierte Beschreibung
QMessageLogger wird verwendet, um Meldungen für das Qt Logging Framework zu erzeugen. Normalerweise verwendet man ihn über die Funktionen qDebug(), qInfo(), qWarning(), qCritical oder qFatal(), die eigentlich Makros sind: Zum Beispiel wird qDebug() zu QMessageLogger(__FILE__, __LINE__, Q_FUNC_INFO).debug() für Debug-Builds, und QMessageLogger(0, 0, 0).debug() für Release-Builds erweitert.
Ein Beispiel für die direkte Verwendung ist die Weiterleitung von Fehlern, die von einer Skriptsprache, z. B. QML, stammen:
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 der 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 erzeugt eine Funktionsdeklaration mit dieser Signatur, und Q_LOGGING_CATEGORY erzeugt ihre Definition.
Siehe auch QLoggingCategory.
Dokumentation der Mitgliedsfunktionen
[constexpr] QMessageLogger::QMessageLogger()
Konstruiert einen Standard-QMessageLogger. Siehe die anderen Konstruktoren zur Angabe von Kontextinformationen.
[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function)
Konstruiert einen QMessageLogger zur Aufzeichnung von Protokollmeldungen für file unter line in function. Dies entspricht QMessageLogger(Datei, Zeile, Funktion, "Standard")
[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)
Konstruiert einen QMessageLogger zur Aufzeichnung von category Nachrichten für file auf line in function.
Siehe auch QLoggingCategory.
QDebug QMessageLogger::critical() const
Protokolliert eine kritische Nachricht mit einem QDebug Stream
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 unter Verwendung 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. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCritical().
void QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Protokolliert eine kritische Meldung mit dem Format msg für den von catFunc zurückgegebenen Kontext. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCCritical().
void QMessageLogger::critical(const QLoggingCategory &cat, const char *msg, ...) const
Protokolliert eine kritische Meldung mit dem Format msg für den Kontext cat. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCCritical().
QDebug QMessageLogger::debug() const
Protokolliert eine Debug-Meldung mit einem QDebug Stream
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 unter Verwendung eines QDebug -Streams.
Siehe auch qCDebug() und QDebug.
void QMessageLogger::debug(const char *msg, ...) const
Protokolliert eine Debug-Meldung, die mit dem Format msg angegeben wird. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qDebug().
void QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Protokolliert eine mit dem Format msg angegebene Debug-Meldung für den von catFunc zurückgegebenen Kontext. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCDebug().
void QMessageLogger::debug(const QLoggingCategory &cat, const char *msg, ...) const
Protokolliert eine mit dem Format msg angegebene Debug-Meldung für den Kontext cat. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCDebug().
[since 6.5] QDebug QMessageLogger::fatal() const
Protokolliert eine fatale Meldung unter Verwendung 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 fatale 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 fatale Meldung in der Kategorie cat unter Verwendung 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 fatale Meldung, die mit dem Format msg angegeben wird. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qFatal().
[noexcept, since 6.5] void QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Protokolliert eine fatale Meldung, die mit dem Format msg für den von catFunc zurückgegebenen Kontext angegeben wird. Zusätzliche Parameter, angegeben durch msg, können verwendet 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 fatale Meldung, die mit dem Format msg für den Kontext cat angegeben wird. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Diese Funktion wurde in Qt 6.5 eingeführt.
Siehe auch qCFatal().
QDebug QMessageLogger::info() const
Protokolliert eine Informationsmeldung über einen QDebug Stream.
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 Informationsnachricht in der Kategorie cat unter Verwendung eines QDebug -Streams.
Siehe auch qCInfo() und QDebug.
void QMessageLogger::info(const char *msg, ...) const
Protokolliert eine Informationsmeldung mit dem Format msg. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qInfo().
void QMessageLogger::info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Protokolliert eine Informationsmeldung mit dem Format msg für den von catFunc zurückgegebenen Kontext. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCInfo().
void QMessageLogger::info(const QLoggingCategory &cat, const char *msg, ...) const
Protokolliert eine Informationsmeldung mit dem Format msg für den Kontext cat. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCInfo().
QDebug QMessageLogger::warning() const
Protokolliert eine Warnmeldung unter Verwendung eines QDebug stream
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 unter Verwendung 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. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qWarning().
void QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Protokolliert eine Warnmeldung mit dem Format msg für den von catFunc zurückgegebenen Kontext. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCWarning().
void QMessageLogger::warning(const QLoggingCategory &cat, const char *msg, ...) const
Protokolliert eine Warnmeldung mit dem Format msg für den Kontext cat. Zusätzliche Parameter, angegeben durch msg, können verwendet werden.
Siehe auch qCWarning().
© 2025 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.
