QDebug Class

Documentation des fonctions membres

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

Construit un flux de débogage qui écrit sur le site byteArray.

Les données sont encodées en UTF-8, ce qui peut être différent de la locale du système, par exemple sous Windows.

Avec les objets instanciés avec ce constructeur, les données peuvent être mises en mémoire tampon et ne seront pas écrites dans le tableau d'octets jusqu'à ce que le flux soit vidé, par exemple, en utilisant Qt::flush.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi QTextStream manipulators.

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

Construit un flux de débogage qui écrit sur le site device.

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

Construit un flux de débogage qui écrit sur le site string.

[explicit] QDebug::QDebug(QtMsgType t)

Construit un flux de débogage qui écrit au gestionnaire pour le type de message t.

QDebug::QDebug(const QDebug &o)

Construit une copie de l'autre flux de débogage o.

[noexcept] QDebug::~QDebug()

Vide toutes les données en attente d'écriture et détruit le flux de débogage.

bool QDebug::autoInsertSpaces() const

Renvoie true si cette instance de QDebug insère automatiquement des espaces entre les écritures.

Voir aussi setAutoInsertSpaces() et QDebugStateSaver.

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

Écrit un caractère c dans le flux de débogage, en fonction de la configuration actuelle de l'insertion automatique des guillemets, et renvoie une référence au flux.

Le caractère par défaut est un guillemet double ".

Voir également quote() et noquote().

QDebug &QDebug::maybeSpace()

Écrit un caractère d'espacement dans le flux de débogage, en fonction du paramètre actuel d'insertion automatique des espaces, et renvoie une référence au flux.

Voir aussi space() et nospace().

QDebug &QDebug::noquote()

Désactive l'insertion automatique de caractères de citation autour des contenus de QChar, QString et QByteArray et renvoie une référence au flux.

Lorsque l'insertion de guillemets est désactivée, ces types sont imprimés sans caractères de citation et sans échappement des caractères non imprimables.

Voir également quote() et maybeQuote().

QDebug &QDebug::nospace()

Désactive l'insertion automatique d'espaces et renvoie une référence au flux.

Voir aussi space() et maybeSpace().

QDebug &QDebug::quote()

Active l'insertion automatique de caractères de citation autour des contenus de QChar, QString et QByteArray et renvoie une référence au flux.

L'insertion de guillemets est activée par défaut.

Voir aussi noquote() et maybeQuote().

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

Renvoie true si cette instance de QDebug citera les chaînes de caractères qui lui sont transmises (ce qui est le cas par défaut).

Cette fonction a été introduite dans Qt 6.7.

Voir aussi QDebugStateSaver, quote(), noquote(), et setQuoteStrings().

QDebug &QDebug::resetFormat()

Réinitialise les options de formatage du flux, le ramenant à son état initial.

Voir aussi space() et quote().

void QDebug::setAutoInsertSpaces(bool b)

Active l'insertion automatique d'espaces entre les écritures si b est vrai ; sinon, l'insertion automatique d'espaces est désactivée.

Voir aussi autoInsertSpaces() et QDebugStateSaver.

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

Active la mise entre guillemets des chaînes de caractères transmises à cette instance QDebug si b est true; sinon, la mise entre guillemets est désactivée.

Par défaut, les chaînes de caractères ne sont pas citées.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi QDebugStateSaver, quote(), noquote(), et quoteStrings().

void QDebug::setVerbosity(int verbosityLevel)

Définit la verbosité du flux à verbosityLevel.

La plage autorisée est comprise entre 0 et 7. La valeur par défaut est 2.

Voir également verbosity() et VerbosityLevel.

QDebug &QDebug::space()

Écrit un caractère espace dans le flux de débogage et renvoie une référence au flux.

Le flux se souvient que l'insertion automatique d'espaces est activée pour les écritures futures.

Voir aussi nospace() et maybeSpace().

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

Remplace cette instance de flux de débogage par other. Cette opération est très rapide et n'échoue jamais.

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

Cela équivaut à passer object à QDebug::toString(object).toUtf8(), mais c'est plus efficace.

Cette fonction a été introduite dans Qt 6.9.

Voir aussi toString().

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

Stream object dans une instance QDebug qui opère sur une chaîne de caractères, puis renvoie cette chaîne.

Cette fonction est utile lorsque vous avez besoin de la représentation textuelle d'un objet pour le débogage, mais que vous ne pouvez pas utiliser operator<<. Par exemple :

