std::basic_string::at
De cppreference.com
< cpp | string | basic string
| 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 carácter en la ubicación pos especificada. Se realiza la comprobación de límites, y se lanzará la excepción de tipo std::out_of_range si el acceso es inválido.
Contenido |
[editar] Parámetros
| pos | - | La posición del carácter a devolver. |
[editar] Valor de retorno
Una referencia al carácter solicitado.
[editar] Excepciones
Lanza std::out_of_range si pos >= size().
[editar] Complejidad
Constante
[editar] Ejemplo
Ejecuta este código
#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
[editar] Véase también
| Accede al carácter especificado (función miembro pública) |
