std::array::at
De cppreference.com
<tbody>
</tbody>
reference at( size_type pos ); |
(1) | (desde C++11) (constexpr desde C++17) |
const_reference at( size_type pos ) const; |
(2) | (desde C++11) (constexpr desde C++14) |
Devuelve una referencia al elemento en la ubicación especificada pos, con verificación de límites.
Si pos no está dentro del rango de container, se genera una excepción de tipo std::out_of_range.
Parámetros
| pos | - | La posición del elemento a devolver. |
Valor de retorno
Una referencia al elemento solicitado, es decir, *(a.begin() + pos).
Excepciones
std::out_of_range si pos >= size().
Complejidad
Constante.
Ejemplo
Ejecuta este código
#include <chrono>
#include <cstddef>
#include <iostream>
#include <array>
#include <stdexcept>
int main()
{
std::array<int, 6> data{1, 2, 4, 5, 5, 6};
// Establecer el elemento 1
data.at(1) = 88;
// Leer el elemento 2
std::cout << "El elemento en el índice 2 tiene un valor " << data.at(2) << '\n';
std::cout << "tamaño de data = " << data.size() << '\n';
try
{
// Intentar establecer un elemento en una posición aleatoria >= size()
auto moon_phase = []
{
return std::chrono::system_clock::now().time_since_epoch().count() % 8;
};
data.at(data.size() + moon_phase()) = 13;
}
catch(const std::out_of_range& ex)
{
std::cout << ex.what() << '\n';
}
// Imprimir valores finales
std::cout << "data:";
for (int elem : data)
std::cout << ' ' << elem;
std::cout << '\n';
}
Posible salida:
El elemento en el índice 2 tiene un valor 4
tamaño de data = 6
array::at: __n (que es 8) >= _Nm (que es 6)
data: 1 88 4 5 5 6
Véase también
(C++11) |
Accede el elemento especificado. (función miembro pública) |