basic_string::end
Devuelve un iterador que se dirige a la ubicación que sigue el último elemento de una cadena.
const_iterator end( ) const;
iterator end( );
Valor devuelto
Devuelve un iterador de acceso aleatorio que dirige la ubicación que funciona correctamente el último elemento en una cadena.
Comentarios
end se utiliza normalmente para comprobar si un iterador alcanzó el final de la cadena. El valor devuelto por end no debe ser administrada.
Si el valor devuelto de end se asigna a const_iterator, el objeto string no puede modificarse. Si el valor devuelto de end se asigna a iterator, el objeto string puede modificarse.
Ejemplo
// basic_string_end.cpp
// compile with: /EHsc
#include <string>
#include <iostream>
int main( )
{
using namespace std;
string str1 ( "No way out." ), str2;
basic_string <char>::iterator str_Iter, str1_Iter, str2_Iter;
basic_string <char>::const_iterator str1_cIter;
str1_Iter = str1.end ( );
str1_Iter--;
str1_Iter--;
cout << "The last character-letter of the string str1 is: " << *str1_Iter << endl;
cout << "The full orginal string str1 is: " << str1 << endl;
// end used to test when an iterator has reached the end of its string
cout << "The string is now: ";
for ( str_Iter = str1.begin( ); str_Iter != str1.end( ); str_Iter++ )
cout << *str_Iter;
cout << endl;
// The dereferenced iterator can be used to modify a character
*str1_Iter = 'T';
cout << "The last character-letter of the modified str1 is now: "
<< *str1_Iter << endl;
cout << "The modified string str1 is now: " << str1 << endl;
// The following line would be an error because iterator is const
// *str1_cIter = 'T';
// For an empty string, end is equivalent to begin
if ( str2.begin( ) == str2.end ( ) )
cout << "The string str2 is empty." << endl;
else
cout << "The stringstr2 is not empty." << endl;
}
Requisitos
Encabezado: <string>
Espacio de nombres: std