QDebug Class

Documentation des fonctions membres

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

Crée un flux de débogage qui écrit dans le fichier spécifié byteArray.

Les données sont encodées en UTF-8, ce qui peut ne pas correspondre aux paramètres régionaux du système, par exemple sous Windows.

Avec les objets instanciés à l'aide de ce constructeur, les données peuvent être mises en mémoire tampon et ne seront pas écrites dans le tableau d'octets tant que le flux n'aura pas été vidé, par exemple à l'aide de ` Qt::flush`.

Cette fonction a été introduite dans Qt 6.9.

Voir également QTextStream manipulators.

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

Crée un flux de débogage qui écrit dans le fichier spécifié device.

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

Crée un flux de débogage qui écrit dans le fichier spécifié string.

[explicit] QDebug::QDebug(QtMsgType t)

Crée un flux de débogage qui écrit dans le gestionnaire correspondant au type de message « t ».

QDebug::QDebug(const QDebug &o)

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

[noexcept] QDebug::~QDebug()

Vide toutes les données en attente d'écriture et supprime 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 également setAutoInsertSpaces() et QDebugStateSaver.

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

Écrit un caractère c dans le flux de débogage, en fonction du paramètre actuel d'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 espace dans le flux de débogage, en fonction du paramètre actuel d'insertion automatique d'espaces, et renvoie une référence au flux.

Voir également space() et nospace().

QDebug &QDebug::noquote()

Désactive l'insertion automatique de guillemets autour du contenu de QChar, QString et QByteArray, puis renvoie une référence au flux.

Lorsque la mise entre guillemets est désactivée, ces types sont affichés sans guillemets 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 également space() et maybeSpace().

QDebug &QDebug::quote()

Active l'insertion automatique de guillemets autour du contenu de QChar, QString et QByteArray, et renvoie une référence au flux.

La mise entre guillemets est activée par défaut.

Voir également noquote() et maybeQuote().

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

Renvoie « true » si cette instance de ` QDebug ` place les chaînes qui lui sont transmises entre guillemets (ce qui est le comportement par défaut).

Cette fonction a été introduite dans Qt 6.7.

Voir également QDebugStateSaver, quote(), noquote() et setQuoteStrings().

QDebug &QDebug::resetFormat()

Réinitialise les options de mise en forme du flux, le ramenant ainsi à son état initial.

Voir également space() et quote().

void QDebug::setAutoInsertSpaces(bool b)

Active l'insertion automatique d'espaces entre les écritures si la valeur de ` b ` est « true » ; dans le cas contraire, l'insertion automatique d'espaces est désactivée.

Voir également autoInsertSpaces() et QDebugStateSaver.

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

Active la mise entre guillemets des chaînes transmises en continu à cette instance d'QDebug si b est true; dans le cas contraire, la mise entre guillemets est désactivée.

Par défaut, les chaînes sont mises entre guillemets.

Cette fonction a été introduite dans Qt 6.7.

Voir également QDebugStateSaver, quote(), noquote() et quoteStrings().

void QDebug::setVerbosity(int verbosityLevel)

Définit le niveau de détail du flux sur « verbosityLevel ».

La plage autorisée va de 0 à 7. La valeur par défaut est 2.

Voir également verbosity() et VerbosityLevel.

QDebug &QDebug::space()

Écrit un espace dans le flux de débogage et renvoie une référence à ce flux.

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

Voir également nospace() et maybeSpace().

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

Permet d'échanger cette instance de flux de débogage contre celle de other. Cette opération est très rapide et ne plante jamais.

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

Cela revient à transmettre ` object ` à ` QDebug::toString(object).toUtf8()`, mais de manière plus efficace.

Cette fonction a été introduite dans Qt 6.9.

Voir également toString().

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

Convertit ` object ` en une instance de ` 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 à des fins de débogage, mais que vous ne pouvez pas utiliser ` operator<<`. Par exemple :

QString str = QDebug::toString(list);

La chaîne est transmise via ` nospace()`.

Cette fonction a été introduite dans Qt 6.0.

Voir aussi toBytes().

int QDebug::verbosity() const

Renvoie le niveau de détail du flux de débogage.

Les opérateurs de flux peuvent vérifier cette valeur pour déterminer si une sortie détaillée est souhaitée et afficher davantage d'informations en fonction du niveau. Plus la valeur est élevée, plus le niveau de détail souhaité est important.

La plage autorisée va de 0 à 7. La valeur par défaut est 2.

Voir également setVerbosity() et VerbosityLevel.

QDebug &QDebug::verbosity(int verbosityLevel)

Définit le niveau de détail du flux sur « verbosityLevel » et renvoie une référence au flux.

La plage autorisée va de 0 à 7. La valeur par défaut est 2.

Voir également 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 à ce flux.

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

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

Consultez la surcharge de ` 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 à ce dernier. Normalement, ` QDebug ` affiche les caractères de contrôle et les caractères non US-ASCII sous la forme de leurs séquences d'échappement C ou de leur valeur Unicode (`\u1234`). Pour afficher des caractères non imprimables sans transformation, activez la fonctionnalité ` noquote()`, mais notez que certains backends d'QDebug peuvent ne pas être compatibles avec les 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 à ce dernier. En règle générale, la fonction QDebug affiche la chaîne entre guillemets et convertit les caractères non imprimables en leurs valeurs Unicode (\u1234).

