En esta página

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.