string::at

`string::at`

Return a character with bounds checking.

Synopsis

char&
at(
    std::size_t pos,
    boost::source_location const& loc = BOOST_CURRENT_LOCATION); (1)

char const&
at(
    std::size_t pos,
    boost::source_location const& loc = BOOST_CURRENT_LOCATION) const; (2)

Description

Returns a reference to the character specified at location pos.

Complexity

Constant.

Exception Safety

Strong guarantee.

Parameters

Name Description

Name	Description
`pos`	A zero-based index to access.
`loc`	`source_location` to use in thrown exception; the source location of the call site by default.

pos

A zero-based index to access.

loc

source_location to use in thrown exception; the source location of the call site by default.

Exceptions

Type Thrown On

Type	Thrown On
`boost::system::system_error`	`pos >= size()`.

boost::system::system_error

pos >= size().

Edit this page