En esta página

QDebug Class

La clase QDebug proporciona un flujo de salida para la información de depuración. Más información...

Cabecera: #include <QDebug>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredado de: QIODeviceBase
Heredado por:

QQmlInfo

Tipos públicos

enum VerbosityLevel { MinimumVerbosity, DefaultVerbosity, MaximumVerbosity }

Funciones públicas

(since 6.9) QDebug(QByteArray *byteArray)
QDebug(QIODevice *device)
QDebug(QString *string)
QDebug(QtMsgType t)
QDebug(const QDebug &o)
~QDebug()
bool autoInsertSpaces() const
QDebug &maybeQuote(char c = '"')
QDebug &maybeSpace()
QDebug &noquote()
QDebug &nospace()
QDebug &quote()
(since 6.7) bool quoteStrings() const
QDebug &resetFormat()
void setAutoInsertSpaces(bool b)
(since 6.7) void setQuoteStrings(bool b)
void setVerbosity(int verbosityLevel)
QDebug &space()
void swap(QDebug &other)
int verbosity() const
QDebug &verbosity(int verbosityLevel)
(since 6.0) QDebug &operator<<(QByteArrayView t)
QDebug &operator<<(QChar t)
QDebug &operator<<(QLatin1StringView t)
QDebug &operator<<(QStringView s)
(since 6.0) QDebug &operator<<(QUtf8StringView s)
(since 6.7) QDebug &operator<<(T i)
(since 6.7) QDebug &operator<<(T i)
QDebug &operator<<(bool t)
QDebug &operator<<(char t)
QDebug &operator<<(char16_t t)
QDebug &operator<<(char32_t t)
QDebug &operator<<(const QByteArray &t)
QDebug &operator<<(const QString &t)
QDebug &operator<<(const char *t)
(since 6.0) QDebug &operator<<(const char16_t *t)
(since 6.5) QDebug &operator<<(const std::basic_string<Char, Args...> &s)
(since 6.7) QDebug &operator<<(const std::optional<T> &opt)
(since 6.9) QDebug &operator<<(const std::tuple<Ts...> &tuple)
QDebug &operator<<(const void *t)
QDebug &operator<<(double t)
QDebug &operator<<(float t)
QDebug &operator<<(int t)
QDebug &operator<<(long t)
QDebug &operator<<(qint64 t)
QDebug &operator<<(quint64 t)
QDebug &operator<<(short t)
(since 6.5) QDebug &operator<<(std::basic_string_view<Char, Args...> s)
(since 6.6) QDebug &operator<<(std::chrono::duration<Rep, Period> duration)
(since 6.7) QDebug &operator<<(std::nullopt_t)
QDebug &operator<<(unsigned int t)
QDebug &operator<<(unsigned long t)
QDebug &operator<<(unsigned short t)
QDebug &operator=(const QDebug &other)

Miembros públicos estáticos

(since 6.9) QByteArray toBytes(const T &object)
(since 6.0) QString toString(const T &object)
QDebug operator<<(QDebug debug, const QHash<Key, T> &hash)
QDebug operator<<(QDebug debug, const QList<T> &list)
QDebug operator<<(QDebug debug, const QMap<Key, T> &map)
QDebug operator<<(QDebug debug, const QMultiHash<Key, T> &hash)
QDebug operator<<(QDebug debug, const QMultiMap<Key, T> &map)
QDebug operator<<(QDebug debug, const QSet<T> &set)
(since 6.3) QDebug operator<<(QDebug debug, const QVarLengthArray<T, P> &array)
(since 6.9) QDebug operator<<(QDebug debug, const std::array<T, N> &array)
QDebug operator<<(QDebug debug, const std::list<T, Alloc> &vec)
QDebug operator<<(QDebug debug, const std::map<Key, T, Compare, Alloc> &map)
QDebug operator<<(QDebug debug, const std::multimap<Key, T, Compare, Alloc> &map)
(since 6.9) QDebug operator<<(QDebug debug, const std::multiset<Key, Compare, Alloc> &multiset)
QDebug operator<<(QDebug debug, const std::pair<T1, T2> &pair)
(since 6.9) QDebug operator<<(QDebug debug, const std::set<Key, Compare, Alloc> &set)
(since 6.9) QDebug operator<<(QDebug debug, const std::unordered_map<Key, T, Hash, KeyEqual, Alloc> &map)
(since 6.9) QDebug operator<<(QDebug debug, const std::unordered_set<Key, Hash, KeyEqual, Alloc> &unordered_set)
QDebug operator<<(QDebug debug, const std::vector<T, Alloc> &vec)
(since 6.7) QDebug operator<<(QDebug d, QAnyStringView s)
(since 6.9) QDebug operator<<(QDebug debug, T t)
QDebug operator<<(QDebug debug, const QContiguousCache<T> &cache)
QDebug operator<<(QDebug debug, const QFlags<T> &flags)

