public member function

std::string::at

<string>
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

The character at the specified position in the string.

Example

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

int main ()
{
  string str ("Test string");
  for (size_t 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

( basic_string<charT,traits,Allocator> )
1
2
3
4
5
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