std::basic_format_parse_context

 

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 servicios

Apoyo del lenguaje Apoyo de tipos (tipos básicos, RTTI) Biblioteca de macros de prueba de característica (C++20) Servicios del programa Apoyo de corrutinas (C++20) Funciones variádicas is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Comparación de tres vías three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Servicios generales Objetos función Manipulación de bits (C++20) bitset hash (C++11) Operadores relacionales (en desuso en C++20) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Funciones de comparación de enteros cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Intercambio y operaciones de tipos swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Tipos vocabulario comunes pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

Biblioteca de formato

Funciones de formato

format (C++20)

format_to (C++20)

format_to_n (C++20)

formatted_size (C++20)

vformat (C++20)

vformat_to (C++20)

Formateador

formatter (C++20)

basic_format_parse_contextformat_parse_contextwformat_parse_context (C++20)(C++20)(C++20)

basic_format_contextformat_contextwformat_context (C++20)(C++20)(C++20)

Argumentos de formato

basic_format_arg (C++20)

basic_format_argsformat_argswformat_argsformat_args_t (C++20)(C++20)(C++20)(C++20)

visit_format_arg (C++20)

make_format_argsmake_wformat_args (C++20)(C++20)

Error de formato

format_error (C++20)

 

<tbody> </tbody>

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)

See More

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

<tbody> </tbody>

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

<tbody> </tbody>

constexpr const_iterator begin() const noexcept;

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

std::basic_format_parse_context::end

<tbody> </tbody>

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

<tbody> </tbody>

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

<tbody> </tbody>

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

<tbody> </tbody>

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