QLoggingCategory Class

Documentación de macros

[since 6.5] Q_DECLARE_EXPORTED_LOGGING_CATEGORY(name, EXPORT_MACRO)

Declara una categoría de registro name. La macro se puede utilizar para declarar una categoría de registro común compartida en diferentes partes del programa.

Funciona exactamente igual que Q_DECLARE_LOGGING_CATEGORY(). Sin embargo, la categoría de registro declarada por esta macro se califica adicionalmente con EXPORT_MACRO. Esto resulta útil si la categoría de registro debe exportarse desde una biblioteca dinámica.

Por ejemplo:

Q_DECLARE_EXPORTED_LOGGING_CATEGORY(lcCore, LIB_EXPORT_MACRO)

Esta macro debe utilizarse fuera de una clase o función.

Esta macro se introdujo en Qt 6.5.

Véase también Q_LOGGING_CATEGORY() y Q_DECLARE_LOGGING_CATEGORY().

Q_DECLARE_LOGGING_CATEGORY(name)

Declara una categoría de registro name. La macro puede usarse para declarar una categoría de registro común compartida en diferentes partes del programa.

Esta macro debe utilizarse fuera de una clase o método.

Véase también Q_LOGGING_CATEGORY() y Q_DECLARE_EXPORTED_LOGGING_CATEGORY().

Q_LOGGING_CATEGORY(name, string)

Define una categoría de registro name, y la hace configurable bajo el identificador string. Por defecto, todos los tipos de mensajes están habilitados.

Sólo una unidad de traducción en una biblioteca o ejecutable puede definir una categoría con un nombre específico. El objeto QLoggingCategory definido implícitamente se crea en el primer uso, de forma segura para los hilos.

Esta macro debe utilizarse fuera de una clase o método.

Véase también Q_DECLARE_LOGGING_CATEGORY() y Q_DECLARE_EXPORTED_LOGGING_CATEGORY().

Q_LOGGING_CATEGORY(name, string, msgType)

Define una categoría de registro name, y la hace configurable bajo el identificador string. Por defecto, los mensajes de QtMsgType msgType y más severos están habilitados, los tipos con una severidad menor están deshabilitados.

Sólo una unidad de traducción en una biblioteca o ejecutable puede definir una categoría con un nombre específico. El objeto QLoggingCategory definido implícitamente se crea en el primer uso, de forma segura para los hilos.

Esta macro debe utilizarse fuera de una clase o método.

Véase también Q_DECLARE_LOGGING_CATEGORY().

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string)

Define una categoría de registro estática name, y la hace configurable bajo el identificador string. Por defecto, todos los tipos de mensajes están habilitados.

La categoría de registro se crea utilizando el cualificador static para que sólo se pueda acceder a ella en la misma unidad de traducción. Esto evita choques accidentales de símbolos.

El objeto implícitamente definido QLoggingCategory se crea en el primer uso, de forma segura para los hilos.

Esta macro debe utilizarse fuera de una clase o método.

Esta macro se introdujo en Qt 6.9.

Véase también Q_LOGGING_CATEGORY().

[since 6.9] Q_STATIC_LOGGING_CATEGORY(name, string, msgType)

Define una categoría de registro estática name, y la hace configurable bajo el identificador string. Por defecto, los mensajes de QtMsgType msgType y más severos están habilitados, los tipos con una severidad menor están deshabilitados.

La categoría de registro se crea utilizando el cualificador static para que sólo se pueda acceder a ella en la misma unidad de traducción. Esto evita choques accidentales de símbolos.

El objeto implícitamente definido QLoggingCategory se crea en el primer uso, de forma segura para los hilos.

Esta macro debe utilizarse fuera de una clase o método.

Esta macro se introdujo en Qt 6.9.

Véase también Q_LOGGING_CATEGORY().

qCCritical(category)

Devuelve un flujo de salida para mensajes críticos en la categoría de registro, category.

