Namespaces
Variants

    std::ranges::cbegin

    De es.cppreference.net
     
    C++
    Soporte del compilador
    Independiente y alojado
    Lenguaje
    Biblioteca estándar
    Encabezados de la biblioteca estándar
    Requisitos nombrados
    Macros de prueba de características (C++20)
    Biblioteca de soporte 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 utilidades 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 soporte de concurrencia (C++11)
    Biblioteca de control de ejecución (C++26)
    Especificaciones técnicas
    Índice de símbolos
    Bibliotecas externas
     
    Biblioteca de rangos
    Adaptadores de rango
     
    Definido en el encabezado <ranges>
    Definido en el encabezado <iterator> 
    inline namespace /* unspecified */ {
    inline constexpr /* unspecified */ cbegin = /* unspecified */;
}
    		(desde C++20)
    (objeto de punto de personalización)
    Firma de llamada
    		 
    template< class T >
    requires /* see below */
constexpr /* see below */ auto cbegin( T&& t );
    		(desde C++20)

    Devuelve un iterador al primer elemento del argumento calificado como const.

    		(hasta C++23)

    Devuelve un iterador constante al primer elemento del argumento.

    		(desde C++23)

    Sea CT

    • const std::remove_reference_t<T>& si el argumento es un lvalue (es decir, T es un tipo de referencia lvalue),
    • const T en caso contrario.

    Una llamada a ranges::cbegin es equivalente a la expresión de ranges::begin(static_cast<CT&&>(t)).

    		(hasta C++23)

    Si el argumento es un lvalue o ranges::enable_borrowed_range<std::remove_cv_t<T>> es true, entonces una llamada a ranges::cbegin es equivalente a la expresión a:

    • std::const_iterator<decltype(U)>(U) para alguna expresión U equivalente a ranges::begin(possibly-const-range(t).

    En todos los demás casos, una llamada a ranges::cbegin está mal formada, lo que puede resultar en fallo de sustitución cuando la llamada aparece en el contexto inmediato de una instanciación de plantilla.

    		(desde C++23)

    El tipo de retorno modela std::input_or_output_iterator y constant-iterator(desde C++23) en todos los casos.

    Objetos de punto de personalización

    El nombre ranges::cbegin denota un objeto de punto de personalización , que es un objeto función constante de un tipo de clase literal semiregular . Consulte CustomizationPointObject para más detalles.

    Notas

    Para un rango lvalue e de tipo T , ranges :: cbegin ( e ) es equivalente a

    ranges:: begin ( std:: as_const ( e ) ) .

    		(hasta C++23)
    (desde C++23)

    Ejemplo

    Ejecutar este código 
    #include <cassert>
#include <ranges>
#include <vector>
int main()
{
    std::vector v{3, 1, 4};
    auto vi = std::ranges::cbegin(v);
    assert(3 == *vi);
    ++vi; // OK, el objeto iterador constante es mutable
    assert(1 == *vi);
    // *vi = 13; // Error: el iterador constante apunta a un elemento inmutable
    int a[]{3, 1, 4};
    auto ai = std::ranges::cbegin(a); // cbegin también funciona con arrays de C
    assert(3 == *ai and *(ai + 1) == 1);
    // *ai = 13; // Error: la variable de solo lectura no es asignable
}

    Véase también

    (C++20)
    		devuelve un iterador al inicio de un rango
    (objeto de punto de personalización)
    (C++11) (C++14)
    		devuelve un iterador al inicio de un contenedor o array
    (plantilla de función)