Back to Qt.io
Contact Us Blog Download Qt
En esta página

QMessageLogger Class

La clase QMessageLogger genera mensajes de registro. Más...

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

Tipos Públicos

CategoryFunction

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 usa 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 versiones de depuración, y QMessageLogger(0, 0, 0).debug() para versiones 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 de 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()

Construye un QMessageLogger por defecto. Ver los otros constructores para especificar información de contexto.

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

Construye un 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)

Construye un QMessageLogger para grabar category mensajes para file en line en function.

Ver también QLoggingCategory.

QDebug QMessageLogger::critical() const

Registra un mensaje crítico mediante un flujo 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 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. Pueden utilizarse parámetros adicionales, especificados en 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. Parámetros adicionales, especificados por msg, pueden ser utilizados.

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. Pueden utilizarse parámetros adicionales, especificados en msg.

Véase también qCCritical().

QDebug QMessageLogger::debug() const

Registra un mensaje de depuración utilizando un flujo 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 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 utilizando 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. Pueden utilizarse parámetros adicionales, especificados en 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. Parámetros adicionales, especificados por msg, pueden ser utilizados.

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. Parámetros adicionales, especificados por msg, pueden ser utilizados.

Véase también qCDebug().

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

Registra un mensaje fatal utilizando 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. Pueden utilizarse parámetros adicionales, especificados en 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. Parámetros adicionales, especificados por msg, pueden ser utilizados.

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 fatal especificado con el formato msg para el contexto cat. Parámetros adicionales, especificados por msg, pueden ser utilizados.

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 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 utilizando un flujo QDebug.

Véase también qCInfo() y QDebug.

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

Registra un mensaje informativo especificado con el formato msg. Pueden utilizarse 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 especificado con el formato msg para el contexto devuelto por catFunc. Parámetros adicionales, especificados por msg, pueden ser utilizados.

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. Pueden utilizarse parámetros adicionales, especificados en msg.

Véase también qCInfo().

QDebug QMessageLogger::warning() const

Registra un mensaje de advertencia utilizando un flujo 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 utilizando un flujo QDebug.

Véase también qCWarning() y QDebug.

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

Registra un mensaje de advertencia especificado con el formato msg. Pueden utilizarse 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. Parámetros adicionales, especificados por msg, pueden ser utilizados.

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. Pueden utilizarse parámetros adicionales, especificados en 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.