Macros

QDebug qCritical()
QDebug qDebug()
QDebug qFatal()
QDebug qInfo()
QDebug qWarning()

Descripción detallada

QDebug se utiliza siempre que el desarrollador necesite escribir información de depuración o seguimiento en un dispositivo, un archivo, una cadena o una consola.

Uso básico

En el caso más habitual, resulta útil llamar a la función ` qDebug()` para obtener un objeto `QDebug` predeterminado que se utilizará para escribir información de depuración.

   qDebug () << "Fecha:" << QDate::currentDate();
    qDebug() << "Types:" << QString("String") << QChar('x') << QRect(0, 10, 50, 40);
    qDebug() << "Custom coordinate type:" << coordinate;

Esto crea un objeto QDebug utilizando el constructor que acepta un valor « QtMsgType » de « QtDebugMsg ». Del mismo modo, las funciones « qInfo()», « qWarning()», « qCritical()» y « qFatal()» también devuelven objetos QDebug para los tipos de mensaje correspondientes.

QString La clase también proporciona varios constructores para otras situaciones, incluido un constructor que acepta un objeto ` QFile ` o cualquier otra subclase de ` QIODevice ` que se utilice para escribir información de depuración en archivos y otros dispositivos. El constructor que acepta un objeto ` ` se utiliza para escribir en una cadena con fines de visualización o serialización.

Opciones de formato

QDebug formatea la salida para que resulte fácilmente legible. Añade automáticamente espacios entre los argumentos y coloca comillas alrededor de los argumentos de tipo ` QString`, ` QByteArray` y ` QChar `.

Puedes ajustar estas opciones mediante los métodos space(), nospace() y quote(), noquote(). Además, QTextStream manipulators puede canalizarse a un flujo de QDebug.

QDebugStateSaver limita los cambios de formato al ámbito actual. ` resetFormat()` restablece las opciones a sus valores predeterminados.

Escribir tipos personalizados en un flujo

Muchos tipos estándar pueden escribirse en objetos QDebug, y Qt ofrece compatibilidad con la mayoría de los tipos de valor de Qt. Para añadir compatibilidad con tipos personalizados, es necesario implementar un operador de transmisión, tal y como se muestra en el siguiente ejemplo:

QDebug operator<<(QDebug debug, const Coordinate &c)
{
    QDebugStateSaver saver(debug);
    debug.nospace() << '(' << c.x() << ", " << c.y() << ')';

    return debug;
}

Esto se describe en los documentos «Técnicas de depuración » y «Creación de tipos Qt personalizados ».

Documentación sobre tipos de miembros

enum QDebug::VerbosityLevel

Esta enumeración describe la gama de niveles de detalle.

ConstanteValor
QDebug::MinimumVerbosity0
QDebug::DefaultVerbosity2
QDebug::MaximumVerbosity7

Véase también verbosity() y setVerbosity().

Documentación de funciones miembro

[explicit, since 6.9] QDebug::QDebug(QByteArray *byteArray)

Crea un flujo de depuración que escribe en el archivo byteArray especificado.

Los datos se codifican en UTF-8, lo que puede no coincidir con la configuración regional del sistema; por ejemplo, en Windows.

Con los objetos instanciados mediante este constructor, los datos pueden almacenarse en el búfer y no se escribirán en la matriz de bytes hasta que se vacíe el flujo, por ejemplo, utilizando ` Qt::flush`.

Esta función se introdujo en Qt 6.9.

Véase también QTextStream manipulators.

[explicit] QDebug::QDebug(QIODevice *device)

Crea un flujo de depuración que escribe en el archivo « device » especificado.

[explicit] QDebug::QDebug(QString *string)

Crea un flujo de depuración que escribe en el archivo string especificado.

[explicit] QDebug::QDebug(QtMsgType t)

Crea un flujo de depuración que escribe en el controlador correspondiente al tipo de mensaje « t ».

QDebug::QDebug(const QDebug &o)

Crea una copia del otro flujo de depuración o.

[noexcept] QDebug::~QDebug()

Envía todos los datos pendientes de escritura y elimina el flujo de depuración.

bool QDebug::autoInsertSpaces() const

