QMessageLogger Class
La clase QMessageLogger genera mensajes de registro. Más información...
| Encabezado: | #include <QMessageLogger> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
Tipos públicos
Funciones públicas
| 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 |
Descripción detallada
QMessageLogger se utiliza para generar mensajes para el marco de registro de Qt. Normalmente se utiliza a través de las funciones qDebug(), qInfo(), qWarning(), qCritical o qFatal(), que en realidad son macros: por ejemplo, qDebug() se expande a QMessageLogger(__FILE__, __LINE__, Q_FUNC_INFO).debug() para compilaciones de depuración y QMessageLogger(0, 0, 0).debug() para compilaciones de lanzamiento.
Un ejemplo de uso directo es reenviar errores que provienen de un lenguaje de scripting, por ejemplo, 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();
}
}
}Véase también QMessageLogContext, qDebug(), qInfo(), qWarning(), qCritical() y qFatal().
Documentación sobre los tipos de miembros
QMessageLogger::CategoryFunction
Se trata de un `typedef` para un puntero a una función con la siguiente firma:
const QLoggingCategory &category();La macro « Q_DECLARE_LOGGING_CATEGORY » genera una declaración de función con esta firma, y « Q_LOGGING_CATEGORY » genera su definición.
Véase también QLoggingCategory.
Documentación de funciones miembro
[constexpr] QMessageLogger::QMessageLogger()
Crea un objeto QMessageLogger predeterminado. Consulta los demás constructores para especificar información de contexto.
[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function)
Crea un objeto `QMessageLogger` para registrar mensajes de registro para « file » en « line » en « function ». Es equivalente a `QMessageLogger(file, line, function, "default")`.
[constexpr] QMessageLogger::QMessageLogger(const char *file, int line, const char *function, const char *category)
Crea un objeto `QMessageLogger` para registrar mensajes de ` category ` para ` file ` en ` line `, en ` function`.
Véase también QLoggingCategory.
QDebug QMessageLogger::critical() const
Registra un mensaje crítico utilizando un flujo de QDebug
Véase también qCritical() y QDebug.
QDebug QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc) const
Registra un mensaje crítico en la categoría devuelta por catFunc utilizando un flujo de QDebug.
Véase también qCCritical() y QDebug.
QDebug QMessageLogger::critical(const QLoggingCategory &cat) const
Registra un mensaje crítico en la categoría « cat » utilizando un flujo « QDebug ».
Véase también ` qCCritical()` y ` QDebug`.
void QMessageLogger::critical(const char *msg, ...) const
Registra un mensaje crítico especificado con el formato msg. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qCritical().
void QMessageLogger::critical(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Registra un mensaje crítico especificado con el formato msg para el contexto devuelto por catFunc. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qCCritical().
void QMessageLogger::critical(const QLoggingCategory &cat, const char *msg, ...) const
Registra un mensaje crítico especificado con el formato msg para el contexto cat. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qCCritical().
QDebug QMessageLogger::debug() const
Registra un mensaje de depuración utilizando un flujo de « QDebug »
Véase también qDebug() y QDebug.
QDebug QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc) const
Registra un mensaje de depuración en la categoría devuelta por ` catFunc ` utilizando un flujo de tipo ` QDebug `.
Véase también qCDebug() y QDebug.
QDebug QMessageLogger::debug(const QLoggingCategory &cat) const
Registra un mensaje de depuración en la categoría « cat » mediante un flujo « QDebug ».
Véase también ` qCDebug()` y ` QDebug`.
void QMessageLogger::debug(const char *msg, ...) const
Registra un mensaje de depuración especificado con el formato msg. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qDebug().
void QMessageLogger::debug(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Registra un mensaje de depuración especificado con el formato msg para el contexto devuelto por catFunc. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qCDebug().
void QMessageLogger::debug(const QLoggingCategory &cat, const char *msg, ...) const
Registra un mensaje de depuración especificado con el formato msg para el contexto cat. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qCDebug().
[since 6.5] QDebug QMessageLogger::fatal() const
Registra un mensaje grave mediante un flujo « QDebug ».
Esta función se introdujo en Qt 6.5.
Véase también « qFatal()» y « QDebug ».
[since 6.5] QDebug QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc) const
Registra un mensaje fatal en la categoría devuelta por ` catFunc ` utilizando un flujo ` QDebug `.
Esta función se introdujo en Qt 6.5.
Véase también ` qCFatal()` y ` QDebug`.
[since 6.5] QDebug QMessageLogger::fatal(const QLoggingCategory &cat) const
Registra un mensaje fatal en la categoría « cat » utilizando un flujo « QDebug ».
Esta función se introdujo en Qt 6.5.
Véase también qCFatal() y QDebug.
[noexcept] void QMessageLogger::fatal(const char *msg, ...) const
Registra un mensaje fatal especificado con el formato msg. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qFatal().
[noexcept, since 6.5] void QMessageLogger::fatal(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Registra un mensaje fatal especificado con el formato msg para el contexto devuelto por catFunc. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Esta función se introdujo en Qt 6.5.
Véase también qCFatal().
[noexcept, since 6.5] void QMessageLogger::fatal(const QLoggingCategory &cat, const char *msg, ...) const
Registra un mensaje crítico especificado con el formato msg para el contexto cat. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Esta función se introdujo en Qt 6.5.
Véase también ` qCFatal()`.
QDebug QMessageLogger::info() const
Registra un mensaje informativo utilizando un flujo de « QDebug ».
Véase también qInfo() y QDebug.
QDebug QMessageLogger::info(QMessageLogger::CategoryFunction catFunc) const
Registra un mensaje informativo en la categoría devuelta por ` catFunc ` utilizando un flujo ` QDebug `.
Véase también qCInfo() y QDebug.
QDebug QMessageLogger::info(const QLoggingCategory &cat) const
Registra un mensaje informativo en la categoría « cat » mediante un flujo « QDebug ».
Véase también ` qCInfo()` y ` QDebug`.
void QMessageLogger::info(const char *msg, ...) const
Registra un mensaje informativo con el formato especificado en msg. Se pueden utilizar parámetros adicionales, especificados en msg.
Véase también qInfo().
void QMessageLogger::info(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Registra un mensaje informativo con el formato msg para el contexto devuelto por catFunc. Se pueden utilizar parámetros adicionales, especificados en msg.
Véase también qCInfo().
void QMessageLogger::info(const QLoggingCategory &cat, const char *msg, ...) const
Registra un mensaje informativo especificado con el formato msg para el contexto cat. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qCInfo().
QDebug QMessageLogger::warning() const
Registra un mensaje de advertencia utilizando un flujo de QDebug
Véase también qWarning() y QDebug.
QDebug QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc) const
Registra un mensaje de advertencia en la categoría devuelta por catFunc utilizando un flujo QDebug.
Véase también qCWarning() y QDebug.
QDebug QMessageLogger::warning(const QLoggingCategory &cat) const
Registra un mensaje de advertencia en la categoría « cat » mediante un flujo « QDebug ».
Véase también qCWarning() y QDebug.
void QMessageLogger::warning(const char *msg, ...) const
Registra un mensaje de advertencia con el formato especificado en msg. Se pueden utilizar parámetros adicionales, especificados en msg.
Véase también qWarning().
void QMessageLogger::warning(QMessageLogger::CategoryFunction catFunc, const char *msg, ...) const
Registra un mensaje de advertencia especificado con el formato msg para el contexto devuelto por catFunc. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también qCWarning().
void QMessageLogger::warning(const QLoggingCategory &cat, const char *msg, ...) const
Registra un mensaje de advertencia especificado con el formato msg para el contexto cat. Se pueden utilizar parámetros adicionales, especificados mediante msg.
Véase también 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.