std::basic_string_view<CharT,Traits>::at

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de cadenas

Cadenas terminadas en nulo

Cadenas de bytes

Cadenas multibyte

De caracteres anchos

Clases

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string_view

Funciones miembro basic_string_view::basic_string_view basic_string_view::operator= Iteradores basic_string_view::beginbasic_string_view::cbegin basic_string_view::endbasic_string_view::cend basic_string_view::rbeginbasic_string_view::crbegin basic_string_view::rendbasic_string_view::crend Acceso a elementos basic_string_view::at basic_string_view::operator[] basic_string_view::front basic_string_view::back basic_string_view::data Capacidad basic_string_view::sizebasic_string_view::length basic_string_view::max_size basic_string_view::empty Modificadores basic_string_view::remove_prefix basic_string_view::remove_suffix basic_string_view::swap

Operaciones basic_string_view::copy basic_string_view::substr basic_string_view::compare basic_string_view::starts_with (C++20) basic_string_view::ends_with (C++20) basic_string_view::find basic_string_view::rfind basic_string_view::find_first_of basic_string_view::find_last_of basic_string_view::find_first_not_of basic_string_view::find_last_not_of Constantes basic_string_view::npos Funciones no miembro operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20) operator<< operator""sv Clases auxiliares hash<std::string_view>hash<std::wstring_view>hash<std::u8string_view>hash<std::u16string_view>hash<std::u32string_view> (C++20) Guías de deducción(C++20)

 

<tbody> </tbody>

constexpr const_reference at(size_type pos) const;		(desde C++17)

See More

Devuelve una referencia const al carácter en la ubicación especificada pos. Se realiza comprobación de límites. Se lanza una excepción de tipo std::out_of_range en caso de acceso inválido.

Parámetros

pos

-

Posición del carácter a devolver.

Valor de retorno

Referencia const al carácter solicitado.

Excepciones

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

Complejidad

Constante.

Ejemplo

Ejecuta este código

#include <iostream>
#include <stdexcept>    // para std::out_of_range
#include <string_view>

int main()
{
    std::string_view str_view("abcdef");

    try {
        for (std::size_t i = 0; true; ++i)
            std::cout << i << ": " << str_view.at(i) << '\n';
    }
    catch (const std::out_of_range& e) {
        std::cout << "Huy. Subindice fuera de rango.\n";
        std::cout << e.what() << '\n';
    }
}

Posible salida:

0: a
1: b
2: c
3: d
4: e
5: f
6: Huy. Subindice fuera de rango.
basic_string_view::at: __pos (which is 6) >= this->size() (which is 6)

Véase también

operator[]

Accede al carácter especificado. (función miembro pública)