QString

La classe QString fournit une cha�ne de caract�res Unicode. Plus d'informations...

#include <QString>

Voir la position dans l'arbre des classes.

H�ritage

H�rit� par QConstString, QDBusObjectPath et QDBusSignature.

Note : toutes les fonctions de cette classe sont r�entrantes, except� pour ascii(), latin1(), utf8() et local8Bit() qui sont non r�entrantes.

Description d�taill�e

La classe QString fournit une cha�ne de caract�res Unicode.

QString stocke une cha�ne de QChar de 16 bits, o� chaque QChar correspond � un caract�re Unicode 4.0. Un caract�re Unicode avec un code de valeur au-dessus de 65535 est stock� en utilisant des paires de substitution, c'est-�-dire deux QChar cons�cutifs.

Unicode est un standard international qui prend en charge la plupart des syst�mes d'�criture utilis�s aujourd'hui. Il s'agit d'un sur-ensemble de US-ASCII (ANSI X3.4-1986) et Latin-1 (ISO 8859-1). Tous les caract�res US-ASCII/Latin-1 sont disponibles � la m�me position.

En pratique, QString utilise un partage implicite (copie � l'�criture - pattern COW) pour r�duire la consommation de m�moire et �viter les copies inutiles de donn�es. Ceci aide aussi � r�duire la surcharge inh�rente au stockage des caract�res 16 bits au lieu de caract�res 8 bits.

En plus de QString, Qt fournit aussi la classe QByteArray pour stocker des octets bruts et les cha�nes 8 bits traditionnelles termin�es par \0. Dans la plupart des cas, QString est la classe � utiliser. Elle est utilis�e dans toute l'API Qt, et le support Unicode permet une traduction facile de vos applications. Les deux principaux cas o� QByteArray est appropri� sont lorsque vous avez besoin de stocker des donn�es binaires brutes et lorsque la consommation de m�moire est cruciale (comme Qt pour Linux embarqu�).

Initialiser une cha�ne de caract�res

Une fa�on d'initialiser une QString est tout simplement de passer un const char * � son constructeur. Par exemple, le code suivant cr�e une QString de taille 5 contenant « Hello » :

QString str = "Hello";

QString convertit la donn�e const char * en Unicode en utilisant la fonction fromAscii(). Par d�faut, fromAscii() traite un caract�re au-dessus de 128 comme un caract�re Latin-1 mais cela peut �tre modifi� en appelant QTextCodec::setCodecForCStrings().

Dans toutes les fonctions de QString qui prennent des param�tres const char *, le const char * est interpr�t� comme une cha�ne de caract�res classique comme en langage C, termin�e par \0. Il est possible de passer un param�tre const char * � 0.

Vous pouvez aussi fournir une cha�ne sous forme d'un tableau de QChar :

static const QChar data[4] = { 0x0055, 0x006e, 0x10e3, 0x03a3 };
QString str(data, 4);

QString fait une copie compl�te des donn�es QChar, afin qu'elle puisse �tre ensuite modifi�e sans effet de bord. Si, pour des raisons de performance, vous ne voulez pas faire une copie compl�te des donn�es des caract�res, utilisez plut�t QString::fromRawData().

Une autre approche est de d�finir la taille de la cha�ne de caract�res en utilisant resize() et d'initialiser les donn�es caract�re par caract�re. QString utilise des index commen�ant � 0, comme les tableaux C++. Pour acc�der � un caract�re � une position particuli�re, vous pouvez utiliser operator[](). Sur les cha�nes non constantes, operator[]() retourne une r�f�rence au caract�re qui peut �tre utilis�e sur la partie gauche d'une affectation. Par exemple :

QString str;
str.resize(4);
 
str[0] = QChar('U');
str[1] = QChar('n');
str[2] = QChar(0x10e3);
str[3] = QChar(0x03a3);

Pour un acc�s en lecture seule, la fonction at() propose une syntaxe alternative :

QString str;
 
for (int i = 0; i < str.size(); ++i) {
    if (str.at(i) >= QChar('a') && str.at(i) <= QChar('f'))
             qDebug() << "Found character in range [a-f]";
}

La fonction at() peut �tre plus rapide que operator[](), parce qu'elle ne d�clenche jamais de copie en profondeur. Vous pouvez aussi utiliser les fonctions left(), right() ou mid() pour extraire plusieurs caract�res � la fois.

Une QString peut inclure des caract�res \0 (QChar::Null). La fonction size() retourne toujours la taille de la cha�ne de caract�res compl�te, incluant les caract�res \0.

Apr�s un appel � la fonction resize(), les nouveaux caract�res allou�s ont des valeurs ind�finies. Pour fixer tous les caract�res d'une cha�ne � une valeur particuli�re, utilisez la fonction fill().

QString fournit des dizaines de surcharges con�ues pour simplifier l'usage des cha�nes de caract�res. Par exemple, si vous voulez comparer une QString avec une cha�ne de caract�res litt�rale, vous pouvez �crire ce type de code et il produira le r�sultat attendu :

QString str;
 
if (str == "auto" || str == "extern"
        || str == "static" || str == "register") {
    // ...
}

Vous pouvez �galement passer des cha�nes de caract�res litt�rales � des fonctions qui prennent des QString en argument, appelant ainsi le constructeur QString(const char *). De m�me, vous pouvez passer une QString � une fonction qui prend un argument const char * en utilisant la macro qPrintable(), qui retourne la QString donn�e en const char *. Cela est �quivalent � l'appel de <QString>.toLocal8Bit().constData().

Manipuler les donn�es d'une cha�ne de caract�res

QString fournit les fonctions de base suivantes pour modifier les donn�es : append(), prepend(), insert(), replace() et remove(). Par exemple :

QString str = "and";
str.prepend("rock ");     // str == "rock and"
str.append(" roll");      // str == "rock and roll"
str.replace(5, 3, "&");   // str == "rock & roll"

Si vous construisez une QString graduellement et que vous connaissez � l'avance approximativement le nombre de caract�res que la QString contiendra, vous pouvez appeler reserve(), qui demande � QString de pr�allouer un espace m�moire suffisant. Vous pouvez �galement appeler capacity() pour r�cup�rer l'espace m�moire allou� par une QString.

Les deux premiers arguments des fonctions replace() et remove() sont la position du d�but de l'effacement et le nombre de caract�res qui doivent �tre effac�s. Si vous voulez remplacer toutes les occurrences d'une sous-cha�ne de caract�res particuli�re par une autre, utilisez l'une des surcharges de replace() � deux param�tres.

Un besoin fr�quent est de retirer les espaces blancs d'une cha�ne de caract�res (\n, \t, ' ', etc.). Si vous voulez retirer les espaces blancs des deux extr�mit�s d'une QString, utilisez la fonction trimmed(). Si vous voulez retirer les espaces blancs des deux extr�mit�s et remplacer plusieurs espaces blancs cons�cutifs par un espace simple � l'int�rieur de la cha�ne de caract�res, utilisez simplified().

Si vous voulez trouver toutes les occurrences d'un caract�re particulier ou d'une sous-cha�ne dans une QString, utilisez les fonctions indexOf() ou lastIndexOf(). La premi�re cherche en avant en commen�ant par l'index de position donn� ; la derni�re cherche en arri�re. Les deux renvoient l'index de position du caract�re ou de la sous-cha�ne si elles le trouvent ; sinon elles renvoient -1. Par exemple, vous retrouvez ci-dessous une boucle typique qui trouve toutes les occurrences d'une sous-cha�ne particuli�re :

QString str = "Nous devons �tre <b>gras</b>, tr�s <b>gras</b>";
int j = 0;
 
while ((j = str.indexOf("<b>", j)) != -1) {
    qDebug() << "Le tag <b> a �t� trouv� � la position" << j;
    ++j;
}

QString fournit de nombreuses fonctions pour convertir des nombres en cha�nes de caract�res et inversement. Voir les fonctions arg(), setNum(), les fonctions statiques number() et les fonctions toInt(), toDouble() et similaires.

Pour obtenir une version en majuscules ou minuscules d'une cha�ne, utilisez toUpper() ou toLower().

Les listes de cha�nes sont g�r�es par la classe QStringList. Vous pouvez s�parer une cha�ne de caract�res en une liste de cha�nes en utilisant la fonction split() et joindre une liste de cha�ne en une seule cha�ne avec un s�parateur optionnel en utilisant QStringList::join(). Vous pouvez obtenir une liste de cha�nes � partir d'une autre qui contient une sous-cha�ne particuli�re ou qui correspond � une QRegExp particuli�re en utilisant la fonction QStringList::find().

Requ�tes sur les donn�es d'une cha�ne de caract�res

Si vous voulez savoir si une QString commence ou se termine par une sous-cha�ne particuli�re, utilisez startsWith() ou endsWith(). Si vous voulez simplement v�rifier qu'une QString contient un caract�re particulier ou une sous-cha�ne, utilisez la fonction contains(). Si vous voulez trouver combien de fois un caract�re particulier ou une sous-cha�ne appara�t dans une cha�ne, utilisez count().

Les QString peuvent �tre compar�es en utilisant des surcharges d'op�rateurs comme operator<(), operator<=(), operator==(), operator>=(), etc. Notez que la comparaison se base exclusivement sur les valeurs Unicode num�riques des caract�res. Cela est tr�s rapide mais pas vraiment ce qu'un humain attendrait ; la fonction QString::localeAwareCompare() est un meilleur choix pour trier des cha�nes de caract�res provenant d'une interface utilisateur.

Pour obtenir un pointeur sur les caract�res, appelez data() ou constData(). Ces fonctions retournent un pointeur sur le d�but des donn�es QChar. La validit� du pointeur est garantie jusqu'� ce qu'une fonction non const soit appel�e sur la QString.

Conversion entre cha�nes de caract�res 8-Bit et Unicode

QString fournit les quatre fonctions suivantes qui retournent une version const char * de la cha�ne sous forme d'un QByteArray : toAscii(), toLatin1(), toUtf8() et toLocal8Bit().

• toAscii() retourne une cha�ne de caract�res encod�e sur 8 bits utilisant le codec sp�cifi� par QTextCodec::codecForCStrings (par d�faut, il s'agit de Latin 1).
• toLatin1() retourne une cha�ne de caract�res Latin-1 (ISO 8859-1) encod�e sur 8 bits.
• toUtf8() retourne une cha�ne de caract�res UTF-8 encod� sur 8 bits. UTF-8 est un sur-ensemble de US-ASCII (ANSI X3.4-1986) qui supporte la totalit� des caract�res Unicode gr�ce � plusieurs s�quences multibytes.
• toLocal8Bit() retourne une cha�ne de caract�res sur 8 bits utilisant l'encodage local.

Pour convertir � partir d'un de ces encodages, QString fournit les fonctions fromAscii(), fromLatin1(), fromUtf8() et fromLocal8Bit(). D'autres encodages sont support�s � travers la classe QTextCodec.

Comme mentionn� ci-dessus, QString fournit de nombreuses fonctions et op�rateurs qui rendent ais�e l'interaction avec des cha�nes de caract�res const char *. Mais cette fonctionnalit� est � double tranchant : cela rend QString plus facile � utiliser si toutes les cha�nes de caract�res sont US-ASCII ou Latin-1, mais il y a toujours le risque qu'une conversion implicite � partir de ou vers const char * soit effectu�e en utilisant un mauvais encodage, sur 8 bits. Pour minimiser ces risques, vous pouvez d�sactiver ces conversions implicites en d�finissant les symboles pr�processeur suivants :

• QT_NO_CAST_FROM_ASCII d�sactive les conversions automatiques � partir des cha�nes de caract�res litt�rales du langage C et les pointeurs Unicode ;
• QT_NO_CAST_TO_ASCII d�sactive les conversions automatiques � partir de QString vers les cha�nes de caract�res du langage C.

Une mani�re de d�finir ces symboles pr�processeur globalement pour votre application est d'ajouter les entr�es suivantes � votre fichier de projet qmake :

DEFINES += QT_NO_CAST_FROM_ASCII \
            QT_NO_CAST_TO_ASCII

Vous devez ensuite appeler explicitement fromAscii(), fromLatin1(), fromUtf8() ou fromLocal8Bit() pour construire une QString � partir d'une cha�ne de caract�res sur 8 bits ou utiliser la classe QLatin1String, par exemple :

 QString url = QLatin1String("http://www.unicode.org/");

De la m�me mani�re, vous devez appeler toAscii(), toLatin1(), toUtf8() ou toLocal8Bit() explicitement pour convertir la QString en une cha�ne de caract�res 8 bits. D'autres encodages sont support�s � travers la classe QTextCodec.

Note pour les programmeurs C

En raison du syst�me de type du C++ et le fait que QString est implicitement partag�e, les QString peuvent �tre trait�es comme des int ou d'autres types de base. Par exemple :

QString Widget::boolToString(bool b)
{
    QString result;
    if (b)
        result = "True";
    else
        result = "False";
    return result;
}

La variable result est une variable normale allou�e sur la pile. Quand return est appel�, parce que nous faisons un retour par valeur, le constructeur par copie est appel� et une copie de la cha�ne de caract�res est retourn�e. Gr�ce au partage implicite, le contenu de la cha�ne n'est pas copi�.

Distinction entre null et cha�ne de caract�res vide

Pour des raisons historiques, QString fait la distinction entre une cha�ne de caract�res null et vide. Une cha�ne de caract�res null est une cha�ne qui est initialis�e en utilisant le constructeur par d�faut de QString ou en passant (const char *)0 au constructeur. Une cha�ne de caract�res vide (empty) est n'importe quelle cha�ne avec une taille de 0. Une cha�ne de caract�res null est toujours vide mais une cha�ne vide n'est pas n�cessairement null :

     QString().isNull();               // retourne vrai
     QString().isEmpty();              // retourne vrai
 
     QString("").isNull();             // retourne faux
     QString("").isEmpty();            // retourne vrai
 
     QString("abc").isNull();          // retourne faux
     QString("abc").isEmpty();         // retourne faux

Toutes les fonctions sauf isNull() traitent les cha�nes de caract�res null de la m�me fa�on que les vides. Par exemple, toAscii(). constData() retourne un pointeur sur un caract�re \0 pour une cha�ne de caract�res null (pas un pointeur null) et QString() est identique � QString( » »). Nous vous recommandons d'utiliser toujours la fonction isEmpty() et d'�viter isNull().

L'argument format

Dans les fonctions membres o� un argument format peut �tre sp�cifi� (par exemple, arg(), number()), il peut prendre l'une des valeurs suivantes :

Une pr�cision est �galement sp�cifi�e avec l'argument format. Pour les formats e, E et f, la pr�cision repr�sente le nombre de chiffres apr�s la virgule (ou point d�cimal). Pour les formats g et G, la pr�cision repr�sente le nombre maximum de chiffres significatifs (en omettant les z�ros terminaux).

Construction de cha�ne de caract�res plus efficacement

En utilisant l'op�rateur +, il est facile de construire une cha�ne de caract�res complexe � partir de plusieurs sous-cha�nes. Vous allez souvent �crire du code comme ceci :

QString foo;
QString type = "long";
 
foo->setText(QLatin1String("vector<") + type + QLatin1String(">::iterator"));
 
if (foo.startsWith("(" + type + ") 0x"))
    ...

Ces constructions de cha�nes sont correctes mais contiennent cependant plusieurs inefficacit�s cach�es. Depuis Qt 4.6, vous pouvez les �liminer.

Tout d'abord, les utilisations multiples de l'op�rateur + signifient g�n�ralement plusieurs allocations m�moire. Quand vous concat�nez n sous-cha�nes de caract�res, avec n > 2, il peut y avoir jusque n - 1 appel � l'allocateur de m�moire.

Ensuite, QLatin1String ne stocke pas sa longueur en interne mais fait appel � qstrlen() quand elle a besoin de conna�tre sa longueur.

Dans 4.6, une classe template interne QStringBuilder a �t� ajout�e avec plusieurs fonctions utilitaires. Cette classe est marqu�e interne et n'appara�t pas dans la documentation, parce que vous n'�tes pas cens� l'instancier dans votre code. Son utilisation sera automatique comme d�crit ci-dessous. La classe peut �tre trouv�e dans src/corelib/tools/qstringbuilder.cpp si vous voulez y jeter un coup d'?il.

QStringBuilder utilise des templates d'expression et r�impl�mente l'op�rateur %, ce qui permet, lorsque vous utilisez % pour la concat�nation � la place de +, de diff�rer les concat�nations multiples jusqu'� ce que le r�sultat final soit sur le point d'�tre affect� � une QString. � ce moment, l'espace m�moire requis pour le r�sultat final est connu. L'allocateur de m�moire est ensuite appel� une seule fois pour obtenir l'espace requis et les sous-cha�nes y sont copi�es une par une.

QLatin1Literal est une deuxi�me classe interne qui peut remplacer QLatin1String, qui ne peut pas changer pour des raisons de compatibilit�. QLatin1Literal stocke sa longueur, ce qui �conomise du temps quand QStringBuilder calcule l'espace m�moire n�cessaire pour la cha�ne finale.

Un gain suppl�mentaire d'efficacit� provient des inlining et de la r�duction du comptage des r�f�rences (la QString cr��e � partir d'un QStringBuilder poss�de typiquement un compteur de r�f�rences � 1, alors que QString::append() n�cessite un test suppl�mentaire).

Il y a trois mani�res d'acc�der � cette m�thode am�lior�e de construction de cha�nes. La m�thode la plus rapide est d'inclure QStringBuilder o� vous voulez l'utiliser et d'ensuite utiliser l'op�rateur % au lieu de + lors de la concat�nation :

#include <QStringBuilder>
 
QString hello("hello");
QStringRef el(&hello, 2, 3);
QLatin1String world("world");
QString message =  hello % el % world % QChar('!');

Une approche plus globale est d'inclure cette d�finition :

#define QT_USE_FAST_CONCATENATION

En plus d'utiliser % au lieu de +.

La troisi�me approche, la plus commode mais pas enti�rement compatible, est d'utiliser deux d�finitions :

#define QT_USE_FAST_CONCATENATION
#define QT_USE_FAST_OPERATOR_PLUS

Le + sera automatiquement remplac� en %.

Voir aussi fromRawData(), QChar, QLatin1String, QByteArray et QStringRef.

Type

typedef QString::ConstIterator

Synonyme de style Qt pour QString::const_iterator.

typedef QString::Iterator

Synonyme de style Qt pour QString::iterator.

enum QString::NormalizationForm

Cette �num�ration d�crit les diverses formes normalis�es de texte Unicode.

Voir aussi normalized() et l'annexe 15 du standard Unicode.

enum QString::SectionFlagflags QString::SectionFlags

Cette �num�ration sp�cifie les drapeaux pouvant �tre utilis�s pour modifier divers aspects du comportement de la fonction section() vis-�-vis des s�parateurs et des champs vides.

Le type SectionFlags est un typedef de QFlags<SectionFlag>. Il stocke une combinaison OU de valeurs SectionFlag.

Voir aussi section().

enum QString::SplitBehavior

Cette �num�ration sp�cifie le comportement de la fonction split() vis-�-vis des cha�nes vides.

Voir aussi split().

typedef QString::const_iterator

Le typedef QString::const_iterator fournit un it�rateur constant dans le style STL pour QString.

Voir aussi QString::iterator.

typedef QString::iterator

Le typedef QString::iterator fournit un it�rateur non constant dans le style STL pour QString.

Voir aussi QString::const_iterator.

Fonctions membres

QString::QString ()

Construit une cha�ne nulle. Les cha�nes nulles sont aussi vides. Voir aussi isEmpty().

QString::QString ( const QChar * unicode, int size )

Construit une cha�ne initialis�e avec les size premiers caract�res du tableau de QChar unicode.

QString fait une copie en profondeur de la cha�ne. Les donn�es Unicode sont copi�es telles quelles et la marque d'ordre des octets est conserv�e si elle est pr�sente.

QString::QString ( const QChar * unicode )

Construit une cha�ne initialis�e avec les caract�res du tableau de QChar unicode, qui doit �tre fini avec un 0.

QString fait une copie en profondeur de la cha�ne. Les donn�es Unicode sont copi�es telles quelles et la marque d'ordre des octets est conserv�e si elle est pr�sente.

Cette fonction a �t� introduite dans Qt 4.7.

QString::QString ( QChar ch )

Construit une cha�ne de taille unitaire contenant le caract�re ch.

QString::QString ( int size, QChar ch )

Construit une cha�ne de la taille size donn�e avec chaque caract�re d�fini � ch.

Voir aussi fill().

QString::QString ( const QLatin1String & str )

Construit une copie de la cha�ne Latin-1 str.

Voir aussi fromLatin1().

QString::QString ( const QString & other )

Construit une copie de other.

Cette op�ration est effectu�e en temps constant, car QString est implicitement partag�e. Ceci rend le retour d'une QString dans une fonction tr�s rapide. Si une instance partag�e est modifi�e, elle sera copi�e (copy-on-write) et cela prend un temps lin�aire.

Voir aussi operator=().

QString::QString ( const char * str )

Construit une cha�ne initialis�e avec la cha�ne 8 bits str. Le pointeur sur caract�re constant est converti en Unicode en utilisant la fonction fromAscii().

Vous pouvez d�sactiver ce constructeur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de votre application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

Voir aussi fromAscii(), fromLatin1(), fromLocal8Bit() et fromUtf8().

QString::QString ( const QByteArray & ba )

Construit une cha�ne initialis�e avec le tableau d'octets ba. Le tableau d'octets donn� est converti en Unicode en utilisant la fonction fromAscii(). La copie s'arr�te au premier caract�re null ; sinon, tout le tableau d'octets est copi�.

Vous pouvez d�sactiver ce constructeur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de votre application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

Voir aussi fromAscii(), fromLatin1(), fromLocal8Bit() et fromUtf8().

QString::~QString ()

D�truit la cha�ne de caract�res.

QString & QString::append ( const QString & str )

Ajoute la cha�ne str � la fin de cette cha�ne.

Exemple :

QString x = "free";
QString y = "dom";
 
x.append(y);
// x == "freedom"

Ceci est �quivalent � l'utilisation de la fonction insert() :

x.insert(x.size(), y);

La fonction append() est g�n�ralement tr�s rapide (temps constant), parce que QString pr�alloue de l'espace suppl�mentaire � la fin des donn�es de la cha�ne contenue pour qu'elle puisse grandir sans devoir r�allouer la cha�ne � chaque fois.

Voir aussi operator+=(), prepend() et insert().

QString & QString::append ( const QStringRef & reference )

Ajoute la reference donn�e � cette cha�ne et retourne le r�sultat.

Cette fonction a �t� introduite dans Qt 4.4.

QString & QString::append ( const QLatin1String & str )

Cette fonction surcharge append().

Ajoute la cha�ne Latin-1 str � cette cha�ne.

QString & QString::append ( const QByteArray & ba )

Cette fonction surcharge append().

Ajoute le tableau d'octets ba � cette cha�ne. Le tableau d'octets donn� est converti en Unicode en utilisant la fonction fromAscii().

Vous pouvez d�sactiver cette fonction en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de votre application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::append ( const char * str )

Cette fonction surcharge append().

Ajoute la cha�ne str � cette cha�ne. Le pointeur sur caract�re constant est converti en Unicode en utilisant la fonction fromAscii().

Vous pouvez d�sactiver cette fonction en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de votre application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::append ( QChar ch )

Cette fonction surcharge append().

Ajoute le caract�re ch � cette cha�ne.

QString QString::arg ( const QString & a, int fieldWidth = 0, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Renvoie une copie de cette cha�ne avec le marqueur d'emplacement ayant le plus petit num�ro remplac� par la cha�ne a, c'est-�-dire %1, %2... %99.

fieldWidth sp�cifie l'espace minimum que l'argument a occupera. Si a requiert moins d'espace, elle est compl�t�e jusqu'� fieldWidth avec le caract�re fillChar. Un fieldWidth positif produit un texte align� � droite. Un fieldWidth n�gatif produit un texte align� � gauche.

Cet exemple montre une m�thode de cr�ation d'une cha�ne status pour informer de l'avancement de la copie d'une liste de fichiers :

QString i;           // num�ro du fichier courant
QString total;       // nombre de fichiers � traiter
QString fileName;    // nom du fichier courant
 
QString status = QString("Traitement du fichier %1 sur %2 : %3")
                .arg(i).arg(total).arg(fileName);

D'abord, arg(i) remplace %1. Ensuite arg(total) remplace %2. Enfin, arg(fileName) remplace %3.

Un avantage d'utiliser arg() plut�t que sprintf() est que l'ordre des marqueurs d'emplacement num�rot�s peut changer, si les cha�nes de l'application sont traduites dans d'autres langues, et arg() continuera � remplacer le marqueur non remplac� de plus petit num�ro, quel que soit l'endroit o� il appara�t. De plus, si le marqueur %i appara�t plus d'une fois dans la cha�ne, arg() les remplacera tous.

S'il ne reste plus de marqueur non remplac�, un message d'avertissement est �mis et le r�sultat est ind�fini. Les marqueurs doivent �tre dans la plage 1 � 99.

QString QString::arg ( const QString & a1, const QString & a2 ) const

Cette fonction surcharge arg().

Elle fait la m�me chose que str.arg(a1).arg(a2), � part que les cha�nes a1 et a2 sont remplac�es d'un seul coup. Le r�sultat peut �tre diff�rent par exemple si a1 contient %1 :

QString str;
str = "%1 %2";
 
str.arg("%1f", "Hello");        // renvoie "%1f Hello"
str.arg("%1f").arg("Hello");    // renvoie "Hellof %2"

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3 ) const

Cette fonction surcharge arg().

Elle fait la m�me chose que str.arg(a1).arg(a2).arg(a3), � part que les cha�nes a1, a2 et a3 sont remplac�es d'un seul coup.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4 ) const

Cette fonction surcharge arg().

Elle fait la m�me chose que str.arg(a1).arg(a2).arg(a3).arg(a4), � part que les cha�nes a1, a2, a3 et a4 sont remplac�es d'un seul coup.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5 ) const

Cette fonction surcharge arg().

Elle fait la m�me chose que str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5), � part que les cha�nes a1, a2, a3, a4 et a5 sont remplac�es d'un seul coup.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6 ) const

