std::vector::at

 

C++

Lenguaje

Archivos de encabezado de la biblioteca estándar

Implementaciones independientes y albergadas

Requerimientos denominados

Biblioteca de soporte del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de utilerías

Biblioteca de cadenas

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca numérica

Biblioteca de entrada/salida

Biblioteca de localizaciones

Biblioteca de expresiones regulares (C++11)

Biblioteca de operaciones atómicas (C++11)

Biblioteca de soporte de hilos (C++11)

Biblioteca de sistema de archivos (C++17)

Especificaciones técnicas

 

Biblioteca de contenedores

array (C++11)

vector

deque

forward_list (C++11)

list

set

multiset

map

multimap

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

stack

queue

priority_queue

span (C++20)

 

std::vector

Funciones miembro

vector::vector

vector::~vector

vector::operator=

vector::assign

vector::get_allocator

Acceso a elementos

vector::at

vector::operator[]

vector::front

vector::back

vector::data (C++11)

Iteradores

vector::beginvector::cbegin (C++11)

vector::endvector::cend (C++11)

vector::rbeginvector::crbegin (C++11)

vector::rendvector::crend (C++11)

Capacidad

vector::empty

vector::size

vector::max_size

vector::reserve

vector::capacity

vector::shrink_to_fit (C++11)

Modificadores

vector::clear

vector::insert

vector::emplace (C++11)

vector::erase

vector::push_back

vector::emplace_back (C++11)

vector::pop_back

vector::resize

vector::swap

Funciones no miembro

std::swap

eraseerase_if (C++20)(C++20)

operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20)

Guías de deducción(C++17)

 

reference at( size_type pos );		(hasta C++20)
constexpr reference at( size_type pos );		(desde C++20)
const_reference at( size_type pos ) const;		(hasta C++20)
constexpr const_reference at( size_type pos ) const;		(desde C++20)

Devuelve una referencia al elemento en una ubicación pos especificada, con comprobación de límites.

Si pos no se encuentra dentro del rango del contenedor, se lanza una excepción de tipo std::out_of_range.

Parámetros

pos

-

Posición del elemento a devolver.

Valor de retorno

Referencia al elemento solicitado.

Excepciones

std::out_of_range si !(pos < size()).

Complejidad

Constante.

Ejemplo

Ejecuta este código

#include <iostream>
#include <vector>
 
int main()
{
    std::vector<int> datos = { 1, 2, 4, 5, 5, 6 };
 
    // Establecer elemento 1
    datos.at(1) = 88;
 
    // Leer elemento 2
    std::cout << "Elemento en el subíndice 2 tiene el valor " << datos.at(2) << '\n';
 
    std::cout << "tamaño de datos = " << datos.size() << '\n';
 
    try {
        // Establecer elemento 6
        datos.at(6) = 666;
    } catch (std::out_of_range const& exc) {
        std::cout << exc.what() << '\n';
    }
 
    // Imprimir valores finales
    std::cout << "datos:";
    for (int elem : datos)
        std::cout << " " << elem;
    std::cout << '\n';
}

Posible salida:

Elemento en el subíndice 2 tiene el valor 4
tamaño de datos = 6
vector::_M_range_check: __n (que es 6) >= this->size() (que es 6)
datos: 1 88 4 5 5 6

Véase también

operator[]

Accede al elemento especificado (función miembro pública)