QDebug Class

Documentación de las funciones miembro

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

Construye un flujo de depuración que escribe en la dirección byteArray.

Los datos se codifican en UTF-8, que puede no ser la misma que la configuración regional del sistema, por ejemplo, en Windows.

Con objetos instanciados con este constructor, los datos pueden ser almacenados en buffer y no serán escritos en la matriz de bytes hasta que el flujo sea vaciado, por ejemplo, usando Qt::flush.

Esta función se introdujo en Qt 6.9.

Ver también QTextStream manipulators.

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

Crea un flujo de depuración que escribe en la dirección device.

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

Crea un flujo de depuración que escribe en la dirección string.

[explicit] QDebug::QDebug(QtMsgType t)

Construye un flujo de depuración que escribe en el manejador para el tipo de mensaje t.

QDebug::QDebug(const QDebug &o)

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

[noexcept] QDebug::~QDebug()

Borra cualquier dato pendiente de escribir y destruye el flujo de depuración.

bool QDebug::autoInsertSpaces() const

Devuelve true si esta instancia QDebug insertará automáticamente espacios entre escrituras.

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

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

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

El carácter por defecto 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, dependiendo de 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 caracteres de entrecomillado alrededor de los contenidos de QChar, QString y QByteArray y devuelve una referencia al flujo.

Cuando el entrecomillado está desactivado, estos tipos se imprimen sin caracteres de entrecomillado y sin escape de 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()

Habilita la inserción automática de caracteres de entrecomillado alrededor de los contenidos de QChar, QString y QByteArray y devuelve una referencia al flujo.

El entrecomillado está activado por defecto.

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

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

Devuelve true si esta instancia de QDebug citará las cadenas que se le transmitan (que es el valor predeterminado).

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 de construcción original.

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

void QDebug::setAutoInsertSpaces(bool b)

Activa la inserción automática de espacios entre escrituras si b es verdadero; en caso contrario, la inserción automática de espacios está desactivada.

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

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

Habilita el entrecomillado de las cadenas transmitidas a esta instancia de QDebug si b es true; de lo contrario, el entrecomillado está deshabilitado.

Por defecto, las cadenas se entrecomillan.

Esta función se introdujo en Qt 6.7.

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

void QDebug::setVerbosity(int verbosityLevel)

Establece la verbosidad del flujo en verbosityLevel.

El rango permitido es de 0 a 7. El valor por defecto 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á activada para futuras escrituras.

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

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

Intercambia esta instancia de flujo de depuración con 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 es equivalente a pasar object a QDebug::toString(object).toUtf8(), pero 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)

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

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

QString str = QDebug::toString(list);

La cadena se transmite utilizando nospace().

Esta función se introdujo en Qt 6.0.

Véase también toBytes().

int QDebug::verbosity() const

Devuelve la verbosidad del flujo de depuración.

Los operadores de flujo pueden comprobar el valor para decidir si se desea una salida verbosa 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 es de 0 a 7. El valor por defecto es 2.

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

QDebug &QDebug::verbosity(int verbosityLevel)

Establece la verbosidad del flujo en verbosityLevel y devuelve una referencia al flujo.

El rango permitido es 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 flujo.

Normalmente, QDebug imprime los datos entre comillas y transforma los caracteres de control o no-US-ASCII a sus secuencias de escape en C (\xAB). De esta forma, la salida es siempre de 7 bits limpios y la cadena puede ser copiada de la salida y pegada de nuevo en fuentes C++, si es necesario.

Para imprimir caracteres no imprimibles sin transformación, active la funcionalidad noquote(). Tenga en cuenta que algunos backends de QDebug pueden no ser de 8 bits limpios.

Consulte la sobrecarga 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 flujo. Normalmente, QDebug imprime caracteres de control y caracteres no-US-ASCII como sus secuencias de escape C o su valor Unicode (\u1234). Para imprimir caracteres no imprimibles sin transformación, habilite la funcionalidad noquote(), pero tenga en cuenta que algunos backends de QDebug pueden no ser limpios de 8 bits y no ser capaces de representar t.

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

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

Para imprimir caracteres no imprimibles sin transformación, active la funcionalidad noquote(). Tenga en cuenta que algunos backends de QDebug pueden no ser limpios de 8 bits.

Consulte la sobrecarga QString para ver ejemplos.

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

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