Cette fonction surcharge arg().

Elle fait la m�me chose que str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6)), � part que les cha�nes a1, a2, a3, a4, a5 et a6 sont remplac�es d'un seul coup.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7 ) const

Cette fonction surcharge arg().

Elle fait la m�me chose que str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7), � part que les cha�nes a1, a2, a3, a4, a5, a6 et a7 sont remplac�es d'un seul coup.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7, const QString & a8 ) const

Cette fonction surcharge arg().

Elle fait la m�me chose que str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7).arg(a8), � part que les cha�nes a1, a2, a3, a4, a5, a6, a7 et a8 sont remplac�es d'un seul coup.

QString QString::arg ( const QString & a1, const QString & a2, const QString & a3, const QString & a4, const QString & a5, const QString & a6, const QString & a7, const QString & a8, const QString & a9 ) const

Cette fonction surcharge arg().

Elle fait la m�me chose que str.arg(a1).arg(a2).arg(a3).arg(a4).arg(a5).arg(a6).arg(a7).arg(a8).arg(a9), � part que les cha�nes a1, a2, a3, a4, a5, a6, a7, a8 et a9 sont remplac�es d'un seul coup.

QString QString::arg ( int a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

L'argument a est exprim� en base base, qui vaut 10 par d�faut et peut valoir entre 2 et 36. Pour les bases autres que 10, a est trait� comme un entier non sign�.

fieldWidth sp�cifie l'espace minimum occup� par a, qui est �ventuellement compl�t� avec le caract�re de remplissage fillChar. Une valeur positive produit un texte align� � droite, une valeur n�gative produit un texte align� � gauche.

Le symbole % peut �tre suivi par un L, auquel cas la s�quence est remplac�e par une repr�sentation localis�e de a. La conversion utilise la localisation par d�faut, fix�e par QLocale::setDefault(). Si aucune localisation par d�faut n'a �t� sp�cifi�e, la localisation « C » sera utilis�e. Le drapeau L est ignor� si base est diff�rente de 10.

QString str;
str = QString("63 en d�cimal vaut %1 en hexad�cimal")
        .arg(63, 0, 16);
// str == "63 en d�cimal vaut 3f en hexad�cimal"
 
 QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
     str = QString("%1 %L2 %L3")
        .arg(12345)
        .arg(12345)
        .arg(12345, 0, 16);
// str == "12345 12,345 3039"

Si fillChar vaut   (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

QString QString::arg ( uint a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

L'argument base sp�cifie la base � utiliser pour la conversion de l'entier a en cha�ne de caract�res. La base doit �tre comprise entre 2 et 36.

Si fillChar vaut 0 (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

QString QString::arg ( long a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

fieldWidth sp�cifie l'espace minimum occup� par a, qui est �ventuellement compl�t� avec le caract�re de remplissage fillChar. Une valeur positive produit un texte align� � droite, une valeur n�gative produit un texte align� � gauche.

L'argument a est exprim� en base base, qui vaut 10 par d�faut et peut valoir entre 2 et 36.

Le symbole % peut �tre suivi par un L, auquel cas la s�quence est remplac�e par une repr�sentation localis�e de a. La conversion utilise la localisation par d�faut. La localisation par d�faut est d�termin�e par les param�tres du syst�me au d�marrage de l'application, et peut �tre modifi�e avec QLocale::setDefault(). Le drapeau ‹L› est ignor� si base est diff�rente de 10.

QString str;
str = QString("63 en d�cimal vaut %1 en hexad�cimal")
        .arg(63, 0, 16);
// str == "63 en d�cimal vaut 3f en hexad�cimal"
 
QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString("%1 %L2 %L3")
        .arg(12345)
        .arg(12345)
        .arg(12345, 0, 16);
// str == "12345 12,345 3039"

Si fillChar vaut 0 (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

QString QString::arg ( ulong a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

fieldWidth sp�cifie l'espace minimum occup� par a, qui est �ventuellement compl�t� avec le caract�re de remplissage fillChar. Une valeur positive produit un texte align� � droite, une valeur n�gative produit un texte align� � gauche.

L'argument base sp�cifie la base � utiliser pour la conversion de l'entier a en cha�ne de caract�res. La base doit �tre comprise entre 2 et 36, avec 8 pour l'octal, 10 pour le d�cimal et 16 pour l'hexad�cimal.

Si fillChar vaut 0 (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

QString QString::arg ( qlonglong a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

fieldWidth sp�cifie l'espace minimum occup� par a, qui est �ventuellement compl�t� avec le caract�re de remplissage fillChar. Une valeur positive produit un texte align� � droite, une valeur n�gative produit un texte align� � gauche.

L'argument base sp�cifie la base � utiliser pour la conversion de l'entier a en cha�ne de caract�res. La base doit �tre comprise entre 2 et 36, avec 8 pour l'octal, 10 pour le d�cimal et 16 pour l'hexad�cimal.

Si fillChar vaut 0 (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

QString QString::arg ( qulonglong a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

fieldWidth sp�cifie l'espace minimum occup� par a, qui est �ventuellement compl�t� avec le caract�re de remplissage fillChar. Une valeur positive produit un texte align� � droite, une valeur n�gative produit un texte align� � gauche.

L'argument base sp�cifie la base � utiliser pour la conversion de l'entier a en cha�ne de caract�res. La base doit �tre comprise entre 2 et 36, avec 8 pour l'octal, 10 pour le d�cimal et 16 pour l'hexad�cimal.

Si fillChar vaut 0 (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

QString QString::arg ( short a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

fieldWidth sp�cifie l'espace minimum occup� par a, qui est �ventuellement compl�t� avec le caract�re de remplissage fillChar. Une valeur positive produit un texte align� � droite, une valeur n�gative produit un texte align� � gauche.

L'argument base sp�cifie la base � utiliser pour la conversion de l'entier a en cha�ne de caract�res. La base doit �tre comprise entre 2 et 36, avec 8 pour l'octal, 10 pour le d�cimal et 16 pour l'hexad�cimal.

Si fillChar vaut 0 (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

QString QString::arg ( ushort a, int fieldWidth = 0, int base = 10, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

fieldWidth sp�cifie l'espace minimum occup� par a, qui est �ventuellement compl�t� avec le caract�re de remplissage fillChar. Une valeur positive produit un texte align� � droite, une valeur n�gative produit un texte align� � gauche.

L'argument base sp�cifie la base � utiliser pour la conversion de l'entier a en cha�ne de caract�res. La base doit �tre comprise entre 2 et 36, avec 8 pour l'octal, 10 pour le d�cimal et 16 pour l'hexad�cimal.

Si fillChar vaut 0 (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

QString QString::arg ( QChar a, int fieldWidth = 0, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

QString QString::arg ( char a, int fieldWidth = 0, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

L'argument a est interpr�t� comme un caract�re Latin-1.

QString QString::arg ( double a, int fieldWidth = 0, char format = ‹g›, int precision = -1, const QChar & fillChar = QLatin1Char( ' ' ) ) const

Cette fonction surcharge arg().

L'argument a est format� suivant le format et la pr�cision donn�s. Voir l'argument format pour plus de d�tails.

fieldWidth sp�cifie l'espace minimum occup� par a, qui est �ventuellement compl�t� avec le caract�re de remplissage fillChar. Une valeur positive produit un texte align� � droite, une valeur n�gative produit un texte align� � gauche.

double d = 12.34;
QString str = QString("delta: %1").arg(d, 0, 'E', 3);
// str == "delta: 1.234E+01"

Le symbole % peut �tre suivi par un L, auquel cas la s�quence est remplac�e par une repr�sentation localis�e de a. La conversion utilise la localisation par d�faut, fix�e par QLocale::setDefault(). Si aucune localisation par d�faut n'a �t� sp�cifi�e, la localisation « C » sera utilis�e.

Si fillChar vaut   (le nombre 0, de code ASCII 48), le z�ro local est utilis�. Pour les nombres n�gatifs, les z�ros de remplissage peuvent appara�tre avant le signe moins.

Voir aussi QLocale::toString().

const QChar QString::at ( int position ) const

Retourne le caract�re de la cha�ne situ� � l'index position donn�.

La position doit �tre une valeur d'index valide dans la cha�ne (c'est-�-dire 0 = position < size()).

Voir aussi operator[]().

iterator QString::begin ()

Renvoie un it�rateur de style STL pointant sur le premier caract�re de la cha�ne.

Voir aussi constBegin() et end().

const_iterator QString::begin () const

Cette fonction surcharge begin().

int QString::capacity () const

Renvoie le nombre maximal de caract�res pouvant �tre stock�s dans la cha�ne sans forcer une r�allocation.

Le seul int�r�t de cette fonction est de donner un moyen de g�rer finement l'utilisation de la m�moire par QString. En g�n�ral, vous devrez rarement l'appeler. Si vous voulez conna�tre le nombre de caract�res de la cha�ne, appelez size().

Voir aussi reserve() et squeeze().

void QString::chop ( int n )

Retire n caract�res � partir de la fin de la cha�ne.

Si n est plus grand que size(), le r�sultat est une cha�ne vide.

Exemple :

QString str("LOGOUT\r\n");
str.chop(2);
// str == "LOGOUT"

Si vous voulez retirer des caract�res depuis le d�but de la cha�ne, utilisez remove().

Voir aussi truncate(), resize() et remove().

void QString::clear ()

Supprime le contenu de la cha�ne, qui devient une cha�ne vide.

Voir aussi resize() et isEmpty().

int QString::compare ( const QString & s1, const QString & s2, Qt::CaseSensitivity cs ) [static]

Compare s1 avec s2 et renvoie un entier plus petit que, �gal � ou plus grand que z�ro, suivant que s1 est plus petite que, �gale � ou plus grande que s2.

Si cs est Qt::CaseSensitive, la comparaison est sensible � la casse ; sinon, elle est insensible � la casse.

La comparaison sensible � la casse est bas�e exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ne correspond pas � ce qu'un humain attend. Triez les cha�nes visibles par l'utilisateur de pr�f�rence avec localeAwareCompare().

=int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0
int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0
int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi operator==(), operator<() et operator>().

int QString::compare ( const QString & s1, const QString & s2 ) [static]

Cette fonction surcharge compare().

Effectue une comparaison sensible � la casse de s1 et de s2.

int QString::compare ( const QString & s1, const QLatin1String & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive ) [static]

Cette fonction surcharge compare().

Effectue une comparaison de s1 et de s2 en utilisant le param�tre de sensibilit� � la casse cs.

Cette fonction a �t� introduite dans Qt 4.2.

int QString::compare ( const QLatin1String & s1, const QString & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive ) [static]

Cette fonction surcharge compare().

Effectue une comparaison de s1 et de s2 en utilisant le param�tre de sensibilit� � la casse cs.

Cette fonction a �t� introduite dans Qt 4.2.

int QString::compare ( const QString & other ) const

Cette fonction surcharge compare().

Compare lexicalement cette cha�ne avec la cha�ne other et renvoie un entier plus petit que, �gal � ou plus grand que z�ro suivant que cette cha�ne est plus petite que, �gale � ou plus grande que la cha�ne other.

�quivalent � compare(*this, other).

int QString::compare ( const QString & other, Qt::CaseSensitivity cs ) const

Cette fonction surcharge compare().

Identique � compare(*this, other, cs).

Cette fonction a �t� introduite dans Qt 4.2.

int QString::compare ( const QLatin1String & other, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge compare().

Identique � compare(*this, other, cs).

Cette fonction a �t� introduite dans Qt 4.2.

int QString::compare ( const QStringRef & ref, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge compare().

Compare cette cha�ne avec ref, r�f�rence � une cha�ne, et renvoie un entier plus petit que, �gal � ou plus grand que z�ro suivant que cette cha�ne est plus petite que, �gale � ou plus grande que ref.

int QString::compare ( const QString & s1, const QStringRef & s2, Qt::CaseSensitivity cs = Qt::CaseSensitive ) [static]

Cette fonction surcharge compare().

const_iterator QString::constBegin () const

Renvoie un it�rateur de style STL constant pointant sur le premier caract�re de la cha�ne.

Voir aussi begin() et constEnd().

const QChar * QString::constData () const

Renvoie un pointeur sur les donn�es stock�es dans la QString. Le pointeur peut �tre utilis� pour acc�der aux caract�res composant la cha�ne. Pour en faciliter l'usage, les donn�es sont termin�es par un \0.

Notez que le pointeur reste valide tant que la cha�ne n'est pas modifi�e.

Voir aussi data() et operator[]().

const_iterator QString::constEnd () const

Renvoie un it�rateur de style STL constant pointant sur un �l�ment imaginaire situ� apr�s le dernier �l�ment de la liste.

Voir aussi constBegin() et end().

bool QString::contains ( const QString & str, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie true si cette cha�ne contient une occurrence de la cha�ne str; sinon renvoie false.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Exemple :

QString str = "Peter Pan";
str.contains("peter", Qt::CaseInsensitive);    // renvoie true

Voir aussi indexOf() et count().

bool QString::contains ( QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge contains().

Renvoie true si cette cha�ne contient une occurrence du caract�re ch ; sinon renvoie false.

bool QString::contains ( const QRegExp & rx ) const

Cette fonction surcharge contains().

Renvoie true si l'expression r�guli�re rx correspond � la cha�ne ; sinon renvoie false.

bool QString::contains ( QRegExp & rx ) const

Cette fonction surcharge contains().

Renvoie true si l'expression r�guli�re rx correspond � la cha�ne ; sinon renvoie false.

S'il y a correspondance, l'expression r�guli�re rx contiendra les captures trouv�es (voir QRegExp::matchedLength, QRegExp::cap).

Cette fonction a �t� introduite dans Qt 4.5.

int QString::count ( const QString & str, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie le nombre d'occurrences (avec des recouvrements �ventuels) de la cha�ne str dans cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Voir aussi contains() et indexOf().

int QString::count ( QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge count().

Renvoie le nombre d'occurrences du caract�re ch dans la cha�ne.

int QString::count ( const QRegExp & rx ) const

Cette fonction surcharge count().

Renvoie le nombre de correspondances de l'expression r�guli�re rx dans la cha�ne.

Cette fonction compte les correspondances y compris avec recouvrement, par exemple ci-dessous, on trouve quatre instances de « ana » ou « ama »:

QString str = "banana and panama";
str.count(QRegExp("a[nm]a"));    // renvoie 4

int QString::count () const

Cette fonction surcharge count().

Identique � size().

QChar * QString::data ()

Renvoie un pointeur sur les donn�es stock�es dans la QString. Le pointeur peut �tre utilis� pour acc�der aux caract�res composant la cha�ne et les modifier. Pour en faciliter l'usage, les donn�es sont termin�es par un \0.

Exemple :

QString str = "Hello world";
QChar *data = str.data();
while (!data->isNull()) {
    qDebug() << data->unicode();
    ++data;
}

Notez que le pointeur reste valide tant que la cha�ne n'est pas modifi�e par d'autres moyens. Pour un acc�s en lecture seule, constData() est � pr�f�rer car il ne d�clenche jamais de copie profonde.

Voir aussi constData() et operator[]().

const QChar * QString::data () const

Il s'agit d'une fonction surcharg�e.

iterator QString::end ()

Renvoie un it�rateur de style STL pointant sur un �l�ment imaginaire situ� apr�s le dernier �l�ment de la liste.

Voir aussi begin() et constEnd().

const_iterator QString::end () const

Cette fonction surcharge end().

bool QString::endsWith ( const QString & s, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie true si la cha�ne se termine par s ; sinon renvoie false.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

QString str = "Bananas";
str.endsWith("anas");         // renvoie true
str.endsWith("pple");         // renvoie false

Voir aussi startsWith().

bool QString::endsWith ( const QLatin1String & s, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge endsWith().

bool QString::endsWith ( const QChar & c, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie true si la cha�ne se termine par c ; sinon renvoie false.

Cette fonction surcharge endsWith().

QString & QString::fill ( QChar ch, int size = -1 )

Affecte la valeur ch � tous les caract�res de la cha�ne. Si size est diff�rente de -1 (la valeur par d�faut), la cha�ne est d'abord dimensionn�e � la taille size.

Exemple :

QString str = "Berlin";
str.fill('z');
// str == "zzzzzz"
 
str.fill('A', 2);
// str == "AA"

Voir aussi resize().

QString QString::fromAscii ( const char * str, int size = -1 ) [static]

Renvoie une QString initialis�e avec les size premiers caract�res de la cha�ne 8 bits str.

Si size vaut -1 (la valeur par d�faut), on utilise � sa place qstrlen(str).

Notez que, contrairement � ce que laisse imaginer son nom, cette fonction utilise en fait le codec d�fini par QTextCodec::setCodecForCStrings() pour convertir str en Unicode. En fonction du codec, elle peut ne pas accepter une entr�e US-ASCII (ANSI X3.4-1986) valide. Si aucun codec n'a �t� d�fini, cette fonction est �quivalente � fromLatin1().

Voir aussi toAscii(), fromLatin1(), fromUtf8() et fromLocal8Bit().

QString QString::fromLatin1 ( const char * str, int size = -1 ) [static]

Renvoie une QString initialis�e avec les size premiers caract�res de la cha�ne Latin-1 str.

Si size vaut -1 (la valeur par d�faut), on utilise � sa place qstrlen(str).

Voir aussi toLatin1(), fromAscii(), fromUtf8() et fromLocal8Bit().

QString QString::fromLocal8Bit ( const char * str, int size = -1 ) [static]

Renvoie une QString initialis�e avec les size premiers caract�res de la cha�ne 8 bits str.

Si size vaut -1 (la valeur par d�faut), on utilise � sa place qstrlen(str).

QTextCodec::codecForLocale() est utilis�e pour la conversion vers Unicode.

Voir aussi toLocal8Bit(), fromAscii(), fromLatin1() et fromUtf8().

QString QString::fromRawData ( const QChar * unicode, int size ) [static]

Construit une QString � partir des size premiers caract�res Unicode du tableau unicode. Les donn�es dans unicode ne sont pas copi�es. L'appelant doit �tre en mesure de garantir que l'argument unicode ne sera pas d�truit ou modifi� tant que la QString (ou une de ses copies non modifi�es) existe.

Toute tentative de modification de la QString ou d'une de ses copies entra�nera une copie profonde des donn�es, ce qui assure que les donn�es brutes ne sont jamais modifi�es.

Voici un exemple d'utilisation d'une QRegExp sur des donn�es brutes en m�moire en �vitant la copie des donn�es dans une QString :

QRegExp pattern;
static const QChar unicode[] = {
        0x005A, 0x007F, 0x00A4, 0x0060,
        0x1009, 0x0020, 0x0020};
int size = sizeof(unicode) / sizeof(QChar);
 
QString str = QString::fromRawData(unicode, size);
if (str.contains(QRegExp(pattern))) {
    // ...
}

Attention : une cha�ne cr��e avec fromRawData() n'est pas termin�e par un \0, sauf si les donn�es brutes contiennent un caract�re \0 � la position size. Cela signifie que la fonction unicode() ne renverra pas une cha�ne termin�e par un \0 (contrairement � ce que fait utf16(), mais au prix d'une copie des donn�es brutes).

Voir aussi fromUtf16() et setRawData().

QString QString::fromStdString ( const std::string & str ) [static]

Renvoie une copie de la cha�ne str. La cha�ne donn�e est convertie en Unicode en utilisant la fonction fromAscii().

Ce constructeur est disponible seulement si Qt est configur� avec la compatibilit� STL activ�e.

Voir aussi fromAscii(), fromLatin1(), fromLocal8Bit() et fromUtf8().

QString QString::fromStdWString ( const std::wstring & str ) [static]

Renvoie une copie de la cha�ne str. La cha�ne donn�e est suppos�e �tre encod�e en UTF 16 si la taille de wchar_t est de deux octets (par exemple sur Windows) et en UCS 4 si la taille de wchar_t est de quatre octets (sur la plupart des syst�mes Unix).

Ce constructeur est disponible seulement si Qt est configur� avec la compatibilit� STL activ�e.

Voir aussi fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8() et fromUcs4().

QString QString::fromUcs4 ( const uint * unicode, int size = -1 ) [static]

Renvoie une QString initialis�e avec les size premiers caract�res de la cha�ne Unicode unicode (en encodage ISO-10646-UCS-4).

Si size vaut -1 (la valeur par d�faut), on utilise � sa place qstrlen(str).

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi toUcs4(), fromUtf16(), utf16(), setUtf16() et fromWCharArray().

QString QString::fromUtf8 ( const char * str, int size = -1 ) [static]

Renvoie une QString initialis�e avec les size premiers caract�res de la cha�ne UTF-8 str.

Si size vaut -1 (la valeur par d�faut), on utilise � sa place qstrlen(str).

UTF-8 est un codec Unicode et peut repr�senter tous les caract�res d'une cha�ne Unicode comme le fait QString. Cependant, des s�quences invalides sont possibles en UTF-8 ; les s�quences invalides d�tect�es seront remplac�es par un ou plusieurs « caract�res de remplacement » ou supprim�es. Cela inclut les s�quences non Unicode, les non-caract�res, les s�quences trop longues ou les points de code de demi-zone encod�s en UTF-8.

Les non-caract�res sont des points de code que le standard Unicode r�serve et qui ne doivent pas �tre utilis�s dans l'�change de texte. Ce sont les deux derniers points de code de chaque plan Unicode (U+FFFE, U+FFFF, U+1FFFE, U+1FFFF, U+2FFFE, etc.), ainsi que les 16 points de code dans la plage U+FDD0..U+FDDF (inclus).

Voir aussi toUtf8(), fromAscii(), fromLatin1() et fromLocal8Bit().

QString QString::fromUtf16 ( const ushort * unicode, int size = -1 ) [static]

Renvoie une QString initialis�e avec les size premiers caract�res de la cha�ne Unicode unicode (encod�e en ISO-10646-UTF-16).

Si size vaut -1 (la valeur par d�faut), unicode doit �tre termin�e par un 0.

Cette fonction v�rifie la pr�sence d'un BOM (Byte Order Mark ou Marqueur d'Ordre des Octets). S'il est absent, elle utilise l'ordre du syst�me h�te.

Cette fonction est lente compar�e aux autres conversions Unicode. Utilisez de pr�f�rence QString(const QChar *, int) ou QString(const QChar *).

QString effectue une copie profonde des donn�es Unicode.

Voir aussi utf16() et setUtf16().

QString QString::fromWCharArray ( const wchar_t * string, int size = -1 ) [static]

Renvoie une copie de string, avec une interpr�tation de l'encodage de string d�pendant de la taille de wchar. Si wchar est cod� sur quatre octets, string est interpr�t�e en UCS-4 ; sur deux octets, elle est interpr�t�e en UCS-2.

Si size vaut -1 (la valeur par d�faut), string doit �tre termin�e par un 0.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi fromUtf16(), fromLatin1(), fromLocal8Bit(), fromUtf8(), fromUcs4() et fromStdWString().

int QString::indexOf ( const QString & str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie la position de la premi�re occurrence de la cha�ne str dans cette cha�ne, en recherchant vers la fin de la cha�ne depuis la position from. Renvoie -1 si str n'est pas trouv�e.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Exemple :

QString x = "sticky question";
QString y = "sti";
x.indexOf(y);               // renvoie 0
x.indexOf(y, 1);            // renvoie 10
x.indexOf(y, 10);           // renvoie 10
x.indexOf(y, 11);           // renvoie -1

Si from vaut -1, la recherche commence au dernier caract�re ; s'il vaut -2, elle commence � l'avant-dernier caract�re et ainsi de suite.

Voir aussi lastIndexOf(), contains() et count().

int QString::indexOf ( const QLatin1String & str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie la position de la premi�re occurrence de la cha�ne str dans cette cha�ne, en recherchant vers la fin de la cha�ne depuis la position from. Renvoie -1 si str n'est pas trouv�e.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Exemple :

QString x = "sticky question";
QString y = "sti";
x.indexOf(y);               // renvoie 0
x.indexOf(y, 1);            // renvoie 10
x.indexOf(y, 10);           // renvoie 10
x.indexOf(y, 11);           // renvoie -1

Si from vaut -1, la recherche commence au dernier caract�re ; s'il vaut -2, elle commence � l'avant-dernier caract�re et ainsi de suite.

Cette fonction a �t� introduite dans Qt 4.5.

Voir aussi lastIndexOf(), contains() et count().

int QString::indexOf ( QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge indexOf().

Renvoie la position de la premi�re occurrence du caract�re ch dans cette cha�ne, en recherchant vers la fin de la cha�ne depuis la position from. Renvoie -1 si ch n'est pas trouv�.

int QString::indexOf ( const QRegExp & rx, int from = 0 ) const

Cette fonction surcharge indexOf().

Renvoie la position de la premi�re correspondance de l'expression r�guli�re rx dans cette cha�ne, en recherchant vers la fin de la cha�ne depuis la position from. Renvoie -1 si aucune correspondance n'est trouv�e.

Exemple :

QString str = "the minimum";
str.indexOf(QRegExp("m[aeiou]"), 0);       // renvoie 4

int QString::indexOf ( QRegExp & rx, int from = 0 ) const

Cette fonction surcharge indexOf().

Renvoie la position de la premi�re correspondance de l'expression r�guli�re rx dans cette cha�ne, en recherchant vers la fin de la cha�ne depuis la position from. Renvoie -1 si aucune correspondance n'est trouv�e.

Si des correspondances sont trouv�es, l'expression r�guli�re rx contiendra les captures correspondantes (voir QRegExp::matchedLength, QRegExp::cap).

Exemple :

QString str = "the minimum";
str.indexOf(QRegExp("m[aeiou]"), 0);       // renvoie 4

Cette fonction a �t� introduite dans Qt 4.5.

QString & QString::insert ( int position, const QString & str )

Ins�re la cha�ne Latin-1 str � la position donn�e et renvoie une r�f�rence � la cha�ne.

Exemple :

QString str = "Meal";
str.insert(1, QString("ontr"));
// str == "Montreal"

Si la position donn�e est plus grande que size(), le tableau est d'abord �tendu en utilisant resize().

Voir aussi append(), prepend(), replace() et remove().

QString & QString::insert ( int position, const QLatin1String & str )

Cette fonction surcharge insert().

Ins�re la cha�ne Latin-1 str � la position donn�e.

QString & QString::insert ( int position, const QChar * unicode, int size )

Cette fonction surcharge insert().

Ins�re les premiers size caract�res du tableau de QChar array unicode � la position donn�e.

QString & QString::insert ( int position, QChar ch )

Cette fonction surcharge insert().

Ins�re ch � la position donn�e dans la cha�ne.

bool QString::isEmpty () const

Renvoie true si la cha�ne ne contient pas de caract�re ; sinon renvoie false.

Exemple :

QString().isEmpty();            // renvoie true
QString("").isEmpty();          // renvoie true
QString("x").isEmpty();         // renvoie false
QString("abc").isEmpty();       // renvoie false

Voir aussi size().

bool QString::isNull () const

Renvoie true si cette cha�ne est nulle ; sinon renvoie false.

Exemple :

QString().isNull();             // renvoie true
QString("").isNull();           // renvoie false
QString("abc").isNull();        // renvoie false

Qt fait une distinction entre les cha�nes nulles et les cha�nes vides pour des raisons historiques. Pour la plupart des applications, ce qui compte est de savoir si la cha�ne contient des donn�es ou pas, et cela peut �tre d�termin� en utilisant la fonction isEmpty().

Voir aussi isEmpty().

bool QString::isRightToLeft () const

Renvoie true si la cha�ne se lit de droite � gauche.

int QString::lastIndexOf ( const QString & str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie la position de la premi�re occurrence de la cha�ne str dans cette cha�ne, en recherchant vers le d�but de la cha�ne depuis la position from. Si from vaut -1, la recherche commence au dernier caract�re ; s'il vaut -2, elle commence � l'avant-dernier caract�re et ainsi de suite. Renvoie -1 si str n'est pas trouv�e.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Exemple :

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // renvoie 6
x.lastIndexOf(y, 6);        // renvoie 6
x.lastIndexOf(y, 5);        // renvoie 2
x.lastIndexOf(y, 1);        // renvoie -1

Voir aussi indexOf(), contains() et count().

int QString::lastIndexOf ( const QLatin1String & str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie la position de la premi�re occurrence de la cha�ne str dans cette cha�ne, en recherchant vers le d�but de la cha�ne depuis la position from. Si from vaut -1, la recherche commence au dernier caract�re ; s'il vaut -2, elle commence � l'avant-dernier caract�re et ainsi de suite. Renvoie -1 si str n'est pas trouv�e.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Exemple :

QString x = "crazy azimuths";
QString y = "az";
x.lastIndexOf(y);           // renvoie 6
x.lastIndexOf(y, 6);        // renvoie 6
x.lastIndexOf(y, 5);        // renvoie 2
x.lastIndexOf(y, 1);        // renvoie -1

Cette fonction a �t� introduite dans Qt 4.5.

Voir aussi indexOf(), contains() et count().

int QString::lastIndexOf ( QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge lastIndexOf().

Renvoie la position de la derni�re occurrence du caract�re ch dans cette cha�ne, en recherchant vers le d�but de la cha�ne depuis la position from.

int QString::lastIndexOf ( const QRegExp & rx, int from = -1 ) const

Cette fonction surcharge lastIndexOf().

Renvoie la position de la derni�re occurrence de l'expression r�guli�re rx dans cette cha�ne, en recherchant vers le d�but de la cha�ne depuis la position from. Renvoie -1 si aucune correspondance avec rx n'est trouv�e.

Exemple :

QString str = "the minimum";
str.lastIndexOf(QRegExp("m[aeiou]"));      // renvoie 8

int QString::lastIndexOf ( QRegExp & rx, int from = -1 ) const

Cette fonction surcharge lastIndexOf().

Renvoie la position de la derni�re occurrence de l'expression r�guli�re rx dans cette cha�ne, en recherchant vers le d�but de la cha�ne depuis la position from. Renvoie -1 si aucune correspondance avec rx n'est trouv�e.

Si des correspondances sont trouv�es, l'expression r�guli�re rx contiendra les captures correspondantes (voir QRegExp::matchedLength, cap|QRegExp::cap]]).

Exemple :

QString str = "the minimum";
str.lastIndexOf(QRegExp("m[aeiou]"));      // renvoie 8

Cette fonction a �t� introduite dans Qt 4.5.

QString QString::left ( int n ) const

Renvoie une sous-cha�ne contenant les n caract�res de gauche de la cha�ne.

Si n est plus grand que size() ou inf�rieur � z�ro, elle renvoie la cha�ne enti�re.

QString x = "T�l�vision";
QString y = x.left(4);      // y == "T�l�"

Voir aussi right(), mid() et startsWith().

QString QString::leftJustified ( int width, QChar fill = QLatin1Char( ' ' ), bool truncate = false ) const

Renvoie une cha�ne de taille width contenant cette cha�ne compl�t�e par le caract�re de remplissage fill.

Si truncate est faux et que la taille de la cha�ne est plus grande que width, la fonction renvoie une copie de la cha�ne.

QString s = "apple";
QString t = s.leftJustified(8, '.');    // t == "apple..."

Si truncate est vrai et que la taille de la cha�ne est plus grande que width, les caract�res de la copie de la cha�ne situ�s apr�s la position width sont supprim�s et cette copie est renvoy�e.

QString str = "T�l�vision";
str = str.leftJustified(5, '.', true);    // str == "T�l�v"

Voir aussi rightJustified().

QStringRef QString::leftRef ( int n ) const

Renvoie une r�f�rence de sous-cha�ne sur les n caract�res de gauche de la cha�ne.

Si n est plus grand que size() ou inf�rieur � z�ro, elle renvoie une r�f�rence � la cha�ne enti�re.

QString x = "T�l�vision";
QStringRef y = x.leftRef(4);        // y == "T�l�"

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi left(), rightRef(), midRef() et startsWith().

int QString::length () const

Renvoie le nombre de caract�res dans la cha�ne. �quivalent � size().

Voir aussi setLength().

int QString::localeAwareCompare ( const QString & s1, const QString & s2 ) [static]

Compare la cha�ne s1 avec s2 et renvoie un entier plus petit que, �gal � ou plus grand que z�ro suivant que s1 est plus petite que, �gale � ou plus grande que s2.

La comparaison est effectu�e en tenant compte de la localisation et de la plateforme. Utilisez cette fonction pour la pr�sentation de cha�nes tri�es � l'utilisateur.

Sur Mac OS X depuis Qt 4.3, cette fonction compare en utilisant le param�tre « Ordre des listes tri�es » dans le panneau des pr�f�rences internationales.

Voir aussi compare() et QTextCodec::locale().

int QString::localeAwareCompare ( const QStringRef & other ) const

Cette fonction surcharge localeAwareCompare().

Compare cette cha�ne avec la cha�ne other et renvoie un entier plus petit que, �gal � ou plus grand que z�ro suivant que cette cha�ne est plus petite que, �gale � ou plus grande que la cha�ne other.

La comparaison est effectu�e en tenant compte de la localisation et de la plateforme. Utilisez cette fonction pour la pr�sentation de cha�nes tri�es � l'utilisateur.

Identique � localeAwareCompare(*this, other).

Cette fonction a �t� introduite dans Qt 4.5.

int QString::localeAwareCompare ( const QString & s1, const QStringRef & s2 ) [static]

Cette fonction surcharge localeAwareCompare().

Compare la cha�ne s1 avec s2 et renvoie un entier plus petit que, �gal � ou plus grand que z�ro suivant que s1 est plus petite que, �gale � ou plus grande que s2.

La comparaison est effectu�e en tenant compte de la localisation et de la plateforme. Utilisez cette fonction pour la pr�sentation de cha�nes tri�es � l'utilisateur.

Cette fonction a �t� introduite dans Qt 4.5.

int QString::localeAwareCompare ( const QString & other ) const

Cette fonction surcharge localeAwareCompare().

Compare cette cha�ne avec la cha�ne other et renvoie un entier plus petit que, �gal � ou plus grand que z�ro suivant que cette cha�ne est plus petite que, �gale � ou plus grande que la cha�ne other.

La comparaison est effectu�e en tenant compte de la localisation et de la plateforme. Utilisez cette fonction pour la pr�sentation de cha�nes tri�es � l'utilisateur.

Identique � localeAwareCompare(*this, other).

QString QString::mid ( int position, int n = -1 ) const

Renvoie une cha�ne contenant n caract�res de cette cha�ne, en commen�ant � la position sp�cifi�e.

Renvoie une cha�ne nulle si position d�passe la longueur de la cha�ne. S'il y a moins de n caract�res dans la cha�ne � partir de la position donn�e ou si n vaut -1 (la valeur par d�faut), la fonction renvoie tous les caract�res � partir de la position sp�cifi�e.

Exemple :

QString x = "Neuf ananas";
QString y = x.mid(5, 4);            // y == "anan"
QString z = x.mid(5);               // z == "ananas"

Voir aussi left() et right().

QStringRef QString::midRef ( int position, int n = -1 ) const

Renvoie une r�f�rence � une sous-cha�ne contenant n caract�res de cette cha�ne, en commen�ant � la position sp�cifi�e.

Renvoie une r�f�rence vide si position d�passe la longueur de la cha�ne.

S'il y a moins de n caract�res dans la cha�ne � partir de la position donn�e ou si n vaut -1 (la valeur par d�faut), la fonction renvoie tous les caract�res � partir de la position sp�cifi�e.

Exemple :

QString x = "Neuf ananas";
QString y = x.mid(5, 4);            // y == "anan"
QString z = x.mid(5);               // z == "ananas"

Cette fonction a �t� introduite dans Qt 4.4.

Voir aussi mid(), leftRef() et rightRef().

QString QString::normalized ( NormalizationForm mode ) const

Renvoie la cha�ne dans le mode de normalisation Unicode mode.

QString QString::normalized ( NormalizationForm mode, QChar::UnicodeVersion version ) const

Il s'agit d'une fonction surcharg�e.

Renvoie la cha�ne dans le mode de normalisation Unicode mode, suivant la version sp�cifi�e du standard Unicode.

QString QString::number ( long n, int base = 10 ) [static]

Renvoie une cha�ne repr�sentant le nombre n dans la base sp�cifi�e.

La base est 10 par d�faut et doit �tre comprise entre 2 et 36. Pour les bases autres que 10, n est trait� comme un entier non sign�.

long a = 63;
QString s = QString::number(a, 16);             // s == "3f"
QString t = QString::number(a, 16).toUpper();     // t == "3F"

Voir aussi setNum().

QString QString::number ( double n, char format = ‹g›, int precision = 6 ) [static]

Renvoie une cha�ne repr�sentant le nombre n, format�e suivant le format et la pr�cision sp�cifi�s. Voir l'argument format pour plus de d�tails.

Contrairement � QLocale::toString(), cette fonction ne tient pas compte des param�tres r�gionaux de l'utilisateur.

Voir aussi setNum() et QLocale::toString().

QString QString::number ( ulong n, int base = 10 ) [static]

Il s'agit d'une fonction surcharg�e.

QString QString::number ( int n, int base = 10 ) [static]

Il s'agit d'une fonction surcharg�e.

QString QString::number ( uint n, int base = 10 ) [static]

Il s'agit d'une fonction surcharg�e.

QString QString::number ( qlonglong n, int base = 10 ) [static]

Il s'agit d'une fonction surcharg�e.

QString QString::number ( qulonglong n, int base = 10 ) [static]

Il s'agit d'une fonction surcharg�e.

QString & QString::prepend ( const QString & str )

Ajoute la cha�ne str en t�te de cette cha�ne et renvoie une r�f�rence � la cha�ne.

Exemple :

QString x = "ship";
QString y = "air";
x.prepend(y);
// x == "airship"

Voir aussi append() et insert().

QString & QString::prepend ( const QLatin1String & str )

Cette fonction surcharge prepend().

Ajoute la cha�ne Latin-1 str en t�te de cette cha�ne

QString & QString::prepend ( const QByteArray & ba )

Cette fonction surcharge prepend().

Ajoute le tableau d'octets ba en t�te de cette cha�ne. Le tableau d'octets est converti en Unicode en utilisant la fonction fromAscii().

Vous pouvez d�sactiver cette fonction en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de votre application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::prepend ( const char * str )

Cette fonction surcharge prepend().

Ajoute la cha�ne str en t�te de cette cha�ne. Le pointeur const char est converti en Unicode en utilisant la fonction fromAscii().

Vous pouvez d�sactiver cette fonction en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de votre application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::prepend ( QChar ch )

Cette fonction surcharge prepend().

Ajoute le caract�re ch au d�but de cette cha�ne.

void QString::push_back ( const QString & other )

Cette fonction est fournie pour la compatibilit� avec la STL, elle ajoute la cha�ne other donn�e � la fin de cette cha�ne. Elle est �quivalente � append(other).

Voir aussi append().

void QString::push_back ( QChar ch )

Il s'agit d'une fonction surcharg�e.

Ajoute le caract�re ch � la fin de cette cha�ne.

void QString::push_front ( const QString & other )

Cette fonction est fournie pour la compatibilit� avec la STL, elle ajoute la cha�ne other donn�e au d�but de cette cha�ne. Elle est �quivalente � prepend(other).

Voir aussi prepend().

void QString::push_front ( QChar ch )

Il s'agit d'une fonction surcharg�e.

Ajoute le caract�re ch au d�but de cette cha�ne.

QString & QString::remove ( int position, int n )

Supprime n caract�res de la cha�ne, en commen�ant � la position donn�e, et renvoie une r�f�rence � la cha�ne.

Si la position sp�cifi�e est � l'int�rieur de la cha�ne mais que position + n est au-del� de la fin de la cha�ne, la cha�ne est tronqu�e � partir de position.

QString s = "Montreal";
s.remove(1, 4);
// s == "Meal"

Voir aussi insert() et replace().

QString & QString::remove ( QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Supprime toutes les occurrences du caract�re ch dans cette cha�ne et renvoie une r�f�rence � la cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Exemple :

QString t = "Ali Baba";
t.remove(QChar('a'), Qt::CaseInsensitive);
// t == "li Bb"

�quivalent � replace(ch,  » », cs).

Voir aussi replace().

QString & QString::remove ( const QString & str, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Supprime toutes les occurrences de la cha�ne str dans cette cha�ne et renvoie une r�f�rence � la cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

�quivalent � replace(ch, "", cs).

Voir aussi replace().

QString & QString::remove ( const QRegExp & rx )

Supprime toutes les occurrences de l'expression r�guli�re rx dans cette cha�ne et renvoie une r�f�rence � la cha�ne. Par exemple :

QString r = "Telephone";
r.remove(QRegExp("[aeiou]."));
// r == "The"

Voir aussi indexOf(), lastIndexOf() et replace().

QString QString::repeated ( int times ) const

Renvoie une copie de cette cha�ne r�p�t�e un nombre times de fois.

Si times est plus petit que 1, renvoie une cha�ne vide.

Exemple :

 QString str("ab");
 str.repeated(4);            // renvoie "abababab"

Cette fonction a �t� introduite dans Qt 4.5.

QString & QString::replace ( int position, int n, const QString & after )

Remplace n caract�res en commen�ant � l'indice position par la cha�ne after et renvoie une r�f�rence � cette cha�ne.

Exemple :

QString x = "Say yes!";
QString y = "no";
x.replace(4, 3, y);
// x == "Say no!"

Voir aussi insert() et remove().

QString & QString::replace ( int position, int n, const QChar * unicode, int size )

Cette fonction surcharge replace().

Remplace n caract�res en commen�ant � l'indice position par les size premiers caract�res du tableau de QChar unicode et renvoie une r�f�rence � cette cha�ne.

QString & QString::replace ( int position, int n, QChar after )

Cette fonction surcharge replace().

Remplace n caract�res en commen�ant � l'indice position par le caract�re after et renvoie une r�f�rence � cette cha�ne.

QString & QString::replace ( const QString & before, const QString & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Cette fonction surcharge replace().

Remplace toutes les occurrences de la cha�ne before par la cha�ne after et renvoie une r�f�rence � cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Exemple :

QString str = "colour behaviour flavour neighbour";
str.replace(QString("ou"), QString("o"));
// str == "color behavior flavor neighbor"

Note : le texte de remplacement n'est pas relu apr�s son insertion.

Exemple :

QString equis = "xxxxxx";
equis.replace("xx", "x");
// equis == "xxx"

QString & QString::replace ( const QChar * before, int blen, const QChar * after, int alen, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Cette fonction surcharge replace().

Remplace toutes les occurrences des premiers blen caract�res de before avec les premiers alen caract�res de after et renvoie une r�f�rence � cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Cette fonction a �t� introduite dans Qt 4.5.

QString & QString::replace ( QChar ch, const QString & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Cette fonction surcharge replace().

Remplace toutes les occurrences du caract�re ch dans la cha�ne par after et renvoie une r�f�rence � cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

QString & QString::replace ( QChar before, QChar after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Cette fonction surcharge replace().

Remplace toutes les occurrences du caract�re before par le caract�re after et renvoie une r�f�rence � cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

QString & QString::replace ( const QLatin1String & before, const QLatin1String & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Cette fonction surcharge replace().

Remplace toutes les occurrences de la cha�ne before par la cha�ne after et renvoie une r�f�rence � cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Note : le texte n'est pas relu apr�s un remplacement.

Cette fonction a �t� introduite dans Qt 4.5.

QString & QString::replace ( const QLatin1String & before, const QString & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Cette fonction surcharge replace().

Remplace toutes les occurrences de la cha�ne before par la cha�ne after et renvoie une r�f�rence � cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Note : le texte n'est pas relu apr�s un remplacement.

Cette fonction a �t� introduite dans Qt 4.5.

QString & QString::replace ( const QString & before, const QLatin1String & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Cette fonction surcharge replace().

Remplace toutes les occurrences de la cha�ne before par la cha�ne after et renvoie une r�f�rence � cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Note : le texte n'est pas relu apr�s un remplacement.

Cette fonction a �t� introduite dans Qt 4.5.

QString & QString::replace ( QChar c, const QLatin1String & after, Qt::CaseSensitivity cs = Qt::CaseSensitive )

Cette fonction surcharge replace().

Remplace toutes les occurrences du caract�re c avec la cha�ne after et renvoie une r�f�rence � cette cha�ne.

Si cs est Qt::CaseSensitive (la valeur par d�faut), la recherche est sensible � la casse ; sinon elle est insensible � la casse.

Note : le texte n'est pas relu apr�s un remplacement.

Cette fonction a �t� introduite dans Qt 4.5.

QString & QString::replace ( const QRegExp & rx, const QString & after )

Cette fonction surcharge replace().

Remplace toutes les occurrences de l'expression r�guli�re rx par after et renvoie une r�f�rence � la cha�ne. Par exemple :

QString s = "Banana";
s.replace(QRegExp("a[mn]"), "ox");
// s == "Boxoxa"

Pour les expressions r�guli�res contenant des parenth�ses de capture, les occurrences de \1, \2, ..., dans after sont remplac�es par rx.cap(1), cap(2)...

QString t = "A <i>bon mot</i>.";
t.replace(QRegExp("<i>([^<]*)</i>"), "\\emph{\\1}");
// t == "A \\emph{bon mot}."

Voir aussi indexOf(), lastIndexOf(), remove() et QRegExp::cap().

void QString::reserve ( int size )

Tente une r�servation de m�moire pour au moins size caract�res. Si vous savez � l'avance quelle sera la taille maximale de la cha�ne, en appelant cette fonction vous pouvez esp�rer am�liorer les performances dans le cas o� vous changez souvent la taille de la cha�ne. Si size est une sous-estimation, dans le pire des cas la QString sera un peu plus lente.

Le seul but de cette fonction est de permettre une gestion fine de l'usage m�moire de QString. En g�n�ral, vous aurez rarement � appeler cette fonction. Si vous voulez changer la taille de la cha�ne, appelez resize().

Cette fonction est utile pour du code devant construire une longue cha�ne et voulant �viter des allocations r�p�t�es. Dans cet exemple, nous ajoutons des caract�res � la cha�ne jusqu'� ce qu'une condition soit vraie et nous estimons que la taille est assez grande pour que l'appel � reserve() soit rentable :

QString result;
int maxSize;
bool condition;
QChar nextChar;
 
result.reserve(maxSize);
 
while (condition)
    result.append(nextChar);
 
result.squeeze();

Voir aussi squeeze() et capacity().

void QString::resize ( int size )

Fixe la taille de la cha�ne � size caract�res.

Si size est plus grande que la taille courante, la cha�ne est �tendue pour la passer � size caract�res de long, avec les caract�res suppl�mentaires ajout�s en fin de cha�ne. Les nouveaux caract�res ne sont pas initialis�s.

Si size est inf�rieure � la taille courante, des caract�res sont supprim�s � partir de la fin.

Exemple :

QString s = "Hello world";
s.resize(5);
// s == "Hello"
 
s.resize(8);
// s == "Hello???" (o� ? repr�sente des caract�res quelconques)

Si vous voulez ajouter un certain nombre de caract�res identiques � la cha�ne, utilisez operator+=() de la fa�on suivante, plut�t que resize() :

QString t = "Hello";
t += QString(10, 'X');
// t == "HelloXXXXXXXXXX"

Si vous voulez �tendre la cha�ne jusqu'� une certaine longueur et remplir les nouvelles positions avec un caract�re particulier, utilisez la fonction leftJustified() :

QString r = "Hello";
r = r.leftJustified(10, ' ');
// r == "Hello     "

Passer une size n�gative est �quivalent � passer z�ro.

Voir aussi truncate() et reserve().

QString QString::right ( int n ) const

Renvoie une sous-cha�ne contenant les n caract�res de droite de la cha�ne.

Si n est plus grand que size() ou inf�rieur � z�ro, la fonction renvoie la cha�ne enti�re.

QString x = "Pamplemousse";
QString y = x.right(6);      // y == "mousse"

Voir aussi left(), mid() et endsWith().

QString QString::rightJustified ( int width, QChar fill = QLatin1Char( ' ' ), bool truncate = false ) const

Renvoie une cha�ne dont la taille est width contenant le caract�re de remplissage fill suivi de la cha�ne d'origine. Par exemple :

QString s = "pomme";
QString t = s.rightJustified(8, '.');    // t == "...pomme"

Si truncate est faux et que la taille de la cha�ne est sup�rieure � width, la cha�ne renvoy�e sera une copie de la cha�ne.

Si truncate est vrai et que la taille de la cha�ne est sup�rieure � width, la cha�ne renvoy�e sera tronqu�e � la position width.

QString str = "Pamplemousse";
str = str.rightJustified(5, '.', true);    // str == "Pampl"

Voir aussi leftJustified().

QStringRef QString::rightRef ( int n ) const

Renvoie une r�f�rence � une sous-cha�ne contenant les n caract�res de droite de la cha�ne.

Si n est plus grand que size() ou inf�rieur � z�ro, la fonction renvoie une r�f�rence � la cha�ne enti�re.

QString x = "Pamplemousse";
QStringRef y = x.right(6);      // y == "mousse"

Voir aussi right(), leftRef(), midRef() et endsWith().

QString QString::section ( QChar sep, int start, int end = -1, SectionFlags flags = SectionDefault ) const

Cette fonction renvoie une section de la cha�ne.

La cha�ne est trait�e comme une s�quence de champs s�par�s par le caract�re sep. La cha�ne renvoy�e contient les champs de la position start � la position end incluse. Si end n'est pas sp�cifi�e, tous les champs depuis la position start jusqu'� la fin de la cha�ne sont inclus. Les champs sont num�rot�s 0, 1, 2... en comptant depuis la gauche et -1, -2... en comptant de droite � gauche.

L'argument flags peut �tre utilis� pour modifier le comportement de la fonction, par exemple la sensibilit� � la casse, ignorer ou pas les champs vides ou la fa�on de traiter les s�parateurs de d�but et de fin ; voir SectionFlags.

QString str;
QString csv = "forename,middlename,surname,phone";
QString path = "/usr/local/bin/myapp"; // Le premier champ est vide
QString::SectionFlag flag = QString::SectionSkipEmpty;
 
str = csv.section(',', 2, 2);   // str == "surname"
str = path.section('/', 3, 4);  // str == "bin/myapp"
str = path.section('/', 3, 3, flag); // str == "myapp"

Si start ou end sont n�gatifs, les champs sont compt�s depuis la droite de la cha�ne, le champ le plus � droite ayant le num�ro -1, le champ suivant � sa gauche le num�ro -2 et ainsi de suite.

str = csv.section(',', -3, -2);  // str == "middlename,surname"
str = path.section('/', -1); // str == "myapp"

Voir aussi split().

QString QString::section ( const QString & sep, int start, int end = -1, SectionFlags flags = SectionDefault ) const

Cette fonction surcharge section().

QString str;
QString data = "forename**middlename**surname**phone";
 
str = data.section("**", 2, 2); // str == "surname"
str = data.section("**", -3, -2); // str == "middlename**surname"

Voir aussi split().

QString QString::section ( const QRegExp & reg, int start, int end = -1, SectionFlags flags = SectionDefault ) const

Cette fonction surcharge section().

La cha�ne est trait�e comme une s�quence de champs s�par�s par l'expression r�guli�re reg.

QString line = "forename\tmiddlename  surname \t \t phone";
QRegExp sep("\\s+");
str = line.section(sep, 2, 2); // s == "surname"
str = line.section(sep, -3, -2); // s == "middlename  surname"

Attention : cette version QRegExp est beaucoup plus co�teuse que les versions caract�re et cha�ne.

Voir aussi split() et simplified().

QString & QString::setNum ( int n, int base = 10 )

Affecte � la cha�ne la valeur textuelle de n dans la base sp�cifi�e et renvoie une r�f�rence � la cha�ne.

La base est 10 par d�faut et doit �tre comprise entre 2 et 36. Pour les bases autres que 10, n est trait� comme un entier non sign�.

QString str;
str.setNum(1234);       // str == "1234"

Le formatage utilise toujours QLocale::C, c'est-�-dire, Anglais/USA. Pour obtenir une repr�sentation localis�e d'un nombre, utilisez QLocale::toString() avec la localisation appropri�e.

QString & QString::setNum ( uint n, int base = 10 )

Il s'agit d'une fonction surcharg�e.

QString & QString::setNum ( long n, int base = 10 )

Il s'agit d'une fonction surcharg�e.

QString & QString::setNum ( ulong n, int base = 10 )

Il s'agit d'une fonction surcharg�e.

QString & QString::setNum ( qlonglong n, int base = 10 )

Il s'agit d'une fonction surcharg�e.

QString & QString::setNum ( qulonglong n, int base = 10 )

Il s'agit d'une fonction surcharg�e.

QString & QString::setNum ( short n, int base = 10 )

Il s'agit d'une fonction surcharg�e.

QString & QString::setNum ( ushort n, int base = 10 )

Il s'agit d'une fonction surcharg�e.

QString & QString::setNum ( double n, char format = ‹g›, int precision = 6 )

Il s'agit d'une fonction surcharg�e.

Affecte � la cha�ne la valeur textuelle de n, format�e suivant format et precision, et renvoie une r�f�rence � la cha�ne.

Le format peut �tre f, F, e, E, g ou G (voir la documentation de la fonction arg() pour une explication des formats).

Contrairement � QLocale::toString(), cette fonction ne tient pas compte des param�tres r�gionaux de l'utilisateur.

QString & QString::setNum ( float n, char format = ‹g›, int precision = 6 )

Il s'agit d'une fonction surcharg�e.

Affecte � la cha�ne la valeur textuelle de n, format�e suivant format et precision, et renvoie une r�f�rence � la cha�ne.

QString & QString::setRawData ( const QChar * unicode, int size )

Demande � la QString de prendre comme contenu les size premiers caract�res Unicode du tableau unicode. Les donn�es de l'argument unicode ne sont pas copi�es. L'appelant doit pouvoir garantir que l'argument unicode ne sera pas supprim� ou modifi� tant que la QString (ou une de ses copies non modifi�es) existe.

Cette fonction peut �tre utilis�e � la place de fromRawData() pour r�utiliser des objets QString existants afin d'�conomiser des r�allocations de m�moire.

Cette fonction a �t� introduite dans Qt 4.7.

Voir aussi fromRawData().

QString & QString::setUnicode ( const QChar * unicode, int size )

Redimensionne la cha�ne � size caract�res et copie unicode dans la cha�ne.

Si unicode vaut 0, rien n'est copi� mais la cha�ne est quand m�me redimensionn�e � size.

Voir aussi unicode() et setUtf16().

QString & QString::setUtf16 ( const ushort * unicode, int size )

Redimensionne la cha�ne � size caract�res et copie unicode dans la cha�ne.

Si unicode vaut 0, rien n'est copi� mais la cha�ne est quand m�me redimensionn�e � size.

Notez que contrairement � fromUtf16(), cette fonction ne tient pas compte des BOM (Byte Order Mark) et de l'ordre des octets �ventuellement diff�rents.

Voir aussi utf16() et setUnicode().

QString QString::simplified () const

Renvoie une cha�ne dont les blancs de d�but et de fin ont �t� retir�s et dont chaque s�quence de blancs interne a �t� remplac�e par un espace simple.

Un blanc est d�fini comme un caract�re pour lequel QChar::isSpace() renvoie true, ce qui inclut les caract�res ASCII \t, \n, \v, \f, \r et " ".

Exemple :

QString str = "  plein\t de\nblancs\r\n ";
str = str.simplified();
// str == "plein de blancs";

Voir aussi trimmed().

int QString::size () const

Renvoie le nombre de caract�res de la cha�ne.

Le dernier caract�re de la cha�ne est � la position size() - 1. De plus, QString garantit que le caract�re � la position size() est toujours \0, ce qui permet d'utiliser la valeur renvoy�e par data() et constData() comme argument pour des fonctions attendant des cha�nes avec un \0 final.

Exemple :

QString str = "World";
int n = str.size();         // n == 5
str.data()[0];              // renvoie 'W'
str.data()[4];              // renvoie 'd'
str.data()[5];              // renvoie ''\0''

Voir aussi isEmpty() et resize().

QStringList QString::split ( const QString & sep, SplitBehavior behavior = KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

D�coupe la cha�ne en sous-cha�nes � chaque occurrence de sep et renvoie la liste de ces cha�nes. Si sep n'est pas trouv� dans la cha�ne, split() renvoie une liste contenant cette cha�ne comme seul �l�ment.

cs sp�cifie si la recherche de sep doit �tre sensible � la casse.

Si behavior est QString::SkipEmptyParts, le r�sultat ne contiendra pas les portions vides. Par d�faut, les portions vides sont incluses.

Exemple :

QString str = "a,,b,c";
 
QStringList list1 = str.split(",");
// list1: [ "a", "", "b", "c" ]
 
QStringList list2 = str.split(",", QString::SkipEmptyParts);
// list2: [ "a", "b", "c" ]

Voir aussi QStringList::join() et section().

QStringList QString::split ( const QChar & sep, SplitBehavior behavior = KeepEmptyParts, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Il s'agit d'une fonction surcharg�e.

QStringList QString::split ( const QRegExp & rx, SplitBehavior behavior = KeepEmptyParts ) const

Il s'agit d'une fonction surcharg�e.

D�coupe la cha�ne en sous-cha�nes � chaque correspondance de l'expression r�guli�re rx et renvoie la liste de ces cha�nes. Si rx n'a aucune correspondance dans la cha�ne, split() renvoie une liste contenant cette cha�ne comme seul �l�ment.

Voici un exemple dans lequel nous extrayons les mots d'une phrase en utilisant un ou plusieurs blancs comme s�parateur :

QString str;
QStringList list;
 
str = "Un  texte\n\tavec  des blancs �tranges.";
list = str.split(QRegExp("\\s+"));
// list: [ "Un", "texte", "avec", "des", "blancs", "�tranges." ]

Voici un exemple similaire mais qui utilise n'importe quelle s�quence de caract�res non-mot comme s�parateur :

str = "Cette fois, une phrase normale.";
list = str.split(QRegExp("\\W+"), QString::SkipEmptyParts);
// list: [ "Cette", "fois", "une", "phrase", "normale" ]

Voici un troisi�me exemple o� nous utilisons une assertion de longueur z�ro, \b (fronti�re de mot), pour d�couper la cha�ne en s�quence alternant les mots et les non-mots :

str = "Maintenant: ce petit fragment.";
list = str.split(QRegExp("\\b"));
// list: [ "", "Maintenant", ": ", "ce", " ", "petit", " ", "fragment", "." ]

Voir aussi QStringList::join() et section().

QString & QString::sprintf ( const char * cformat, ... )

Construction s�curis�e d'une cha�ne format�e � partir la cha�ne de formatage cformat et d'une liste arbitraire d'arguments.

La s�quence d'�chappement %lc attend un caract�re Unicode de type ushort (comme celui renvoy� par QChar::unicode()). La s�quence d'�chappement %ls attend un pointeur vers un tableau termin� par un z�ro de caract�re Unicode de type ushort (comme celui renvoy� par QString::utf16()).

Note : Cette fonction attend une cha�ne UTF-8 pour %s et Latin-1 pour la cha�ne de formatage.

La cha�ne de formatage autorise la plupart des sp�cificateurs de conversion du printf() de la biblioth�que standard C++. Il ne respecte pas les modificateurs de longueur (comme h pour short ou ll pour long long). Si vous en avez besoin, utilisez la fonction standard snprintf() � la place :

size_t BufSize;
char buf[BufSize];
 
::snprintf(buf, BufSize, "%lld", 123456789LL);
QString str = QString::fromAscii(buf);

Attention : nous ne recommandons pas l'usage de QString::sprintf() dans du nouveau code Qt. Envisagez plut�t d'utiliser QTextStream ou arg(), qui g�rent tous les deux les cha�nes Unicode de fa�on transparente et qui v�rifient les types. Voici un exemple d'utilisation de QTextStream :

QString result;
QTextStream(&result) << "pi = " << 3.14;
// result == "pi = 3.14"

Pour les traductions, en particulier si les cha�nes contiennent plus d'une s�quence d'�chappement, vous devriez plut�t envisager d'utiliser la fonction arg(). Elle permet au traducteur de contr�ler l'ordre de remplacement.

Voir aussi arg().

void QString::squeeze ()

Lib�re l'espace m�moire qui n'est pas requis pour stocker les donn�es.

Le seul int�r�t de cette fonction est de donner un moyen de g�rer finement l'utilisation de la m�moire par QString. En g�n�ral, vous aurez rarement besoin de l'appeler.

Voir aussi reserve() et capacity().

bool QString::startsWith ( const QString & s, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Renvoie true si la cha�ne commence par s ; sinon renvoie false.

Si cs est Qt::CaseSensitive, la comparaison est sensible � la casse ; sinon elle est insensible � la casse.

QString str = "Bananes";
str.startsWith("Ban");     // renvoie true
str.startsWith("Car");     // renvoie false

Voir aussi endsWith().

bool QString::startsWith ( const QLatin1String & s, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge startsWith().

bool QString::startsWith ( const QChar & c, Qt::CaseSensitivity cs = Qt::CaseSensitive ) const

Cette fonction surcharge startsWith().

Renvoie true si la cha�ne commence par c ; sinon renvoie false.

QByteArray QString::toAscii () const

Renvoie une repr�sentation an 8 bits de la cha�ne dans un QByteArray.

Si un codec a �t� fix� avec QTextCodec::setCodecForCStrings(), il est utilis� pour convertir d'Unicode vers des caract�res 8 bits ; sinon cette fonction fait la m�me chose que toLatin1().

Notez que, malgr� son nom, cette fonction ne renvoie pas forc�ment une cha�ne US-ASCII (ANSI X3.4-1986) et son r�sultat peut ne pas �tre compatible avec l'US-ASCII.

Voir aussi fromAscii(), toLatin1(), toUtf8(), toLocal8Bit() et QTextCodec.

QString QString::toCaseFolded () const

Renvoie l'�quivalent en casse uniforme de la cha�ne. Pour la plupart des caract�res Unicode, le traitement est identique � celui de toLower().

double QString::toDouble ( bool * ok = 0 ) const

Renvoie la cha�ne convertie en valeur double.

Renvoie 0.0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

QString str = "1234.56";
double val = str.toDouble();   // val == 1234.56

La conversion en double peut se faire pour divers formats de repr�sentation des flottants :

bool ok;
double d;
 
d = QString( "1234.56e-02" ).toDouble(&ok); // ok == true, d == 12.3456

Cette fonction essaie d'interpr�ter la cha�ne en fonction de la localisation courante. La localisation courante est demand�e au syst�me au d�marrage de l'application et peut �tre chang�e en appelant QLocale::setDefault(). Si la cha�ne ne peut pas �tre interpr�t�e en fonction de la localisation courante, la fonction utilise par d�faut la localisation « C ».

QLocale::setDefault(QLocale::C);
d = QString( "1234,56" ).toDouble(&ok); // ok == false
d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
 
QLocale::setDefault(QLocale::German);
d = QString( "1234,56" ).toDouble(&ok); // ok == true, d == 1234.56
d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56

� cause de l'ambigu�t� entre le point d�cimal et le s�parateur de milliers dans plusieurs localisations, cette fonction ne g�re pas les s�parateurs de milliers. Si vous devez convertir ce type de nombres, utilisez QLocale::toDouble().

QLocale::setDefault(QLocale::C);
d = QString( "1234,56" ).toDouble(&ok); // ok == false

Voir aussi number(), QLocale::setDefault(), QLocale::toDouble() et trimmed().

float QString::toFloat ( bool * ok = 0 ) const

Renvoie la cha�ne convertie en une valeur float.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true. Renvoie 0.0 si la conversion �choue.

Exemple :

QString str1 = "1234.56";
str1.toFloat();             // retourne 1234.56
 
bool ok;
QString str2 = "R2D2";
str2.toFloat(&ok);          // retourne 0.0, fixe ok � false

Voir aussi number(), toDouble() et toInt().

int QString::toInt ( bool * ok = 0, int base = 10 ) const

Renvoie la cha�ne convertie en int en utilisant la base base, d�cimale par d�faut et qui doit �tre comprise entre 2 et 36 ou 0. Renvoie 0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

Si base vaut 0, on utilise la convention du langage C : si la cha�ne commence par « 0x », on utilise la base 16 ; si la cha�ne commence par «   », on utilise la base 8 ; sinon, on utilise la base 10.

Exemple :

QString str = "FF";
bool ok;
int hex = str.toInt(&ok, 16);       // hex == 255, ok == true
int dec = str.toInt(&ok, 10);       // dec == 0, ok == false

Voir aussi number(), toUInt() et toDouble().

QByteArray QString::toLatin1 () const

Renvoie une repr�sentation Latin-1 de la cha�ne sous forme d'un QByteArray.

Le tableau d'octets renvoy� est ind�fini si la cha�ne contient des caract�res non Latin-1. Ces caract�res peuvent �tre supprim�s ou remplac�s par des points d'interrogation.

Voir aussi fromLatin1(), toAscii(), toUtf8(), toLocal8Bit() et QTextCodec.

QByteArray QString::toLocal8Bit () const

Renvoie une repr�sentation en encodage local 8 bits de la cha�ne sous forme d'un QByteArray. Le tableau d'octets renvoy� est ind�fini si la cha�ne contient des caract�res non g�r�s par l'encodage local 8 bits.

QTextCodec::codecForLocale() est utilis� pour effectuer la conversion depuis Unicode. Si l'encodage local ne peut pas �tre d�termin�, cette fonction fait le m�me traitement que toLatin1().

Si la cha�ne contient des caract�res ne pouvant pas �tre encod�s par l'encodage local, le tableau d'octets renvoy� est ind�fini. Ces caract�res peuvent �tre supprim�s ou remplac�s par d'autres.

Voir aussi fromLocal8Bit(), toAscii(), toLatin1(), toUtf8() et QTextCodec.

long QString::toLong ( bool * ok = 0, int base = 10 ) const

Renvoie la cha�ne convertie en long en utilisant la base base, d�cimale par d�faut et qui doit �tre comprise entre 2 et 36 ou 0. Renvoie 0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

Si base vaut 0, on utilise la convention du langage C : si la cha�ne commence par « 0x », on utilise la base 16 ; si la cha�ne commence par «   », on utilise la base 8 ; sinon, on utilise la base 10.

Exemple :

QString str = "FF";
bool ok;
 
long hex = str.toLong(&ok, 16);     // hex == 255, ok == true
long dec = str.toLong(&ok, 10);     // dec == 0, ok == false

Voir aussi number(), toULong() et toInt().

qlonglong QString::toLongLong ( bool * ok = 0, int base = 10 ) const

Renvoie la cha�ne convertie en long long en utilisant la base base, d�cimale par d�faut et qui doit �tre comprise entre 2 et 36 ou 0. Renvoie 0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

Si base vaut 0, on utilise la convention du langage C : si la cha�ne commence par « 0x », on utilise la base 16 ; si la cha�ne commence par «   », on utilise la base 8 ; sinon, on utilise la base 10.

Exemple :

QString str = "FF";
bool ok;
 
qint64 hex = str.toLongLong(&ok, 16);      // hex == 255, ok == true
qint64 dec = str.toLongLong(&ok, 10);      // dec == 0, ok == false

Voir aussi number(), toULongLong() et toInt().

QString QString::toLower () const

Renvoie une copie de la cha�ne en minuscules.

QString str = "Qt by NOKIA";
str = str.toLower();        // str == "qt by nokia"

Voir aussi toUpper().

short QString::toShort ( bool * ok = 0, int base = 10 ) const

Renvoie la cha�ne convertie en short en utilisant la base base, d�cimale par d�faut et qui doit �tre comprise entre 2 et 36 ou 0. Renvoie 0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

Si base vaut 0, on utilise la convention du langage C : si la cha�ne commence par « 0x », on utilise la base 16 ; si la cha�ne commence par «   », on utilise la base 8 ; sinon, on utilise la base 10.

Exemple :

QString str = "FF";
bool ok;
 
short hex = str.toShort(&ok, 16);   // hex == 255, ok == true
short dec = str.toShort(&ok, 10);   // dec == 0, ok == false

Voir aussi number(), toUShort() et toInt().

std::string QString::toStdString () const

Renvoie un objet std::string avec les donn�es contenues dans cette QString. Les donn�es Unicode sont converties en caract�res 8 bits en utilisant la fonction toAscii().

Cet op�rateur est utile pour passer une QString � une fonction acceptant un objet std::string.

Si la QString contient des caract�res Unicode que le codec QTextCodec::codecForCStrings() ne g�re pas, l'usage de cet op�rateur peut conduire � une perte d'informations.

Cet op�rateur n'est disponible que si Qt est configur� avec la compatibilit� STL activ�e.

Voir aussi toAscii(), toLatin1(), toUtf8() et toLocal8Bit().

std::wstring QString::toStdWString () const

Renvoie un objet std::wstring avec les donn�es contenues dans cette QString. La std::wstring est encod�e en UTF 16 sur les plateformes o� wchar_t est cod� sur deux octets (par exemple Windows) et en UCS 4 sur les plateformes o� wchar_t l'est sur quatre octets (la plupart des syst�mes Unix).

Cet op�rateur est utile pour passer une QString � une fonction acceptant un objet std::wstring.

Cet op�rateur n'est disponible que si Qt est configur� avec la compatibilit� STL activ�e.

Voir aussi utf16(), toAscii(), toLatin1(), toUtf8() et toLocal8Bit().

uint QString::toUInt ( bool * ok = 0, int base = 10 ) const

Renvoie la cha�ne convertie en unsigned int en utilisant la base base, d�cimale par d�faut et qui doit �tre comprise entre 2 et 36 ou 0. Renvoie 0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

Si base vaut 0, on utilise la convention du langage C : si la cha�ne commence par « 0x », on utilise la base 16 ; si la cha�ne commence par «   », on utilise la base 8 ; sinon, on utilise la base 10.

Exemple :

QString str = "FF";
bool ok;
 
uint hex = str.toUInt(&ok, 16);     // hex == 255, ok == true
uint dec = str.toUInt(&ok, 10);     // dec == 0, ok == false

Voir aussi number() et toInt().

ulong QString::toULong ( bool * ok = 0, int base = 10 ) const

Renvoie la cha�ne convertie en unsigned long en utilisant la base base, d�cimale par d�faut et qui doit �tre comprise entre 2 et 36 ou 0. Renvoie 0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

Si base vaut 0, on utilise la convention du langage C : si la cha�ne commence par « 0x », on utilise la base 16 ; si la cha�ne commence par «   », on utilise la base 8 ; sinon, on utilise la base 10.

Exemple :

QString str = "FF";
bool ok;
 
ulong hex = str.toULong(&ok, 16);   // hex == 255, ok == true
ulong dec = str.toULong(&ok, 10);   // dec == 0, ok == false

Voir aussi number().

qulonglong QString::toULongLong ( bool * ok = 0, int base = 10 ) const

Renvoie la cha�ne convertie en unsigned long long en utilisant la base base, d�cimale par d�faut et qui doit �tre comprise entre 2 et 36 ou 0. Renvoie 0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

Si base vaut 0, on utilise la convention du langage C : si la cha�ne commence par « 0x », on utilise la base 16 ; si la cha�ne commence par «   », on utilise la base 8 ; sinon, on utilise la base 10.

Exemple :

QString str = "FF";
bool ok;
 
quint64 hex = str.toULongLong(&ok, 16);    // hex == 255, ok == true
quint64 dec = str.toULongLong(&ok, 10);    // dec == 0, ok == false

Voir aussi number() et toLongLong().

ushort QString::toUShort ( bool * ok = 0, int base = 10 ) const

Renvoie la cha�ne convertie en unsigned short en utilisant la base base, d�cimale par d�faut et qui doit �tre comprise entre 2 et 36 ou 0. Renvoie 0 si la conversion �choue.

Si une erreur de conversion se produit, *ok est fix� � false ; sinon *ok est fix� � true.

Si base vaut 0, on utilise la convention du langage C : si la cha�ne commence par « 0x », on utilise la base 16 ; si la cha�ne commence par «   », on utilise la base 8 ; sinon, on utilise la base 10.

Exemple :

QString str = "FF";
bool ok;
 
ushort hex = str.toUShort(&ok, 16);     // hex == 255, ok == true
ushort dec = str.toUShort(&ok, 10);     // dec == 0, ok == false

Voir aussi number() et toShort().

QVector<uint> QString::toUcs4 () const

Retourne une repr�sentation UCS-4/UTF-32 de la cha�ne en tant que QVector<uint>.

UCS-4 est un codec Unicode sans perte. Tous les caract�res de cette cha�ne peuvent �tre encod�s en UCS-4. Le vecteur n'est pas termin� par un caract�re nul.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi fromUtf8(), toAscii(), toLatin1(), toLocal8Bit(), QTextCodec, fromUcs4() et toWCharArray().

QString QString::toUpper () const

Retourne une copie de la cha�ne en majuscule.

QString str = "TeXt";
str = str.toUpper();        // str == "TEXT"

Voir aussi toLower().

QByteArray QString::toUtf8 () const

Retourne une repr�sentation UTF-8 de la cha�ne en tant que QByteArray.

UTF-8 est un codec Unicode et peut repr�senter tous les caract�res dans une cha�ne Unicode comme QString.

Cependant, dans l'espace Unicode, il y a certains codes qui ne sont pas consid�r�s comme des caract�res. Le standard Unicode r�serve les deux derniers codes de chaque plan Unicode (U+FFFE, U+FFFF, U+1FFFE, U+1FFFF, U+2FFFE, etc.), ainsi que seize codes dans la plage U+FDD0..U+FDDF, inclus, comme des non-caract�res. Si le moindre d'entre eux appara�t dans la cha�ne, il n'appara�tra pas dans la repr�sentation UTF-8 ou pourrait �tre remplac� par un ou plusieurs caract�res de remplacement.

Voir aussi fromUtf8(), toAscii(), toLatin1(), toLocal8Bit() et QTextCodec.

int QString::toWCharArray ( wchar_t * array ) const

Remplit le tableau array avec les donn�es contenues dans cet objet QString. Le tableau est encod� en UTF-16 sur les plateformes o� wchar_t a une longueur de deux octets, comme sous Windows, et en UCS-4 sur les plateformes o� ce type a une taille de quatre octets (la majorit� des syst�mes Unix).

array doit �tre allou� par l'appelant et contenir suffisamment d'espace pour contenir l'enti�ret� de la cha�ne (allouer un tableau de m�me longueur que la cha�ne est toujours suffisant).

Retourne la vraie longueur de la cha�ne dans array.

Note : cette fonction ne met pas � la fin du tableau de caract�re nul.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi utf16(), toUcs4(), toAscii(), toLatin1(), toUtf8(), toLocal8Bit() et toStdWString().

QString QString::trimmed () const

Retourne une cha�ne qui a son espace blanc supprim� au d�but et � la fin.

L'espace blanc signifie tout caract�re pour lequel QChar::isSpace() retourne true. Ceci inclut les caract�res ASCII \t, \n, \v, \f, \r et " ".

Exemple :

QString str = "  lots\t of\nwhitespace\r\n ";
str = str.trimmed();
// str == "lots\t of\nwhitespace"

� l'inverse de simplified(), trimmed() laisse les espaces blancs uniques � l'int�rieur de la cha�ne.

Voir aussi simplified().

void QString::truncate ( int position )

Tronque la cha�ne � l'index position.

Si la position sp�cifi�e est au-del� de la fin de la cha�ne, rien ne se passe.

Exemple :

QString str = "Vladivostok";
str.truncate(4);
// str == "Vlad"

Si position est n�gatif, il est �quivalent � passer un z�ro.

Voir aussi chop(), resize() et left().

const QChar * QString::unicode () const

Retourne une repr�sentation Unicode termin�e par le caract�re \0 de la cha�ne. Le r�sultat reste valide jusqu'� ce que la cha�ne soit chang�e.

Voir aussi setUnicode() et utf16().

const ushort * QString::utf16 () const

Retourne la QString en tant que tableau termin� par un caract�re \0 de r�els courts non sign�s. Le r�sultat reste valide jusqu'� ce que la cha�ne soit chang�e.

La cha�ne retourn�e est ordonn�e en fonction des habitudes de l'h�te.

Voir aussi setUtf16() et unicode().

QString & QString::vsprintf ( const char * cformat, va_list ap )

M�thode �quivalente � sprintf() mais prend une va_list au lieu d'une liste d'arguments variables. Voir la documentation de sprintf() pour une explication de cformat.

Cette m�thode n'appelle pas la macro va_end, l'appelant est responsable d'appeler va_end sur ap.

Voir aussi sprintf().

bool QString::operator!= ( const QString & other ) const

Retourne true si cette cha�ne est diff�rente de other ; sinon, retourne false.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction localeAwareCompare().

bool QString::operator!= ( const QLatin1String & other ) const

Cette fonction surcharge operator!=().

bool QString::operator!= ( const QByteArray & other ) const

Cette fonction surcharge operator!=().

Le tableau de bits other est converti en QString en utilisant la fonction fromAscii(). Si le moindre caract�re NULL (\0) est dans ce tableau, il sera inclus dans la transformation.

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator!= ( const char * other ) const

Cette fonction surcharge operator!=().

Le pointeur sur caract�re constant other est converti en une QString en utilisant la fonction fromAscii()

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::operator+= ( const QString & other )

Ajoute la cha�ne other � la fin de cette cha�ne et retourne une r�f�rence � cette cha�ne.

Exemple :

QString x = "free";
QString y = "dom";
x += y;
// x == "freedom"

Cette op�ration est g�n�ralement tr�s rapide (temps constant), parce que QString pr�alloue de l'espace suppl�mentaire � la fin de la cha�ne pour qu'elle puisse grandir sans devoir r�allouer la cha�ne en entier � chaque fois.

Voir aussi append() et prepend().

QString & QString::operator+= ( const QLatin1String & str )

Cette fonction surcharge operator+=().

Ajoute la cha�ne Latin-1 str � cette cha�ne.

QString & QString::operator+= ( const QByteArray & ba )

Cette fonction surcharge operator+=().

Ajoute le tableau de bits ba � cette cha�ne. Le tableau de bits est converti en Unicode en utilisant la fonction fromAscii(). Si le moindre caract�re NULL (\0) est dans le tableau ba, il sera inclus dans la transformation.

Vous pouvez d�sactiver cette fonction en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::operator+= ( const char * str )

Cette fonction surcharge operator+=().

Ajoute la cha�ne str � cette cha�ne. Le pointeur sur caract�re constant est converti en Unicode en utilisant la fonction fromAscii()

Vous pouvez d�sactiver cette fonction en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::operator+= ( const QStringRef & str )

Cette fonction surcharge operator+=().

Ajoute la cha�ne section referenced by str � cette cha�ne.

QString & QString::operator+= ( char ch )

Cette fonction surcharge operator+=().

Ajoute le caract�re ch � cette cha�ne. Le caract�re est converti en Unicode en utilisant la fonction fromAscii()

Vous pouvez d�sactiver cette fonction en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::operator+= ( QChar ch )

Cette fonction surcharge operator+=().

Ajoute le caract�re ch to the string.

bool QString::operator< ( const QString & other ) const

Retourne true si cette cha�ne est lexicalement plus petite que la cha�ne other ; sinon, retourne false.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction QString::localeAwareCompare().

bool QString::operator< ( const QLatin1String & other ) const

Cette fonction surcharge operator<().

bool QString::operator< ( const QByteArray & other ) const

Cette fonction surcharge operator<().

Le tableau de bits other est converti en QString en utilisant la fonction fromAscii(). Si le moindre caract�re NULL (\0) est dans ce tableau, il sera inclus dans la transformation.

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator< ( const char * other ) const

Cette fonction surcharge operator<().

Le pointeur sur caract�re constant other est converti en une QString en utilisant la fonction fromAscii()

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator<= ( const QString & other ) const

Retourne true si cette cha�ne est lexicalement plus petite ou �gale � la cha�ne other ; sinon, retourne false.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction localeAwareCompare().

bool QString::operator<= ( const QLatin1String & other ) const

Cette fonction surcharge operator<=().

bool QString::operator<= ( const QByteArray & other ) const

Cette fonction surcharge operator<=().

Le tableau de bits other est converti en QString en utilisant la fonction fromAscii(). Si le moindre caract�re NULL (\0) est dans ce tableau, il sera inclus dans la transformation.

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator<= ( const char * other ) const

Cette fonction surcharge operator<=().

Le pointeur sur caract�re constant other est converti en une QString en utilisant la fonction fromAscii()

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

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

Assigne other � cette cha�ne et retourne une r�f�rence sur cette cha�ne.

QString & QString::operator= ( const QLatin1String & str )

Cette fonction surcharge operator=().

Assigne la cha�ne Latin-1 str � cette cha�ne.

QString & QString::operator= ( const QByteArray & ba )

Cette fonction surcharge operator=().

Assigne ba � cette cha�ne. Le tableau de bits est converti en Unicode en utilisant la fonction fromAscii(). Cette fonction arr�te la conversion au premier caract�re NULL trouv� ou � la fin du tableau ba.

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::operator= ( const char * str )

Cette fonction surcharge operator=().

Assigne str � cette cha�ne. Le pointeur sur caract�re constant est converti en Unicode en utilisant la fonction fromAscii().

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::operator= ( char ch )

Cette fonction surcharge operator=().

Assigne le caract�re ch � cette cha�ne. Il est converti en Unicode en utilisation la fonction fromAscii().

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QString & QString::operator= ( QChar ch )

Cette fonction surcharge operator=().

D�finit la cha�ne comme ne contenant que le seul caract�re ch.

bool QString::operator== ( const QString & other ) const

Retourne true si la cha�ne other est �gale � celle-ci ; sinon, retourne false.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction localeAwareCompare().

bool QString::operator== ( const QLatin1String & other ) const

Cette fonction surcharge operator==().

bool QString::operator== ( const QByteArray & other ) const

Cette fonction surcharge operator==().

Le tableau de bits other est converti en QString en utilisant la fonction fromAscii(). Cette fonction arr�te la conversion au premier caract�re NULL trouv� ou � la fin du tableau de bits.

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator== ( const char * other ) const

Cette fonction surcharge operator==().

Le pointeur sur caract�re constant other est converti en une QString en utilisant la fonction fromAscii()

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator> ( const QString & other ) const

Retourne true si cette cha�ne est lexicalement plus grand que la cha�ne other ; sinon, retourne false.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction localeAwareCompare().

bool QString::operator> ( const QLatin1String & other ) const

Cette fonction surcharge operator>().

bool QString::operator> ( const QByteArray & other ) const

Cette fonction surcharge operator>().

Le tableau de bits other est converti en QString en utilisant la fonction fromAscii(). Si le moindre caract�re NULL (\0) est dans ce tableau, il sera inclus dans la transformation.

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator> ( const char * other ) const

Cette fonction surcharge operator>().

Le pointeur sur caract�re constant other est converti en une QString en utilisant la fonction fromAscii()

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator>= ( const QString & other ) const

Retourne true si cette cha�ne est lexicalement plus grande ou �gale � la cha�ne other ; sinon retourne false.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction localeAwareCompare().

bool QString::operator>= ( const QLatin1String & other ) const

Cette fonction surcharge operator>=().

bool QString::operator>= ( const QByteArray & other ) const

Cette fonction surcharge operator>=().

Le tableau de bits other est converti en QString en utilisant la fonction fromAscii(). Si le moindre caract�re NULL (\0) est dans ce tableau, il sera inclus dans la transformation.

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

bool QString::operator>= ( const char * other ) const

Cette fonction surcharge operator>=().

Le pointeur sur un caract�re constant other est converti en QString en utilisant la fonction fromAscii().

Vous pouvez d�sactiver cet op�rateur en d�finissant QT_NO_CAST_FROM_ASCII � la compilation de l'application. Ceci peut �tre utile si vous voulez vous assurer que toutes les cha�nes visibles � l'utilisateur passent par QObject::tr(), par exemple.

QCharRef QString::operator[] ( int position )

Retourne le caract�re � la position sp�cifi�e dans la cha�ne comme une r�f�rence modifiable.

Exemple :

QString str;
 
if (str[0] == QChar('?'))
    str[0] = QChar('_');

La valeur de retour est de type QCharRef, une classe d'aide pour QString. Quand vous recevez un objet de type QCharRef, vous pouvez l'utiliser comme si c'�tait un QChar &. Si vous l'assignez, cette op�ration sera appliqu�e sur le caract�re dans la QString sur laquelle vous avez une r�f�rence.

Voir aussi at().

const QChar QString::operator[] ( int position ) const

Cette fonction surcharge operator[]().

QCharRef QString::operator[] ( uint position )

Cette fonction surcharge operator[]().

Retourne le caract�re � la position sp�cifi�e dans la cha�ne comme une r�f�rence modifiable. �quivalent � at(position).

const QChar QString::operator[] ( uint position ) const

Cette fonction surcharge operator[]().

En relation mais non membres de la classe

bool operator!= ( const char * s1, const QString & s2 )

Retourne true si s1 n'est pas �gale � s2 ; sinon, retourne false. Pour s1 non NULL, ceci est �quivalent � compare( s1, s2 ) != 0. Notez qu'aucune cha�ne n'est �gale � s1 si cette derni�re est nulle.

Voir aussi QString::compare().

const QString operator+ ( const QString & s1, const QString & s2 )

Retourne une cha�ne qui est le r�sultat de la concat�nation de s1 et s2.

const QString operator+ ( const QString & s1, const char * s2 )

Retourne une cha�ne qui est le r�sultat de la concat�nation de s1 et s2 (s2 est convertie en Unicode en utilisant la fonction QString::fromAscii()).

Voir aussi QString::fromAscii().

const QString operator+ ( const char * s1, const QString & s2 )

Retourne une cha�ne qui est le r�sultat de la concat�nation de s1 et s2 (s1 est convertie en Unicode en utilisant la fonction QString::fromAscii()).

Voir aussi QString::fromAscii().

const QString operator+ ( char ch, const QString & s )

Retourne une cha�ne qui est le r�sultat de la concat�nation du caract�re ch et de la cha�ne s.

const QString operator+ ( const QString & s, char ch )

Retourne une cha�ne qui est le r�sultat de la concat�nation de la cha�ne s et du caract�re ch.

bool operator< ( const char * s1, const QString & s2 )

Retourne true si s1 est lexicalement inf�rieure � s2 ; sinon, retourne false. Pour s1 non NULL, ceci est �quivalent � compare(s1, s2) < 0.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction QString::localeAwareCompare().

Voir aussi QString::compare().

QDataStream & operator<< ( QDataStream & stream, const QString & string )

�crit la cha�ne donn�e string dans le flux stream.

Voir aussi S�rialiser les types de donn�es Qt.

bool operator<= ( const char * s1, const QString & s2 )

Retourne true si s1 est lexicalement inf�rieure ou �gale � s2 ; sinon, retourne false. Pour s1 non NULL, ceci est �quivalent � compare(s1, s2) <= 0.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction QString::localeAwareCompare().

Voir aussi QString::compare().

bool operator== ( const char * s1, const QString & s2 )

Cette fonction surcharge operator==().

Retourne true si s1 est �gale � s2 ; sinon, retourne false. Notez qu'aucune cha�ne n'est �gale � s1 si cette derni�re est nulle.

�quivalent � s1 != 0 && compare(s1, s2) == 0.

Voir aussi QString::compare().

bool operator> ( const char * s1, const QString & s2 )

Retourne true si s1 est lexicalement plus grande que s2 ; sinon, retourne false. �quivalent � compare(s1, s2) > 0.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction QString::localeAwareCompare().

Voir aussi QString::compare().

bool operator>= ( const char * s1, const QString & s2 )

Retourne true si s1 est lexicalement plus grande ou �gale � s2 ; sinon, retourne false. Pour s1 non NULL, ceci est �quivalent � compare(s1, s2) >= 0.

La comparaison se base exclusivement sur les valeurs num�riques Unicode des caract�res et est tr�s rapide, mais ce n'est pas ce qu'un humain attendrait. Pr�f�rez le tri pour les cha�nes pour l'interface utilisateur avec la fonction QString::localeAwareCompare().

QDataStream & operator>> ( QDataStream & stream, QString & string )

Lit une cha�ne du flux stream dans la cha�ne string.

Voir aussi S�rialisation de types de donn�es Qt.

Documentation des macros

QT_NO_CAST_FROM_ASCII

D�sactive les conversions automatiques de cha�nes 8 bits (char *) en QString Unicode.

Voir aussi QT_NO_CAST_TO_ASCII et QT_NO_CAST_FROM_BYTEARRAY.

QT_NO_CAST_TO_ASCII

D�sactive la conversion automatique de QString en cha�nes 8 bits (char *).

Voir aussi QT_NO_CAST_FROM_ASCII et QT_NO_CAST_FROM_BYTEARRAY.

Remerciements

Merci � Abdelhafid Hafidi, Thibaut Cuvelier, Jonathan Courtois et Ilya Diallo pour leur traduction et leur relecture ainsi qu'� Claude Leloup pour sa relecture !