La macro se expande a código que comprueba si QLoggingCategory::isCriticalEnabled() se evalúa como true. Si es así, los argumentos del flujo se procesan y se envían al gestor de mensajes.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCCritical(category) << "a critical message";

Véase también QDebug::qCritical().

qCCritical(category, const char *message, ...)

Registra un mensaje crítico, message, en la categoría de registro, category. message puede contener marcadores de posición que se sustituirán por argumentos adicionales, de forma similar a la función printf() de C.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCCritical(category, "a critical message logged into category %s", category.categoryName());

Véase también qCritical(const char *, ...).

qCDebug(category)

Devuelve un flujo de salida para mensajes de depuración en la categoría de registro, category.

La macro se expande a código que comprueba si QLoggingCategory::isDebugEnabled() se evalúa como true. Si es así, los argumentos del flujo se procesan y se envían al gestor de mensajes.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCDebug(category) << "a debug message";

Véase también QDebug::qDebug().

qCDebug(category, const char *message, ...)

Registra un mensaje de depuración, message, en la categoría de registro, category. message puede contener marcadores de posición que se sustituirán por argumentos adicionales, de forma similar a la función printf() de C.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCDebug(category, "a debug message logged into category %s", category.categoryName());

Véase también qDebug(const char *, ...).

[since 6.5] qCFatal(category)

Devuelve un flujo de salida para mensajes fatales en la categoría de registro, category.

Si está utilizando el gestor de mensajes por defecto, el flujo devuelto abortará para crear un volcado del núcleo. En Windows, para construcciones de depuración, esta función informará de un _CRT_ERROR que le permitirá conectar un depurador a la aplicación.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCFatal(category) << "a fatal message. Program will be terminated!";

Esta macro fue introducida en Qt 6.5.

Véase también QDebug::qFatal().

[since 6.5] qCFatal(category, const char *message, ...)

Registra un mensaje fatal, message, en la categoría de registro, category. message puede contener marcadores de posición que se sustituirán por argumentos adicionales, de forma similar a la función printf() de C.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCFatal(category, "a fatal message. Program will be terminated!");

Si está utilizando el gestor de mensajes por defecto, esta función abortará para crear un volcado del núcleo. En Windows, para construcciones de depuración, esta función reportará un _CRT_ERROR permitiéndole conectar un depurador a la aplicación.

Esta macro se introdujo en Qt 6.5.

Ver también qFatal(const char *, ...).

qCInfo(category)

Devuelve un flujo de salida para mensajes informativos en la categoría de registro, category.

La macro se expande a código que comprueba si QLoggingCategory::isInfoEnabled() se evalúa como true. Si es así, los argumentos del flujo se procesan y se envían al gestor de mensajes.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCInfo(category) << "an informational message";

Véase también QDebug::qInfo().

qCInfo(category, const char *message, ...)

Registra un mensaje informativo, message, en la categoría de registro, category. message puede contener marcadores de posición que se sustituirán por argumentos adicionales, de forma similar a la función printf() de C.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCInfo(category, "an informational message logged into category %s", category.categoryName());

Véase también qInfo(const char *, ...).

qCWarning(category)

Devuelve un flujo de salida para mensajes de advertencia en la categoría de registro, category.

La macro se expande a código que comprueba si QLoggingCategory::isWarningEnabled() se evalúa como true. Si es así, los argumentos del flujo se procesan y se envían al gestor de mensajes.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCWarning(category) << "a warning message";

Véase también QDebug::qWarning().

qCWarning(category, const char *message, ...)

Registra un mensaje de advertencia, message, en la categoría de registro, category. message puede contener marcadores de posición que se sustituirán por argumentos adicionales, de forma similar a la función printf() de C.

Ejemplo:

    QLoggingCategory category("driver.usb");
    qCWarning(category, "a warning message logged into category %s", category.categoryName());

Véase también qWarning(const char *, ...).