Partager via


basic_string::operator[]

Fournit une référence au caractère avec un index spécifié dans une chaîne.

const_reference operator[](
   size_type _Off
) const;
reference operator[](
   size_type _Off
);

Paramètres

  • _Off
    L'index de position de l'élément à référencer.

Valeur de retour

Une référence au format caractère de la chaîne à la position indiquée par l'index du paramètre.

Notes

Le premier élément dans la chaîne possède un index de zéro, les éléments suivants sont indexés consécutivement par des entiers positifs, afin qu'une chaîne de longueur n ait son nièmeélément indexé par le nombre n - 1.

operator[] est plus rapide que la fonction membre at pour fournir un accès en lecture et en écriture aux éléments d'une chaîne.

operator[] ne vérifie pas si l'index transmis comme paramètre est valide, mais la fonction membre at le fait et doit donc être utilisée si la validité n'est pas certaine. Un index invalide (un index inférieur à zéro ou supérieur ou égal à la taille de la chaîne) atteint la fonction membre at qui lève l'exception classe d'out_of_range. Un index invalide atteint operator[] résulte d'un comportement indéfini, mais l'index égal à la longueur de la chaîne est un index valide pour les chaînes consts et l'opérateur retourne le caractère NULL lorsque atteint cet index.

La référence retournée peut être invalidée par les redistributions ou des modifications de chaîne pour les chaînes non const.

Lorsque vous compilez avec _SECURE_SCL 1, une erreur d'exécution se produit si vous tentez d'accéder à un élément hors des limites de la chaîne. Pour plus d'informations, consultez Itérateurs vérifiés.

Exemple

// basic_string_op_ref.cpp
// compile with: /EHsc
#include <string>
#include <iostream>

int main( )
{
   using namespace std;
   string str1 ( "Hello world" ), str2 ( "Goodbye world" );
   const string cstr1 ( "Hello there" ), cstr2 ( "Goodbye now" );
   cout << "The original string str1 is: " << str1 << endl;
   cout << "The original string str2 is: " << str2 << endl;

   // Element access to the non-const strings
   basic_string <char>::reference refStr1 = str1 [6];
   basic_string <char>::reference refStr2 = str2.at ( 3 );

   cout << "The character with an index of 6 in string str1 is: "
        << refStr1 << "." << endl;
   cout << "The character with an index of 3 in string str2 is: "
        << refStr2 << "." << endl;

   // Element access to the const strings
   basic_string <char>::const_reference crefStr1 = cstr1 [ cstr1.length ( ) ];
   basic_string <char>::const_reference crefStr2 = cstr2.at ( 8 );

   if ( crefStr1 == '\0' )
      cout << "The null character is returned as a valid reference."
           << endl;
   else
      cout << "The null character is not returned." << endl;
   cout << "The character with index of 8 in the const string cstr2 is: "
        << crefStr2 << "." << endl;
}

Sortie

The original string str1 is: Hello world
The original string str2 is: Goodbye world
The character with an index of 6 in string str1 is: w.
The character with an index of 3 in string str2 is: d.
The null character is returned as a valid reference.
The character with index of 8 in the const string cstr2 is: n.

Configuration requise

En-tête : <chaîne>

Espace de noms : std

Voir aussi

Référence

basic_string, classe