Devuelve ` true ` si esta instancia de ` QDebug ` inserta automáticamente espacios entre las escrituras.

Véase también setAutoInsertSpaces() y QDebugStateSaver.

QDebug &QDebug::maybeQuote(char c = '"')

Escribe un carácter c en el flujo de depuración, en función de la configuración actual para la inserción automática de comillas, y devuelve una referencia al flujo.

El carácter predeterminado es una comilla doble ".

Véase también quote() y noquote().

QDebug &QDebug::maybeSpace()

Escribe un carácter de espacio en el flujo de depuración, según la configuración actual para la inserción automática de espacios, y devuelve una referencia al flujo.

Véase también space() y nospace().

QDebug &QDebug::noquote()

Desactiva la inserción automática de comillas alrededor del contenido de QChar, QString y QByteArray, y devuelve una referencia al flujo.

Cuando se desactiva el uso de comillas, estos tipos se imprimen sin comillas y sin escapar los caracteres no imprimibles.

Véase también quote() y maybeQuote().

QDebug &QDebug::nospace()

Desactiva la inserción automática de espacios y devuelve una referencia al flujo.

Véase también space() y maybeSpace().

QDebug &QDebug::quote()

Permite la inserción automática de comillas alrededor del contenido de QChar, QString y QByteArray, y devuelve una referencia al flujo.

El uso de comillas está activado por defecto.

Véanse también noquote() y maybeQuote().

[noexcept, since 6.7] bool QDebug::quoteStrings() const

Devuelve « true » si esta instancia de « QDebug » va a encerrar entre comillas las cadenas que se le envíen (que es el valor por defecto).

Esta función se introdujo en Qt 6.7.

Véase también QDebugStateSaver, quote(), noquote() y setQuoteStrings().

QDebug &QDebug::resetFormat()

Restablece las opciones de formato del flujo, devolviéndolo a su estado original tras su creación.

Véase también space() y quote().

void QDebug::setAutoInsertSpaces(bool b)

Habilita la inserción automática de espacios entre las entradas si b es verdadero; en caso contrario, la inserción automática de espacios queda deshabilitada.

Véase también autoInsertSpaces() y QDebugStateSaver.

[since 6.7] void QDebug::setQuoteStrings(bool b)

Habilita el uso de comillas en las cadenas transmitidas a esta instancia de « QDebug » si « b » es « true »; de lo contrario, el uso de comillas queda deshabilitado.

Por defecto, las cadenas se colocan entre comillas.

Esta función se introdujo en Qt 6.7.

Véase también QDebugStateSaver, quote(), noquote() y quoteStrings().

void QDebug::setVerbosity(int verbosityLevel)

Establece el nivel de detalle del flujo en « verbosityLevel ».

El rango permitido va de 0 a 7. El valor predeterminado es 2.

Véase también verbosity() y VerbosityLevel.

QDebug &QDebug::space()

Escribe un carácter de espacio en el flujo de depuración y devuelve una referencia al flujo.

El flujo recuerda que la inserción automática de espacios está habilitada para futuras escrituras.

Véase también nospace() y maybeSpace().

[noexcept] void QDebug::swap(QDebug &other)

Cambia esta instancia de flujo de depuración por una de other. Esta operación es muy rápida y nunca falla.

[static, since 6.9] template <typename T> QByteArray QDebug::toBytes(const T &object)

Esto equivale a pasar ` object ` a ` QDebug::toString(object).toUtf8()`, pero es más eficiente.

Esta función se introdujo en Qt 6.9.

Véase también toString().

[static, since 6.0] template <typename T> QString QDebug::toString(const T &object)

Convierte object en una instancia de QDebug que opera sobre una cadena y, a continuación, devuelve dicha cadena.

Esta función resulta útil en aquellos casos en los que se necesita la representación textual de un objeto para la depuración, pero no se puede utilizar ` operator<<`. Por ejemplo:

QString str = QDebug::toString(list);

La cadena se transmite mediante ` nospace()`.

Esta función se introdujo en Qt 6.0.

Véase también ` toBytes()`.

int QDebug::verbosity() const

Devuelve el nivel de detalle del flujo de depuración.

Los operadores de flujo pueden comprobar el valor para decidir si se desea una salida detallada e imprimir más información en función del nivel. Los valores más altos indican que se desea más información.

El rango permitido va de 0 a 7. El valor por defecto es 2.

Véase también setVerbosity() y VerbosityLevel.

QDebug &QDebug::verbosity(int verbosityLevel)

