substr() [2/2]

template<typename _CharT, typename _Traits, typename _Alloc>

basic_string std::basic_string< _CharT, _Traits, _Alloc >::substr ( size_type __pos = 0, size_type __n = npos ) const

inline

Get a substring.

Parameters

__pos	Index of first character (default 0).
__n	Number of characters in substring (default remainder).

Returns

The new string.

Exceptions

std::out_of_range

If __pos > size().

Construct and return a new string using the __n characters starting at __pos. If the string is too short, use the remainder of the characters. If __pos is beyond the end of the string, out_of_range is thrown.

Definition at line 2918 of file cow_string.h.

      { return basic_string(*this,
                      _M_check(__pos, "basic_string::substr"), __n); }