public member function
const_iterator begin() const;
iterator begin() noexcept;
const_iterator begin() const noexcept;
Return iterator to beginning
Returns an iterator pointing to the first character of the string.
An iterator to the beginning of the string.
If the string object is const-qualified, the function returns a const_iterator. Otherwise, it returns an iterator.
Member types iterator and const_iterator are random access iterator types (pointing to a character and to a const character, respectively).
int main ()
std::string str ("Test string");
for ( std::string::iterator it=str.begin(); it!=str.end(); ++it)
std::cout << *it;
std::cout << '\n';
Generally, no changes.
On some implementations, the non-const version may invalidate all iterators, pointers and references on the first access to string characters after the object has been constructed or modified.
The object is accessed, and in some implementations, the non-const version modifies it on the first access to string characters after the object has been constructed or modified.
The iterator returned can be used to access or modify characters.
Unspecified, but generally constant.
The object is accessed (neither the const nor the non-const versions modify it).
The iterator returned can be used to access or modify characters. Concurrently accessing or modifying different characters is safe.
No-throw guarantee: this member function never throws exceptions.
The copy construction or assignment of the returned iterator is also guaranteed to never throw.
- Return iterator to end (public member function
- Return reverse iterator to reverse beginning (public member function