QDebug

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

#include <QDebug>

Voir la position dans l'arbre des classes.

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 !