Para imprimir caracteres no imprimibles sin transformación, active la funcionalidad noquote(). Tenga en cuenta que algunos backends de QDebug pueden no ser limpios de 8 bits.

Consulte la sobrecarga 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 no-US-ASCII a sus secuencias de escape C (\xAB). De esta forma, la salida es siempre de 7 bits limpios y la cadena puede ser copiada de la salida y pegada de nuevo en fuentes C++, si es necesario.

Para imprimir caracteres no imprimibles sin transformación, active la funcionalidad noquote(). Tenga en cuenta que algunos backends de QDebug pueden no ser de 8 bits limpios.

Esta función se introdujo en Qt 6.0.

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

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 flujo.

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

Escribe el carácter, t, en el flujo y devuelve una referencia al flujo.

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

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

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

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

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

Escribe la matriz de bytes, t, en el flujo y devuelve una referencia al flujo. Normalmente, QDebug imprime el array entre comillas y transforma los caracteres de control o no-US-ASCII a sus secuencias de escape C (\xAB). De esta forma, la salida es siempre de 7 bits limpios y la cadena puede ser copiada de la salida y pegada de nuevo en fuentes C++, si es necesario.

Para imprimir caracteres no imprimibles sin transformación, active la funcionalidad noquote(). Tenga en cuenta que algunos backends de QDebug pueden no ser de 8 bits limpios.

Ejemplos de salida:

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

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

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

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

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

Observe cómo QDebug necesitaba cerrar y volver a abrir la cadena de la forma en que los lenguajes C y C++ concatenan los literales de cadena para que la letra 'b' no se interprete 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 flujo. Normalmente, QDebug imprime la cadena entre comillas y transforma los caracteres no imprimibles a sus valores Unicode (\u1234).

Para imprimir caracteres no imprimibles sin transformación, active la funcionalidad noquote(). Tenga en cuenta que algunos backends de QDebug pueden no estar limpios de 8 bits.

Ejemplos de salida:

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

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

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

s = "\u00AD"; // SOFT HYPHENqDebug() << s;              // prints: "\u00AD"

s = "\u00E1"; // LETRA MAYÚSCULA LATINA A CON AGUDOqDebug() << s;              // prints: "á"

s = "a\u0301"; // "a" seguida de ACENTO AGUDO COMBINADOqDebug() << s;              // prints: "á";

s = "\u0430\u0301"; // MAYÚSCULA CIRÍLICA A seguida de ACENTO AGUDO COMBINADOqDebug() << s;              // prints: "а́"

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

Escribe la cadena UTF-8 terminada en '\0' t, en el flujo y devuelve una referencia al flujo. La cadena nunca se entrecomilla ni se escapa para la salida. Tenga en cuenta que QDebug se almacena internamente como UTF-16 y puede ser necesario transformarlo 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 restringirse a cadenas US-ASCII.

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

Escribe la cadena UTF-16 u'\0'terminada, t, en el flujo y devuelve una referencia al flujo. La cadena nunca se entrecomilla ni se escapa para la salida. Tenga en cuenta que QDebug se almacena internamente como UTF-16 y puede ser necesario transformarlo a 8 bits utilizando el códec de la configuración regional para poder utilizar algunos backends, lo que puede provocar una salida confusa (mojibake). Se recomienda restringir a cadenas US-ASCII.

Esta función se introdujo en Qt 6.0.

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

Estos operadores sólo participan en la resolución de sobrecargas si Char es uno de los operadores

• char
• char8_t (sólo C++20)
• char16_t
• char32_t
• wchar_t

Estas funciones se introdujeron en Qt 6.5.

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

Escribe el contenido de opt (o nullopt si no está establecido) en este stream. T necesita soportar streaming en QDebug.

Esta función se introdujo en Qt 6.7.

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

Escribe el contenido de tuple en el flujo. Todos los Ts... necesitan soportar streaming en 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 flujo.

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 flujo.

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

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

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

Escribe un entero de 64 bits sin signo, 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 flujo.

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

Imprime la duración del tiempo duration en el flujo y devuelve una referencia al flujo. La cadena impresa es la representación numérica del periodo seguida de la unidad de tiempo, 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 un entero sin signo, t, en el flujo y devuelve una referencia al flujo.

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

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

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

Escribe un 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.