QDebug

La classe QDebug fournit un flux de sortie pour déboguer les informations. Plus d'informations...

#include <QDebug>

Description détaillée

La classe QDebug fournit un flux de sortie pour déboguer les informations.

QDebug est utilisé chaque fois que le développeur a besoin d'écrire la sortie du débogage ou de suivre les informations sur un périphérique, un fichier, une chaîne ou une console.

Utilisation basique

Dans le cas commun, il est utile d'appeler la fonction qDebug() pour obtenir un objet QDebug par défaut, utilisé pour l'écriture des informations de débogage.

qDebug() << "Date: " << QDate::currentDate();
qDebug() << "Types : " << QString("String") << QChar('x') << QRect(0, 10, 50, 40);
qDebug() << "Type de coordonnées personnalisées : " << coordinate;

Ceci construit un objet QDegug utilisant le constructeur qui accepte une valeur QtMsgType de QtDebugMsg. Similairement, les fonctions qWarning(), qCritical() et qFatal() retournent aussi un objet QDebug pour les types de message correspondants.

La classe fournit aussi plusieurs constructeurs pour d'autres situations, incluant un constructeur qui accepte un QFile ou une autre sous-classe de QIODevice, utilisés pour écrire les informations de débogage dans des fichiers et autres dispositifs. Le constructeur qui accepte un QString est utilisé pour écrire une chaîne pour l'affichage ou la sérialisation.

Écrire des types personnalisés pour un flux

De nombreux types standards peuvent être écrits pour les objets QDebug et Qt fournit un support pour la plupart des types de valeurs de Qt. Pour ajouter le support pour des types personnalisés, vous devez implémenter un opérateur de flux, comme dans l'exemple suivant :

QDebug operator<<(QDebug dbg, const Coordinate &c)
{
    dbg.nospace() << "(" << c.x() << ", " << c.y() << ")";
    return dbg.space();
}

Ceci est décrit dans les documents Techniques de débogage et Créer des types Qt personnalisés.

Fonctions membres

QDebug::QDebug ( QIODevice * device )

Construit un flux de débogage qui écrit dans le device donné.

QDebug::QDebug ( QString * string )

Construit un flux de débogage qui écrit dans la string donnée.

QDebug::QDebug ( QtMsgType type )

Construit un flux de débogage qui écrit dans le gestionnaire pour le type de message spécifié par type.

QDebug::QDebug ( const QDebug & other )

Constructeur par copie d'un autre flux de débogage, other étant l'autre flux.

QDebug::~QDebug ()

Vide toute donnée en attente d'écriture et détruit le flux de débogage.

QDebug & QDebug::maybeSpace ()

Écrit un caractère espace dans le flux de débogage, dépendant du dernier caractère envoyé à celui-ci, et retourne une référence du flux. Si le dernier caractère n'est pas un espace, cette fonction écrit un caractère espace dans le flux, sinon aucun caractère n'est écrit.

Voir aussi space() et nospace().

QDebug & QDebug::nospace ()

Efface le drapeau du flux interne qui enregistre si le dernier caractère était un espace et retourne une référence du flux.

Voir aussi space() et maybeSpace().

QDebug & QDebug::space ()

Écrit un caractère espace dans le flux débogage et retourne une référence du flux.

Le flux enregistrera que le dernier caractère qui lui a été envoyé était un espace.

Voir aussi nospace() et maybeSpace().

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

Écrit le caractère t dans le flux de débogage et retourne une référence du flux.

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

Écrit le booléen t dans le flux de débogage et retourne une référence du flux.

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

Écrit le caractère t dans le flux de débogage et retourne une référence du flux.

QDebug & QDebug::operator<< ( signed short i )

Écrit le nombre entier signé court i dans le flux de débogage et retourne une référence du flux.

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

Écrit le nombre entier non signé court i dans le flux de débogage et retourne une référence du flux.

QDebug & QDebug::operator<< ( signed int i )

Écrit le nombre entier signé i dans le flux de débogage et retourne une référence du flux.

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

Écrit le nombre entier non signé i dans le flux de débogage et retourne une référence du flux.

QDebug & QDebug::operator<< ( signed long l )

Écrit le nombre entier signé long l dans le flux de débogage et retourne une référence du flux.

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

Écrit le nombre entier non signé long l dans le flux de débogage et retourne une référence du flux.

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

Écrit le nombre entier signé de 64 bits i dans le flux de débogage et retourne une référence du flux.

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

Écrit le nombre entier non signé de 64 bits i dans le flux de débogage et retourne une référence du flux.

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

Écrit le nombre à virgule flottante de 32 bits f dans le flux de débogage et retourne une référence du flux.

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

Écrit le nombre à virgule flottante de 64 bits f dans le flux de débogage et retourne une référence du flux.

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

Écrit la chaîne s, jusqu'au caractère ‹\0›, dans le flux de débogage et retourne une référence du flux.

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

Écrit la chaîne s dans le flux de débogage et retourne une référence du flux.

QDebug & QDebug::operator<< ( const QStringRef & s )

Écrit la référence de la chaîne s dans le flux de débogage et retourne une référence du flux.

QDebug & QDebug::operator<< ( const QLatin1String & s )

Écrit la chaîne s, encodée en Latin1, dans le flux de débogage et retourne une référence du flux.

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

Écrit le tableau d'octets b dans le flux de débogage et retourne une référence du flux.

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

Écrit le pointeur p dans le flux de débogage et retourne une référence du flux.

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

Attribue le flux de débogage other à ce flux et retourne une référence de celui-ci.

Remerciements

Merci à Mikael Sans pour la traduction et à Jonathan Courtois, Thibaut Cuvelier et à Jacques Thery pour leur relecture !