string::begin


public member function
      iterator begin();
const_iterator begin() const;

Return iterator to beginning

Returns an iterator referring to the first character in the string.

Parameters

none

Return Value

An iterator to the beginning of the string.

The type of this iterator is either string::iterator member type or string::const_iterator member type, which are compiler specific iterator types suitable to iterate through the elements of a string object.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
 
// string::begin and string::end
#include <iostream>
#include <string>
using namespace std;

int main ()
{
  string str ("Test string");
  string::iterator it;
  for ( it=str.begin() ; it < str.end(); it++ )
    cout << *it;
  return 0;
}


This code prints out the content of a string character by character using an iterator that iterates between begin and end.

Basic template member declaration

( basic_string<charT,traits,Allocator> )
1
2
 
      iterator begin();
const_iterator begin() const;


See also

string::end Return iterator to end (public member function)
string::rbegin Return reverse iterator to reverse beginning (public member function)
string::rend Return reverse iterator to reverse end (public member function)