Establece el nivel de detalle del flujo en « verbosityLevel » y devuelve una referencia al flujo.

El rango permitido va de 0 a 7. El valor por defecto es 2.

Véase también verbosity(), setVerbosity() y VerbosityLevel.

[since 6.0] QDebug &QDebug::operator<<(QByteArrayView t)

Escribe los datos de la matriz de bytes observada, t, en el flujo y devuelve una referencia al mismo.

Normalmente, QDebug imprime los datos entre comillas y transforma los caracteres de control o los que no pertenecen al estándar US-ASCII en sus secuencias de escape de C (\xAB). De este modo, la salida siempre es compatible con 7 bits y la cadena se puede copiar de la salida y volver a pegar en los archivos fuente de C++, si es necesario.

Para mostrar caracteres no imprimibles sin transformación, habilita la funcionalidad de ` noquote()`. Ten en cuenta que algunos backends de ` QDebug ` podrían no ser compatibles con 8 bits.

Consulte la sobrecarga de ` QByteArray ` para ver ejemplos.

Esta función se introdujo en Qt 6.0.

QDebug &QDebug::operator<<(QChar t)

Escribe el carácter « t » en el flujo y devuelve una referencia al mismo. Normalmente, ` QDebug ` imprime los caracteres de control y los caracteres no ASCII de EE. UU. como sus secuencias de escape en C o como su valor Unicode (`\u1234`). Para imprimir caracteres no imprimibles sin transformación, habilita la funcionalidad ` noquote()`, pero ten en cuenta que algunos backends de ` QDebug ` pueden no ser compatibles con 8 bits y es posible que no puedan representar ` t`.

QDebug &QDebug::operator<<(QLatin1StringView t)

Escribe la cadena « t » en el flujo y devuelve una referencia al mismo. Normalmente, « QDebug » muestra la cadena entre comillas y transforma los caracteres no imprimibles en sus valores Unicode (\u1234).

Para imprimir caracteres no imprimibles sin transformación, habilita la funcionalidad noquote(). Ten en cuenta que es posible que algunos backends de QDebug no sean compatibles con 8 bits.

Consulta la sobrecarga de QString para ver ejemplos.

QDebug &QDebug::operator<<(QStringView s)

Escribe la vista de cadena, s, en el flujo y devuelve una referencia al mismo. Normalmente, QDebug imprime la cadena entre comillas y transforma los caracteres no imprimibles en sus valores Unicode (\u1234).

Para imprimir caracteres no imprimibles sin transformación, habilita la funcionalidad noquote(). Ten en cuenta que algunos backends de QDebug pueden no ser compatibles con 8 bits.

Consulta la sobrecarga de QString para ver ejemplos.

[since 6.0] QDebug &QDebug::operator<<(QUtf8StringView s)

Escribe la vista de cadena « s » en el flujo y devuelve una referencia al flujo.

Normalmente, ` QDebug ` imprime los datos entre comillas y transforma los caracteres de control o los caracteres no ASCII de EE. UU. en sus secuencias de escape de C (\xAB). De esta forma, la salida siempre es compatible con 7 bits y la cadena se puede copiar desde la salida y volver a pegar en los archivos fuente de C++, si es necesario.

Para mostrar caracteres no imprimibles sin transformación, habilita la funcionalidad de ` noquote()`. Ten en cuenta que es posible que algunos backends de ` QDebug ` no sean compatibles con 8 bits.

Esta función se introdujo en Qt 6.0.

[since 6.7] template <typename T> requires if_qint128<T> QDebug &QDebug::operator<<(T i)

[since 6.7] template <typename T> requires if_quint128<T> QDebug &QDebug::operator<<(T i)

Muestra la representación textual del entero de 128 bits i.

Nota: Este operador solo está disponible si Qt admite tipos de enteros de 128 bits. Si los tipos de enteros de 128 bits están disponibles en tu compilación, pero las bibliotecas de Qt se han compilado sin ellos, el operador mostrará una advertencia en su lugar.

Nota: Dado que el operador es una plantilla de función, no se realizan conversiones implícitas en su argumento. Debe ser exactamente de tipo `qint128` o `quint128`.

Estas funciones se introdujeron en Qt 6.7.

Véase también QT_SUPPORTS_INT128.

QDebug &QDebug::operator<<(bool t)

Escribe el valor booleano « t » en el flujo y devuelve una referencia al mismo.

QDebug &QDebug::operator<<(char t)

Escribe el carácter « t » en el flujo y devuelve una referencia al mismo.

QDebug &QDebug::operator<<(char16_t t)