Pour afficher des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends de QDebug peuvent ne pas prendre correctement en charge les caractères 8 bits.

Consultez la surcharge de QString pour des exemples.

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

Écrit la chaîne de caractères « view » ( s) dans le flux et renvoie une référence à ce dernier. En règle générale, la fonction « QDebug » affiche la chaîne entre guillemets et convertit les caractères non imprimables en leurs valeurs Unicode (\u1234).

Pour afficher des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends de QDebug peuvent ne pas prendre correctement en charge les caractères 8 bits.

Consultez la surcharge de la fonction ` QString ` pour voir des exemples.

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

Écrit la chaîne de caractères « s » dans le flux et renvoie une référence à ce flux.

Normalement, ` QDebug ` affiche 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 compatible 7 bits et la chaîne peut être copiée depuis la sortie puis recollée dans les sources C++, si nécessaire.

Pour afficher des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends QDebug peuvent ne pas prendre en charge correctement les caractères 8 bits.

Cette fonction a été introduite dans Qt 6.0.

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

Ces fonctions ont été introduites dans Qt 6.7.

Voir également QT_SUPPORTS_INT128.

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

Écrit la valeur booléenne « t » dans le flux et renvoie une référence à ce flux.

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

Écrit le caractère « t » dans le flux et renvoie une référence à ce dernier.

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

Écrit le caractère UTF-16 « t » dans le flux et renvoie une référence à ce flux.

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

Écrit le caractère UTF-32 « t » dans le flux et renvoie une référence vers ce flux.

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

Écrit le tableau d’octets, t, dans le flux et renvoie une référence à ce dernier. Normalement, la fonction ` QDebug ` affiche 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 compatible 7 bits et la chaîne peut être copiée depuis la sortie puis recollée dans les sources C++, si nécessaire.

Pour afficher des caractères non imprimables sans transformation, activez la fonctionnalité ` noquote()`. Notez que certains backends de ` QDebug ` peuvent ne pas prendre en charge les caractères 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'échappement
qDebug() << ba;              // prints: "\x1B"

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

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

Remarquez comment QDebug a dû fermer puis rouvrir la chaîne, à la manière dont les langages C et C++ concatènent les littéraux de chaîne, 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 à ce dernier. En règle générale, la fonction ` QDebug ` affiche la chaîne entre guillemets et convertit les caractères non imprimables en leurs valeurs Unicode (\u1234).

Pour afficher des caractères non imprimables sans transformation, activez la fonctionnalité noquote(). Notez que certains backends de QDebug peuvent ne pas être compatibles avec les caractères 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'échappement
qDebug() << s;              // prints: "\u001B"

s = "\u00AD";               // TRAIT D'UNION SOUPLE
qDebug() << s;              // prints: "\u00AD"

s = "\u00E1";               // A MINUSCULE LATINE AVEC ACCENT AIGU
qDebug() << s;              // prints: "á"

s = "a\u0301";              // « a » suivi de l'ACCENT AIGU COMBINÉ
qDebug() << s;              // prints: "á";

s = "\u0430\u0301";         // LETTRE MINUSCULE A EN CYRILLIQUE suivie d'un ACCENT AIGU COMBINÉ
qDebug() << 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 à ce dernier. La chaîne n'est jamais mise entre guillemets ni échappée lors de la sortie. Notez que QDebug utilise en interne un tampon au format UTF-16 et peut être amené à convertir les données en 8 bits à l’aide du codec de la locale afin d’utiliser certains backends, ce qui peut entraîner une sortie altéré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 à ce flux. La chaîne n'est jamais mise entre guillemets ni échappée lors de la sortie. Notez que la fonction ` QDebug ` utilise en interne un tampon au format UTF-16 et peut être amenée à convertir la chaîne en 8 bits à l'aide du codec de la locale afin d'utiliser certains backends, ce qui peut entraîner une sortie déformé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 à ce 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> requires if_streamable<T> 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. La fonction ` T ` doit prendre en charge la diffusion en continu vers QDebug.

Cette fonction a été introduite dans Qt 6.7.

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

Écrit le contenu de ` tuple ` dans le flux. Toutes les fonctions ` Ts... ` doivent prendre en charge la transmission en continu 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 à ce dernier.

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

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

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

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

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

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

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

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

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

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

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

Écrit l'entier 64 bits non signé 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)

Affiche la durée duration dans le flux et renvoie une référence à ce dernier. La chaîne affichée correspond à la représentation numérique de la durée suivie de l'unité de temps, à l'instar de ce que produirait la bibliothèque standard C++ avec la fonction ` 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 l'entier non signé t dans le flux et renvoie une référence à ce dernier.

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

Écrit l'entier long non signé t dans le flux et renvoie une référence à ce flux.

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

Écrit l'entier court non signé t dans le flux et renvoie une référence vers ce flux.

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

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