Espacios de nombres
Variantes
Acciones

std::basic_format_context

De cppreference.com
< cpp‎ | utility‎ | format
 
 
Biblioteca de servicios
 
Biblioteca de formato
Funciones de formato
(C++20)
(C++20)
(C++20)
(C++20)
Formateador
(C++20)
basic_format_contextformat_contextwformat_context
(C++20)(C++20)(C++20)
Argumentos de formato
Error de formato
 
Definido en el archivo de encabezado <format>
template<class OutputIt, class CharT>
class basic_format_context;
(1) (desde C++20)
using format_context = basic_format_context</* no especificado */, char>;
(2) (desde C++20)
using wformat_context = basic_format_context</* no especificado */, wchar_t>;
(3) (desde C++20)

Proporciona acceso al estado de formato que consiste de los argumentos de formato y el iterador de salida.

El comportamiento no está definido si OutputIt no modela a std::output_iterator<const CharT&>.

2) El argumento de plantilla no especificado es un iterador de salida que añade a std::string, tal como std::back_insert_iterator<std::string>. Se recomienda a las implementaciones que utilicen un iterador a un tipo de búfer con borrado de tipo que soporte añadir a cualquier contenedor contiguo y redimensionable.
3) El argumento de plantilla no especificado es un iterador de salida que añade a std::wstring.

Contenido

[editar] Tipos miembro

Tipo Definición
iterator OutputIt
char_type CharT

[editar] Plantillas de alias miembro

Tipo Definición
formatter_type<T> std::formatter<T, CharT>

[editar] Funciones miembro

arg
Devuelve el argumento en el índice dado.
(función miembro pública)
locale
Devuelve la configuración regional utilizada para el formato específico de la configuración regional.
(función miembro pública)
out
Devuelve un iterador a un búfer de salida.
(función miembro pública)
advance_to
Avanza el iterador de salida a la posición dada.
(función miembro pública)

std::basic_format_context::arg

std::basic_format_arg<basic_format_context> arg(std::size_t id) const;

Devuelve un std::basic_format_arg que alberga el id-ésimo argumento en args, donde args es el paquete de parámetros u objeto std::basic_format_args pasado a la función de formato.

Si id no es menor que el número de argumentos de formato, devuelve un std::basic_format_arg construido por defecto (que alberga un objeto std::monostate).

std::basic_format_context::locale

std::locale locale();

Devuelve la configuración regional a la función de formato, o una configuración regional (std::locale) construida por defecto si la función de formato no toma una configuración regional.

std::basic_format_context::out

iterator out();

Devuelve el iterador al búfer de salida.

std::basic_format_context::advance_to

void advance_to(iterator it);

Establece el iterador a it. Después de una llamada a advance_to, las llamadas subsecuentes a out() devolverán una copia de it.

[editar] Ejemplo

[editar] Véase también