Escribe el carácter UTF-16 « t » en el flujo y devuelve una referencia al mismo.

QDebug &QDebug::operator<<(char32_t t)

Escribe el carácter UTF-32 « t » en el flujo y devuelve una referencia al mismo.

QDebug &QDebug::operator<<(const QByteArray &t)

Escribe la matriz de bytes, t, en el flujo y devuelve una referencia al mismo. Normalmente, ` QDebug ` imprime la matriz entre comillas y transforma los caracteres de control o los que no pertenecen al estándar US-ASCII en sus secuencias de escape de C (\xAB). De esta forma, la salida siempre es compatible con 7 bits y la cadena se puede copiar de la salida y pegar de nuevo en los archivos fuente de C++, si es necesario.

Para mostrar caracteres no imprimibles sin transformación, habilita la funcionalidad « noquote » (). Ten en cuenta que es posible que algunos backends de QDebug no sean compatibles con 8 bits.

Ejemplos de salida:

QByteArray ba;

ba = "a";
qDebug().noquote() << ba;    // prints: a
qDebug() << ba;              // prints: "a"

ba = "\"a\r\n\"";
qDebug() << ba;              // prints: "\"a\r\n\""

ba = "\033";                 // carácter de escape
qDebug() << ba;              // prints: "\x1B"

ba = "\xC3\xA1";
qDebug() << ba;              // prints: "\xC3\xA1"

ba = QByteArray("a\0b", 3);
qDebug() << ba;               // prints: "\a\x00""b"

Fíjate en cómo QDebug tuvo que cerrar y volver a abrir la cadena siguiendo el método que utilizan los lenguajes C y C++ para concatenar literales de cadena, de modo que la letra «b» no se interpretara como parte de la secuencia de escape hexadecimal anterior.

QDebug &QDebug::operator<<(const QString &t)

Escribe la cadena « t » en el flujo y devuelve una referencia al mismo. Normalmente, « QDebug » muestra la cadena entre comillas y transforma los caracteres no imprimibles en sus valores Unicode (\u1234).

Para imprimir caracteres no imprimibles sin transformación, habilita la funcionalidad noquote(). Ten en cuenta que es posible que algunos backends de QDebug no sean compatibles con 8 bits.

Ejemplos de salida:

QString s;

s = "a";
qDebug().noquote() << s;    // prints: a
qDebug() << s;              // prints: "a"

s = "\"a\r\n\"";
qDebug() << s;              // prints: "\"a\r\n\""

s = "\033";                 // carácter de escape
qDebug() << s;              // prints: "\u001B"

s = "\u00AD";               // GUION SUAVE
qDebug() << s;              // prints: "\u00AD"

s = "\u00E1";               // LETRA A MINÚSCULA LATINA CON ACENTO AGUDO
qDebug() << s;              // prints: "á"

s = "a\u0301";              // «a» seguida del acento agudo combinatorio
qDebug() << s;              // prints: "á";

s = "\u0430\u0301";         // LETRA MINÚSCULA A CIRILICA seguida del ACENTO AGUDO COMBINADO
qDebug() << s;              // prints: "а́"

QDebug &QDebug::operator<<(const char *t)

Escribe la cadena UTF-8 terminada con «\0 », t, en el flujo y devuelve una referencia al mismo. La cadena nunca se pone entre comillas ni se escapa para la salida. Ten en cuenta que QDebug almacena internamente la cadena en UTF-16 y puede que tenga que transformarla a 8 bits utilizando el códec de la configuración regional para poder utilizar algunos backends, lo que puede provocar una salida distorsionada (mojibake). Se recomienda limitarse a cadenas US-ASCII.

[since 6.0] QDebug &QDebug::operator<<(const char16_t *t)

Escribe la cadena UTF-16 «\0 », t, en el flujo y devuelve una referencia al mismo. La cadena nunca se pone entre comillas ni se escapa para la salida. Ten en cuenta que QDebug almacena internamente la cadena como UTF-16 y puede que sea necesario transformarla a 8 bits utilizando el códec de la configuración regional para poder utilizar algunos backends, lo que puede provocar una salida distorsionada (mojibake). Se recomienda limitarse a cadenas US-ASCII.

Esta función se introdujo en Qt 6.0.

[since 6.5] template <typename Char, typename... Args> QDebug &QDebug::operator<<(const std::basic_string<Char, Args...> &s)

[since 6.5] template <typename Char, typename... Args> QDebug &QDebug::operator<<(std::basic_string_view<Char, Args...> s)