QString str = QDebug::toString(list);

La chaîne est transmise en continu à l'aide de nospace().

Cette fonction a été introduite dans Qt 6.0.

Voir aussi toBytes().

int QDebug::verbosity() const

Renvoie la verbosité du flux de débogage.

Les opérateurs de flux peuvent vérifier la valeur pour décider si une sortie verbeuse est souhaitée et imprimer plus d'informations en fonction du niveau. Des valeurs plus élevées indiquent que davantage d'informations sont souhaitées.

La plage autorisée est comprise entre 0 et 7. La valeur par défaut est 2.

Voir également setVerbosity() et VerbosityLevel.

QDebug &QDebug::verbosity(int verbosityLevel)

Définit la verbosité du flux à verbosityLevel et renvoie une référence au flux.

La plage autorisée est comprise entre 0 et 7. La valeur par défaut est 2.

Voir aussi verbosity(), setVerbosity() et VerbosityLevel.

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

Écrit les données du tableau d'octets observé, t, dans le flux et renvoie une référence au flux.

Normalement, QDebug imprime les données entre guillemets et transforme les caractères de contrôle ou non US-ASCII en leurs séquences d'échappement C (\xAB). De cette manière, la sortie est toujours propre sur 7 bits et la chaîne peut être copiée à partir de la sortie et recollée dans des sources C++, si nécessaire.

Pour imprimer des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends QDebug peuvent ne pas être propres sur 8 bits.

Voir la surcharge QByteArray pour des exemples.

Cette fonction a été introduite dans Qt 6.0.

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

Écrit le caractère, t, dans le flux et renvoie une référence au flux. Normalement, QDebug imprime les caractères de contrôle et les caractères non US-ASCII sous la forme de leur séquence d'échappement C ou de leur valeur Unicode (\u1234). Pour imprimer des caractères non imprimables sans transformation, activez la fonctionnalité noquote(), mais notez que certains backends QDebug peuvent ne pas être propres sur 8 bits et ne pas être en mesure de représenter t.

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

Écrit la chaîne, t, dans le flux et renvoie une référence au flux. Normalement, QDebug imprime la chaîne entre guillemets et transforme les caractères non imprimables en leurs valeurs Unicode (\u1234).

Pour imprimer des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends QDebug peuvent ne pas être propres sur 8 bits.

Voir la surcharge QString pour des exemples.

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

Écrit la vue de la chaîne, s, dans le flux et renvoie une référence au flux. Normalement, QDebug imprime la chaîne entre guillemets et transforme les caractères non imprimables en leurs valeurs Unicode (\u1234).

Pour imprimer les caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends QDebug peuvent ne pas être propres sur 8 bits.

Voir la surcharge QString pour des exemples.

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

Écrit la vue de la chaîne, s, dans le flux et renvoie une référence au flux.

Normalement, QDebug imprime les données entre guillemets et transforme les caractères de contrôle ou non US-ASCII en leurs séquences d'échappement C (\xAB). De cette manière, la sortie est toujours propre sur 7 bits et la chaîne peut être copiée à partir de la sortie et recollée dans des sources C++, si nécessaire.

Pour imprimer des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends de QDebug peuvent ne pas être propres sur 8 bits.

Cette fonction a été introduite dans Qt 6.0.

Imprime la représentation textuelle de l'entier de 128 bits i.

Ces fonctions ont été introduites dans Qt 6.7.

Voir aussi QT_SUPPORTS_INT128.

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

Écrit la valeur booléenne, t, dans le flux et renvoie une référence au flux.

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

Écrit le caractère t dans le flux et renvoie une référence au flux.

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

Écrit le caractère UTF-16, t, dans le flux et renvoie une référence au flux.

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

Écrit le caractère UTF-32, t, dans le flux et renvoie une référence au flux.

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

Écrit le tableau d'octets, t, dans le flux et renvoie une référence au flux. Normalement, QDebug imprime le tableau entre guillemets et transforme les caractères de contrôle ou non US-ASCII en leurs séquences d'échappement C (\xAB). De cette manière, la sortie est toujours propre sur 7 bits et la chaîne peut être copiée à partir de la sortie et recollée dans des sources C++, si nécessaire.

Pour imprimer des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends de QDebug peuvent ne pas être propres sur 8 bits.

