std::basic_format_parse_context
| 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.
[editar] 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 |
[editar] 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) | |
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.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.
[editar] Ejemplo
| Esta sección está incompleta Razón: sin ejemplo |
