Espacios de nombres
Variantes
Acciones

std::array::at

De cppreference.com
< cpp‎ | container‎ | array
 
 
 
 
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.

Contenido

[editar]Parámetros

pos - La posición del elemento a devolver.

[editar]Valor de retorno

Una referencia al elemento solicitado, es decir, *(a.begin()+ pos).

[editar]Excepciones

std::out_of_range si pos >= size().

[editar]Complejidad

Constante.

[editar]Ejemplo

#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 2std::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 =[]{returnstd::chrono::system_clock::now().time_since_epoch().count()%8;}; data.at(data.size()+ moon_phase())=13;}catch(conststd::out_of_range& ex){std::cout<< ex.what()<<'\n';}   // Imprimir valores finalesstd::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

[editar]Véase también

(C++11)
Accede el elemento especificado.
(función miembro pública)[editar]
close