Exemples de sortie :

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"; // caractère d'échappementqDebug() << ba;              // prints: "\x1B"

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

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

Notez que QDebug a dû fermer et rouvrir la chaîne de caractères de la manière dont les langages C et C++ concaténent les chaînes de caractères littérales afin que la lettre "b" ne soit pas interprétée comme faisant partie de la séquence d'échappement hexadécimale précédente.

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

Écrit la chaîne, t, dans le flux et renvoie une référence au flux. Normalement, QDebug imprime la chaîne entre guillemets et transforme les caractères non imprimables en leurs valeurs Unicode (\u1234).

Pour imprimer des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends de QDebug peuvent ne pas être propres sur 8 bits.

Exemples de sortie :

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"; // caractère d'échappementqDebug() << s;              // prints: "\u001B"

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

s = "\u00E1"; // LATIN SMALL LETTER A WITH ACUTEqDebug() << s;              // prints: "á"

s = "a\u0301"; // "a" suivi d'un ACCENT ACUTE COMBINANTqDebug() << s;              // prints: "á";

s = "\u0430\u0301"; // MAJUSCULE CYRILLIQUE A suivi d'un ACCENT ACUTE COMBINANTqDebug() << s;              // prints: "а́"

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

Écrit la chaîne UTF-8 terminée par '\0', t, dans le flux et renvoie une référence au flux. La chaîne n'est jamais citée ou échappée pour la sortie. Notez que QDebug met en mémoire tampon en interne en UTF-16 et peut avoir besoin d'être transformé en 8 bits en utilisant le codec de la locale afin d'utiliser certains backends, ce qui peut provoquer une sortie brouillée (mojibake). Il est recommandé de se limiter aux chaînes US-ASCII.

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

Écrit la chaîne UTF-16 terminée par u'\0't, dans le flux et renvoie une référence au flux. La chaîne n'est jamais citée ou échappée pour la sortie. Notez que QDebug met en mémoire tampon en interne en UTF-16 et peut avoir besoin d'être transformé en 8 bits en utilisant le codec de la locale afin d'utiliser certains backends, ce qui peut provoquer une sortie brouillée (mojibake). Il est recommandé de se limiter aux chaînes US-ASCII.

Cette fonction a été introduite dans Qt 6.0.

Écrit la chaîne ou la vue de chaîne s dans le flux et renvoie une référence au flux.

Ces opérateurs ne participent à la résolution des surcharges que si Char est l'un des éléments suivants

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

Ces fonctions ont été introduites dans Qt 6.5.

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

Écrit le contenu de opt (ou nullopt s'il n'est pas défini) dans ce flux. T doit prendre en charge le flux vers QDebug.

Cette fonction a été introduite dans Qt 6.7.

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

Écrit le contenu de tuple dans le flux. Tous les sites Ts... doivent prendre en charge le streaming vers QDebug.

Cette fonction a été introduite dans Qt 6.9.

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

Écrit un pointeur, t, dans le flux et renvoie une référence au flux.

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

Écrit le nombre à virgule flottante de 64 bits, t, dans le flux et renvoie une référence au flux.

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

Écrit le nombre à virgule flottante de 32 bits, t, dans le flux et renvoie une référence au flux.

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

Écrit l'entier signé, t, dans le flux et renvoie une référence au flux.

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

Écrit l'entier long signé, t, dans le flux et renvoie une référence au flux.

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

Écrit l'entier signé de 64 bits, t, dans le flux et renvoie une référence au flux.

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

Écrit un entier non signé de 64 bits, t, dans le flux et renvoie une référence au flux.

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

Écrit l'entier court signé, t, dans le flux et renvoie une référence au flux.

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

Imprime la durée du temps duration dans le flux et renvoie une référence au flux. La chaîne imprimée est la représentation numérique de la période suivie de l'unité de temps, similaire à ce que la bibliothèque standard C++ produirait avec std::ostream.

L'unité n'est pas localisée.

Cette fonction a été introduite dans Qt 6.6.

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

Écrit nullopt dans le flux.

Cette fonction a été introduite dans Qt 6.7.

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

Écrit un entier non signé, t, dans le flux et renvoie une référence au flux.

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

Écrit alors un entier long non signé, t, dans le flux et renvoie une référence au flux.

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

Écrit alors un entier court non signé, t, dans le flux et renvoie une référence au flux.

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

Affecte le flux de débogage other à ce flux et renvoie une référence à ce flux.