std::basic_string::at
De cppreference.com
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 carcter en la ubicacin pos especificada. Se realiza la comprobacin de lmites, y se lanzar la excepcin de tipo std::out_of_range si el acceso es invlido.
Parmetros
| pos | - | La posicin del carcter a devolver. |
Valor de retorno
Una referencia al carcter solicitado.
Excepciones
Lanza std::out_of_range si pos >= size().
Complejidad
Constante
Ejemplo
Ejecuta este cdigo
#include <stdexcept>
#include <iostream>
#include <string>
int main()
{
std::string s("mensaje"); // para capacidad
s = "abc";
s.at(2) = 'x'; // de acuerdo
std::cout << s << '\n';
std::cout << "no. de elementos = " << s.size() << '\n';
std::cout << "capacidad = " << s.capacity() << '\n';
try {
// lanza, incluso si la capacidad permitiera acceder al elemento
s.at(3) = 'x';
}
catch (std::out_of_range const& exc) {
std::cout << exc.what() << '\n';
}
}
Posible salida:
abx
no. de elementos = 3
capacidad = 7
basic_string::at
Vase tambin
| Accede al carcter especificado (funcin miembro pblica) |