Sommaire

Constructeurs
Accesseurs de la classe string
Modifieurs de la classe string
Méthodes

append()
assign()
erase()
insert()
replace()
swap()
c_str()

Algorithmes de recherche
Opérateurs

Affectation :  =
Concaténation : +=

Opérateur de concaténation : +
Opérateurs de comparaison :    ==   !=   <   >   <=   >=
Entrées/Sorties
Divers

Remarques préliminaire :

• Les profils des différents opérateurs et fonctions sont trop complexes pour être présentés ici (consulter pour cela  la norme ANSI du C++). Ils sont donc seulement donnés sous forme d'exemples d'utilisation.
• Dans tout ce qui suit, ident désigne l'identificateur de l'objet de la classe string qui est en cours de création ou dont est appelée une méthode.
• Le premier caractère d'une chaîne est de rang 0. Attention donc à toutes les méthodes qui ont pour paramètre une position (identificateur Pos).

Fonctions et opérateurs membres de la classe string

Constructeurs

"..."  : de type NTCTS
Pos, Nbre  : des entiers non signés (en principe de type string::size_type)
S  : de type string
C  : caractère (type "générique" charT)

1. Le premier constructeur est appelé le constructeur par défaut (parce qu'utilisé sans paramètre).
2. Le quatrième constructeur est appelé le constructeur par recopie (parce qu'il recopie un string dans un autre).
3. Il appartient à l'utilisateur de s'assurer que Pos et Nbre sont valides.

Remarques :.

1. Nbre indique le nombre maximal de caractères qui doivent être extraits du premier paramètre.
2. Bien que la première position dans la chaîne corresponde à Pos = 0, la valeur Pos = 5 n'est pas invalide. Elle représente la première position après la fin de la chaîne (valeur dite "past-the-end"). La chaîne extraite est alors une chaîne vide. En revanche toute valeur Pos > 5 est invalide.
3. Si Nbre == 0, le nombre d'octets extraits est nul, ce qui crée une chaîne vide.

Accesseurs de la classe string

    Toutes les fonctions renvoient une valeur de type string::size_type (en pratique un entier non signé) sauf empty() qui renvoie un booléen.

Exemples :
 

// Affichage string S01 ("ABCDE"); string::size_type Size = S01.size (); cout << Size            << endl;          // 5 cout << S01.size     () << endl;          // 5 cout << S01.length   () << endl;          // 5 cout << S01.max_size () << endl;          // xxxxxxxxxxxx  dépend de l'implémentation cout << S01.capacity () << endl;          // 8             dépend de l'implémentation if (S01.empty ()) ...

    La capacité d'une chaîne vide (par ex. constructeur par défaut) est indéfinie

Sommaire

Modifieurs de la classe string

    Nbre doit être de type string::size_type

Exemples :
 

// Affichage  voir plus loin l'opérateur << string S01 ("ABCDE"); S01.resize  (/* Nbre = */ 3); cout << '#' << S01 << '#' << endl;        // #ABC# cout << S01.size     ()   << endl;        // 3 cout << S01.capacity ()   << endl;        // 8             dépend de l'implémentation S01.resize  (/* Nbre = */ 2, /* C = */ '.'); cout << '#' << S01 << '#' << endl;        // #AB# cout << S01.size     ()   << endl;        // 2 cout << S01.capacity ()   << endl;        // 8             dépend de l'implémentation S01.resize  (/* Nbre = */ 9, /* C = */ '.'); cout << '#' << S01 << '#' << endl;        // #AB.......# cout << S01.size     ()   << endl;        // 9 cout << S01.capacity ()   << endl;        // 16            dépend de l'implémentation S01.clear;     // non implémenté ici cout << '#' << S01 << '#' << endl;        // ## cout << S01.size     ()   << endl;        // 0 cout << S01.capacity ()   << endl;        // non défini string S02 ("Coucou");                           // implémenté ici mais vide cout << S02.size     ()   << endl;        // 6 cout << S02.capacity ()   << endl;        // 8             dépend de l'implémentation S02.reserve (6); cout << S02.size     ()   << endl;        // 6 cout << S02.capacity ()   << endl;        // 8             dépend de l'implémentation S02.reserve (12); cout << S02.size     ()   << endl;        // 12 cout << S02.capacity ()   << endl;        // 8             dépend de l'implémentation

Sommaire

Méthodes

append()

Exemples :
 

// Affichage  string S0; string S1 ("perché sur un arbre mort"); string S2 ("perché"); cout << S0.append ("Maitre " )           .append ("corbeau et renard", /* Nbre = */ 8)           .append (/* Nbre = */ 3, /* C = */ '.')           .append (S1, /* Pos = */ 7, /* Nbre = */ 13)           .append (S2)      << endl;                            // Maitre corbeau ... sur un arbre perché

Remarques :

1. Nbre est le nombre maximal possible de caractères ajoutés en fin de chaîne.
2. Pos doit être valide (<= ident.size())

Sommaire

assign()

Sommaire

erase()

Exemples :
 

// Affichage  string S0 ("1234567890"); cout << '#' << S0.erase (/* Pos = */ 4, /* Nbre = */ 2) << '#' << endl;                                          // #12347890# cout << '#' << S0.erase (/* Pos = */ 4) << '#' << endl;                                          // #1234# cout << '#' << S0.erase () << '#' << endl;                                          // ##

Sommaire

insert()

Exemples :
 

// Affichage  string S0 ("1234567890"); string S1 ("ABCDEF"); cout << S0.insert (/* Pos  = */ 3, "abc")           .insert (/* Pos  = */ 3, "def", /* Nbre = */  2)           .insert (/* Pos  = */ 3, "ghi", /* Nbre = */ 12)           .insert (/* Pos  = */ 9, /* Nbre = */ 2, '.')           .insert (/* Pos  = */ 3, S1)           .insert (/* Pos1 = */ 15, S1, /* Pos2 = */ 4, /* Nbre = */ 2)     << endl;                            // 123ABCDEFghideaEF..bc4567890

Sommaire

replace()

Remarques :

1. Pos et Nbre (ou Pos1 et Nbre1) concernent les caractères supprimés dans la chaîne initiale.
2. Nbre2  (et éventuellement Pos2) concernent les caractères de remplacement

swap()

    permute les chaînes ident et S.

Sommaire

c_str()

    Le constructeur permet de faire l'opération inverse (obtenir un string à partir d'une NTCTS).

Sommaire

Algorithmes de recherche

find(), rfind() : recherchent la première (ou dernière) apparition d'une sous-chaîne dans une chaîne et renvoient la position du premier caractère de la sous chaîne dans la chaîne, quel que soit le sens du parcours.

find_first_of(), find_last_of() : recherchent la première (ou dernière) apparition de n'importe lequel des caractères d'une sous-chaîne dans une chaîne et renvoient la position du premier caractère de la sous-chaîne dans la chaîne, quel que soit le sens du parcours.

find_first_not_of(), find_last_not_of() : recherchent dans la chaîne initiale le premier (ou dernier) caractère n'appartenant pas à la seconde chaîne.

Remarques :

1. Pos est la position de départ de la recherche dans la chaîne initiale
2. Nbre est le nombre maximal de caractères de la chaîne initiale à l'intérieur desquels est effectuée la recherche
3. Toutes ces fonctions ci-dessus ne modifient pas la chaîne source (comme des accesseurs), donc sont déclarées const.
4.  Si elle est valide (!= string::npos), la valeur de retour peut être utilisée comme valeur de position dans une autre fonction (par exemple erase()).

Sommaire

Opérateurs

Affectation :      =

Exemples :
 

// Affichage string S0; string S1 ("abcdef"); cout << (S0 = S1)             << endl;        // abcdef cout << (S0 = S1 + "ghi")     << endl;        // abcdefghi       {1} cout << (S0 = string ("ABC")) << endl;        // ABC cout << (S0 = "ABC")          << endl;        // ABC cout << (S0 = '\t' + S1)      << endl;        //     abcdef

Remarques :

1. l'expression  est tout d'abord évaluée, puis le résultat est concaténé à la fin de la chaîne S0.
2. la NTCTS "ABC" est transformée, par appel explicite du constructeur, en un string qui est ensuite affectée à S0,
3. la NTCTS "ABC" est transformée, par appel implicite du constructeur, en un string qui est ensuite affectée à S0,
4. La chaîne S1 est tout d'abord concaténée au caractère '\t' en utilisant l'opérateur +, puis la chaîne résultante est ensuite affectée à S0.

Concaténation :     +=

Sommaire

Fonctions et opérateurs non membres, utilisables avec des strings

Opérateur de concaténation : +

    Bien entendu, la propriété d'associativité de l'opérateur + est respectée : S + C + "..." est équivalent à (S + C) + "...".

Sommaire

Opérateurs de comparaison :    ==   !=   <   >   <=   >=

idem pour autres opérateurs

Sommaire

Entrées/Sorties

delim  : caractère (type "générique" charT)
is : flux d'entrée (input stream)
os : flux de sortie (output stream)
S1, S2  : de type string

Sommaire

Divers

S1, S2  : de type string

Voir aussi :

   SGI - Bibliothèque STL : classe basic_string

   Thinking in C++ - B. Eckel : strings

© D. Mathieu     mathieu@romarin.univ-aix.fr
I.U.T.d'Aix en Provence - Département Informatique