Escribe la cadena o la vista de cadena s en el flujo y devuelve una referencia al flujo.

Estos operadores solo participan en la resolución de sobrecargas si Char es uno de

  • char
  • char8_t (solo C++20)
  • char16_t
  • char32_t
  • wchar_t

Estas funciones se introdujeron en Qt 6.5.

[since 6.7] template <typename T> requires if_streamable<T> QDebug &QDebug::operator<<(const std::optional<T> &opt)

Escribe el contenido de opt (o nullopt si no se ha configurado) en este flujo. T debe admitir la transmisión a QDebug.

Esta función se introdujo en Qt 6.7.

[since 6.9] template <typename... Ts> requires if_streamable<Ts...> QDebug &QDebug::operator<<(const std::tuple<Ts...> &tuple)

Escribe el contenido de tuple en el flujo. Todos los Ts... deben admitir la transmisión a QDebug.

Esta función se introdujo en Qt 6.9.

QDebug &QDebug::operator<<(const void *t)

Escribe un puntero, ` t`, en el flujo y devuelve una referencia al flujo.

QDebug &QDebug::operator<<(double t)

Escribe el número de coma flotante de 64 bits, t, en el flujo y devuelve una referencia al mismo.

QDebug &QDebug::operator<<(float t)

Escribe el número de coma flotante de 32 bits, t, en el flujo y devuelve una referencia al flujo.

QDebug &QDebug::operator<<(int t)

Escribe el entero con signo t en el flujo y devuelve una referencia al flujo.

QDebug &QDebug::operator<<(long t)

Escribe el entero largo con signo, t, en el flujo y devuelve una referencia al mismo.

QDebug &QDebug::operator<<(qint64 t)

Escribe el entero con signo de 64 bits, t, en el flujo y devuelve una referencia al mismo.

QDebug &QDebug::operator<<(quint64 t)

Escribe el entero sin signo de 64 bits, ` t`, en el flujo y devuelve una referencia al flujo.

QDebug &QDebug::operator<<(short t)

Escribe el entero corto con signo, t, en el flujo y devuelve una referencia al mismo.

[since 6.6] template <typename Rep, typename Period> QDebug &QDebug::operator<<(std::chrono::duration<Rep, Period> duration)

Imprime la duración « duration » en el flujo y devuelve una referencia al mismo. La cadena impresa es la representación numérica del periodo seguida de la unidad de tiempo, de forma similar a lo que produciría la biblioteca estándar de C++ con ` std::ostream`.

La unidad no está localizada.

Esta función se introdujo en Qt 6.6.

[since 6.7] QDebug &QDebug::operator<<(std::nullopt_t)

Escribe «nullopt» en el flujo.

Esta función se introdujo en Qt 6.7.

QDebug &QDebug::operator<<(unsigned int t)

Escribe el entero sin signo « t » en el flujo y devuelve una referencia al mismo.

QDebug &QDebug::operator<<(unsigned long t)

Escribe el entero largo sin signo t en el flujo y devuelve una referencia al flujo.

QDebug &QDebug::operator<<(unsigned short t)

Escribe el entero corto sin signo t en el flujo y devuelve una referencia al flujo.

QDebug &QDebug::operator=(const QDebug &other)

Asigna el flujo de depuración « other » a este flujo y devuelve una referencia a este flujo.

Elementos no miembros relacionados

template <typename Key, typename T> QDebug operator<<(QDebug debug, const QHash<Key, T> &hash)

Escribe el contenido de hash en debug. Tanto Key como T deben admitir la transmisión a QDebug.

template <typename T> QDebug operator<<(QDebug debug, const QList<T> &list)

Escribe el contenido de list en debug. T debe admitir la transmisión en streaming a QDebug.

template <typename Key, typename T> QDebug operator<<(QDebug debug, const QMap<Key, T> &map)

Escribe el contenido de map en debug. Tanto Key como T deben admitir la transmisión a QDebug.

template <typename Key, typename T> QDebug operator<<(QDebug debug, const QMultiHash<Key, T> &hash)

Escribe el contenido de hash en debug. Tanto Key como T deben admitir la transmisión a QDebug.

template <typename Key, typename T> QDebug operator<<(QDebug debug, const QMultiMap<Key, T> &map)

Escribe el contenido de map en debug. Tanto Key como T deben admitir la transmisión a QDebug.

template <typename T> QDebug operator<<(QDebug debug, const QSet<T> &set)

Escribe el contenido de set en debug. T debe admitir la transmisión en tiempo real a QDebug.

