basic_string::begin
Retourne un itérateur traitant le premier élément de la chaîne.
const_iterator begin( ) const;
iterator begin( );
Valeur de retour
Itérateur d'accès aléatoire qui s'adresse au premier élément de la séquence contrôlée ou la position juste après la fin d'une séquence vide.
Remarque
Si la valeur de retour de begin est assignée à const_iterator, il est impossible de modifier l'objet de chaîne. Si la valeur de retour de begin est assignée à un itérateur, l'objet de chaîne peut être modifié.
Exemple
// basic_string_begin.cpp
// compile with: /EHsc
#include <string>
#include <iostream>
int main( ) {
using namespace std;
string str1 ( "No way out." ), str2;
basic_string <char>::iterator strp_Iter, str1_Iter, str2_Iter;
basic_string <char>::const_iterator str1_cIter;
str1_Iter = str1.begin ( );
cout << "The first character of the string str1 is: "
<< *str1_Iter << endl;
cout << "The full original string str1 is: " << str1 << endl;
// The dereferenced iterator can be used to modify a character
*str1_Iter = 'G';
cout << "The first character of the modified str1 is now: "
<< *str1_Iter << endl;
cout << "The full modified string str1 is now: " << str1 << endl;
// The following line would be an error because iterator is const
// *str1_cIter = 'g';
// For an empty string, begin is equivalent to end
if ( str2.begin ( ) == str2.end ( ) )
cout << "The string str2 is empty." << endl;
else
cout << "The string str2 is not empty." << endl;
}
Sortie
The first character of the string str1 is: N
The full original string str1 is: No way out.
The first character of the modified str1 is now: G
The full modified string str1 is now: Go way out.
The string str2 is empty.
Configuration requise
En-tête : <chaîne>
Espace de noms : std