const char& at ( size_t pos ) const;
      char& at ( size_t pos );

Get character in string

Returns the character at position pos in the string.

This member function behaves as operator[] , except that at also performs a range check, throwing an exception of type out_of_range in case that pos is not an actual position in the string.

Parameters

pos

Position within the string of the character to be retrieved. Notice that the first character in the string has position 0.
If the position passed is past the end of str, an out_of_range exception is thrown.
size_t is an unsigned integral type.

Return value

Example

// string::at
#include <iostream>
#include <string>
using namespace std;

int main ()
{
  string str ("Test string");
  int i;
  for (i=0; i < str.length(); i++)
  {
    cout << str.at(i);
  }
  return 0;
}

This code prints out the content of a string character by character using the at member function.

Basic template member declaration

typedef typename Allocator::const_reference const_reference;
typedef typename Allocator::reference       reference;
typedef typename Allocator::size_type       size_type;
const_reference at ( size_type pos ) const;
reference       at ( size_type pos );

See also