Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. — Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is an older version of Boost and was released in 2024. The current version is 1.90.0.

array::at (3 of 3 overloads)

array::at (3 of 3 overloads)

Access an element, with bounds checking.

Synopsis

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

Description

Returns a reference to the element specified at location pos, with bounds checking. If pos is not within the range of the container, an exception of type boost::system::system_error is thrown.

Complexity

Constant.

Parameters

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

Exceptions

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