at() [2/4]

template<typename _CharT, typename _Traits, typename _Alloc>

reference std::basic_string< _CharT, _Traits, _Alloc >::at ( size_type __n )

inline

Provides access to the data contained in the string.

Parameters

__n	The index of the character to access.

Returns

Read/write reference to the character.

Exceptions

std::out_of_range

If n is an invalid index.

This function provides for safer data access. The parameter is first checked that it is in the range of the string. The function throws out_of_range if the check fails. Success results in unsharing the string.

Definition at line 1192 of file cow_string.h.

      {
      if (__n >= size())
        __throw_out_of_range_fmt(__N("basic_string::at: __n "
                               "(which is %zu) >= this->size() "
                               "(which is %zu)"),
                           __n, this->size());
      _M_leak();
      return _M_data()[__n];
      }