basic_string::begin
Retourne un itérateur adressant le premier élément de la chaîne.
const_iterator begin( ) const;
iterator begin( );
Valeur de retour
Un itérateur d'accès aléatoire qui traite le premier élément de la séquence ou simplement au delà de la fin d'une séquence vide.
Note
Si la valeur de retour de begin est assignée à const_iterator, l'objet String ne peut pas être modifié.Si la valeur de retour de begin est assignée à iterator, l'objet 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 : <string>
l'espace de noms : DST