◐ Shell
clean mode source ↗

std::basic_format_parse_context - cppreference.com

De cppreference.com

Definido en el archivo de encabezado <format>

template<class CharT> class basic_format_parse_context;

 (1) (desde C++20)

using format_parse_context = basic_format_parse_context<char>;

 (2) (desde C++20)

using wformat_parse_context = basic_format_parse_context<wchar_t>;

 (3) (desde C++20)

Proporciona acceso al estado del análisis de la cadena de formato que consiste del rango de la cadena de formato que se está analizando y el contador de argumentos para la indexación automática.

Se pasa una instancia de basic_format_parse_context a Formatter al analizar la especificación de formato.

Tipos miembro

Tipo Definición
char_type CharT
iterator std::basic_string_view<CharT>::const_iterator
const_iterator std::basic_string_view<CharT>::const_iterator

Funciones miembro

(constructor)

 Construye una instancia de std::basic_format_parse_context a partir de una cadena de formato y una cuenta de argumentos.
(función miembro pública)

operator=

[eliminada]

 std::basic_format_parse_context no es copiable.
(función miembro pública)

begin

 Devuelve un iterador al comienzo del rango de la cadena de formato.
(función miembro pública)

end

 Devuelve un iterador al final del rango de la cadena de formato.
(función miembro pública)

advance_to

 Avanza el iterador del comienzo a la posición dada.
(función miembro pública)

next_arg_id

 Ingresa a la modalidad de indexación automática y devuelve el índice del siguiente argumento.
(función miembro pública)

check_arg_id

 Ingresa a la modalidad de indexación manual y comprueba si el índice del argumento dado se encuentra dentro del rango.
(función miembro pública)

std::basic_format_parse_context::basic_format_parse_context

constexpr explicit basic_format_parse_context(std::basic_string_view<CharT> fmt, std::size_t num_args = 0) noexcept;

 (1)

basic_format_parse_context(const basic_format_parse_context&) = delete;

 (2)

1) Construye una instancia de std::basic_format_parse_context. Inicializa el rango de la cadena de formato a [fmt.begin(), fmt.end()), y la cuenta de argumentos a num_args.

2) El constructor de copia está eliminado. std::basic_format_parse_context no es copiable.

std::basic_format_parse_context::begin

constexpr const_iterator begin() const noexcept;

Devuelve un iterador al comienzo del rango de la cadena de formato.

std::basic_format_parse_context::end

constexpr const_iterator end() const noexcept;

Devuelve un iterador al final del rango de la cadena de formato.

std::basic_format_parse_context::advance_to

constexpr void advance_to(const_iterator it);

Establece el comienzo del rango de la cadena de formato a it. Después de una llamada a advance_to, las llamadas subsecuentes a begin() devolverán una copia de it.

El comportamiento no está definido si end() no se puede alcanzar desde it.

std::basic_format_parse_context::next_arg_id

constexpr std::size_t next_arg_id();

Ingresa a la modalidad de indexación de argumento automática y devuelve el índice del siguiente argumento, iniciando de 0.

Si *this ya ha ingresado a la modalidad de indexación de argumento manual, lanza std::format_error.

std::basic_format_parse_context::check_arg_id

constexpr void check_arg_id(std::size_t id);

Ingresa a la modalidad de indexación de argumento manual.

Si *this ya ha ingresado a la modalidad de indexación de argumento automática, lanza std::format_error.

Si id es mayor que o igual a la cuenta de argumentos proporcionada en el constructor, la llamada no es una expresión constante.

Ejemplo

Véase también