[since 6.3] template <typename T, qsizetype P> QDebug operator<<(QDebug debug, const QVarLengthArray<T, P> &array)

Escribe el contenido de array en debug. T debe admitir la transmisión a QDebug.

Esta función se introdujo en Qt 6.3.

[since 6.9] template <typename T, std::size_t N> QDebug operator<<(QDebug debug, const std::array<T, N> &array)

Escribe el contenido de array en debug. T debe admitir la transmisión a QDebug.

Esta función se introdujo en Qt 6.9.

template <typename T, typename Alloc> QDebug operator<<(QDebug debug, const std::list<T, Alloc> &vec)

Escribe el contenido de la lista vec en debug. T debe admitir la transmisión a QDebug.

template < typename Key, typename T, typename Compare, typename Alloc > QDebug operator<<(QDebug debug, const std::map<Key, T, Compare, Alloc> &map)

Escribe el contenido de map en debug. Tanto Key como T deben admitir la transmisión a QDebug.

template < typename Key, typename T, typename Compare, typename Alloc > QDebug operator<<(QDebug debug, const std::multimap<Key, T, Compare, Alloc> &map)

Escribe el contenido de map en debug. Tanto Key como T deben admitir la transmisión a QDebug.

[since 6.9] template < typename Key, typename Compare, typename Alloc > QDebug operator<<(QDebug debug, const std::multiset<Key, Compare, Alloc> &multiset)

Escribe el contenido de ` multiset ` en ` debug`. El tipo ` Key ` debe admitir la transmisión a ` QDebug`.

Esta función se introdujo en Qt 6.9.

template <typename T1, typename T2> QDebug operator<<(QDebug debug, const std::pair<T1, T2> &pair)

Escribe el contenido de pair en debug. Tanto T1 como T2 deben admitir la transmisión a QDebug.

[since 6.9] template < typename Key, typename Compare, typename Alloc > QDebug operator<<(QDebug debug, const std::set<Key, Compare, Alloc> &set)

Escribe el contenido de ` set ` en ` debug`. El tipo ` Key ` debe admitir la transmisión a ` QDebug`.

Esta función se introdujo en Qt 6.9.

[since 6.9] template < typename Key, typename T, typename Hash, typename KeyEqual, typename Alloc > QDebug operator<<(QDebug debug, const std::unordered_map<Key, T, Hash, KeyEqual, Alloc> &map)

Escribe el contenido de map en debug. Tanto Key como T deben admitir la transmisión a QDebug.

Esta función se introdujo en Qt 6.9.

[since 6.9] template < typename Key, typename Hash, typename KeyEqual, typename Alloc > QDebug operator<<(QDebug debug, const std::unordered_set<Key, Hash, KeyEqual, Alloc> &unordered_set)

Escribe el contenido de ` unordered_set ` en ` debug`. El tipo ` Key ` debe admitir la transmisión a ` QDebug`.

Esta función se introdujo en Qt 6.9.

template <typename T, typename Alloc> QDebug operator<<(QDebug debug, const std::vector<T, Alloc> &vec)

Escribe el contenido del vector « vec » en « debug ». « T » debe admitir la transmisión a « QDebug ».

[since 6.7] QDebug operator<<(QDebug d, QAnyStringView s)

Muestra « s » en el flujo de depuración « d ».

Si d.quotedString() es true, indica en qué codificación está la cadena. Si solo quieres los datos de la cadena, utiliza visit() de esta forma:

s.visit([&d) (auto s) { d << s; });

Esta función se introdujo en Qt 6.7.

Véase también QAnyStringView::visit().

[since 6.9] template <typename T> requires if_ordering_type<T> QDebug operator<<(QDebug debug, T t)

Imprime el valor de ordenación de Qt XML o std t en el objeto debug.

Restricciones

Participa en la resolución de sobrecargas solo si T es uno de <QT/Std>::<WEAK/partial/strong>_ordering.

Esta función se introdujo en Qt 6.9.

template <typename T> QDebug operator<<(QDebug debug, const QContiguousCache<T> &cache)

Escribe el contenido de cache en debug. T debe admitir la transmisión a QDebug.

template <typename T> QDebug operator<<(QDebug debug, const QFlags<T> &flags)

flags escribe a debug.

Documentación de macros

QDebug qCritical()

Devuelve un objeto ` QDebug ` que registra un mensaje crítico en el gestor central de mensajes.

Ejemplo:

qCritical() << "Brush:" << myQBrush << "Other value:" << i;

El uso de qCritical() es una alternativa a qCritical(const char *, ...), que sigue el paradigma de printf.

Ten en cuenta que ` QDebug ` y los operadores de flujo específicos de cada tipo añaden diversos formatos para facilitar la lectura del mensaje de depuración. Consulta la documentación de ` formatting options ` para obtener más detalles.

A efectos de depuración, a veces resulta conveniente que el programa se interrumpa ante mensajes críticos. Esto te permite inspeccionar el volcado de memoria o conectar un depurador; véase también qFatal(). Para habilitar esta opción, establece la variable de entorno QT_FATAL_CRITICALS en un número n. El programa se interrumpirá entonces ante el enésimo mensaje crítico. Es decir, si la variable de entorno se establece en 1, el programa se terminará en la primera llamada; si contiene el valor 10, se terminará en la décima llamada. Cualquier valor no numérico en la variable de entorno equivale a 1.

Nota: Esta macro es segura para subprocesos.

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

QDebug qDebug()

Devuelve un objeto ` QDebug ` que registra un mensaje de depuración en el gestor central de mensajes.

Ejemplo:

qDebug() << "Brush:" << myQBrush << "Other value:" << i;

El uso de qDebug() es una alternativa a qDebug(const char *, ...), que sigue el paradigma de printf.

Ten en cuenta que QDebug y los operadores de flujo específicos de cada tipo añaden diversos formatos para facilitar la lectura del mensaje de depuración. Consulta la documentación de formatting options para obtener más detalles.

Esta función no hace nada si se ha definido ` QT_NO_DEBUG_OUTPUT ` durante la compilación.

Nota: Esta macro es segura para subprocesos.

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

QDebug qFatal()

Devuelve un objeto ` QDebug ` que registra un mensaje grave en el gestor central de mensajes.

El uso de qFatal() es una alternativa a qFatal(const char *, ...), que sigue el paradigma de printf.

Ten en cuenta que QDebug y los operadores de flujo específicos de cada tipo añaden diversos formatos para facilitar la lectura del mensaje de depuración. Consulta la documentación de formatting options para obtener más detalles.

Si se utiliza el controlador de mensajes predeterminado, el flujo devuelto se interrumpirá para crear un volcado de memoria. En Windows, para compilaciones de depuración, esta función informará de un _CRT_ERROR, lo que le permitirá conectar un depurador a la aplicación.

Nota: Esta macro es segura para subprocesos.

Véase también ` qFatal` (`const char *, ...`) y ` qCFatal()`.

QDebug qInfo()

Devuelve un objeto ` QDebug ` que registra un mensaje informativo en el gestor central de mensajes.

Ejemplo:

qInfo() << "Brush:" << myQBrush << "Other value:" << i;

El uso de qInfo() es una alternativa a qInfo(const char *, ...), que sigue el paradigma de printf.

Ten en cuenta que QDebug y los operadores de flujo específicos de cada tipo añaden diversos formatos para facilitar la lectura del mensaje de depuración. Consulta la documentación de formatting options para obtener más detalles.

Esta función no realiza ninguna acción si se ha definido ` QT_NO_INFO_OUTPUT ` durante la compilación.

Nota: Esta macro es segura para subprocesos.

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

QDebug qWarning()

Devuelve un objeto ` QDebug ` que registra un mensaje de advertencia en el gestor central de mensajes.

Ejemplo:

qWarning() << "Brush:" << myQBrush << "Other value:" << i;

El uso de qWarning() es una alternativa a qWarning(const char *, ...), que sigue el paradigma de printf.

Ten en cuenta que QDebug y los operadores de flujo específicos de cada tipo añaden diversos formatos para facilitar la lectura del mensaje de depuración. Consulta la documentación de formatting options para obtener más detalles.

Esta función no realiza ninguna acción si se ha definido ` QT_NO_WARNING_OUTPUT ` durante la compilación.

A efectos de depuración, a veces resulta conveniente que el programa se interrumpa ante mensajes de advertencia. Esto permite inspeccionar el volcado de memoria o conectar un depurador; véase también qFatal(). Para habilitar esta función, establezca la variable de entorno QT_FATAL_WARNINGS en un número n. El programa se detendrá entonces ante la enésima advertencia. Es decir, si la variable de entorno se establece en 1, el programa se detendrá en la primera llamada; si contiene el valor 10, se detendrá en la décima llamada. Cualquier valor no numérico en la variable de entorno equivale a 1.

Nota: Esta macro es segura para subprocesos.

Véase también qWarning(const char *, ...) y 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.