Requisitos denominados de C++: FormattedOutputFunction

 

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

 

Requisitos denominados de C++

Básicos ConstruiblePorDefecto ConstruiblePorMovimiento (C++11) ConstruiblePorCopia AsignablePorCopia AsignablePorMovimiento (C++11) Destructible Props. de Tipos TipoEscalar TipoPOD TrivialmenteCopiable (C++11) TipoTrivial (C++11) TipoDeDiseñoEstándar (C++11)   TipoDeTiempoDeVidaImplícito Toda la biblioteca ComprobableBooleano ComparableEnIgualdad ComparableEnMenorQue Intercambiable IntercambiableEnValor (C++11) NullablePointer (C++11) Hash (C++11) Asignador ObjetoFunción Invocable Predicado PredicadoBinario Comparar

Contenedores Contenedor ContenedorReversible ContenedorConscienteDeAsignador ContenedorDeSecuencia ContenedorContiguo (C++17) ContenedorAsociativo ContenedorAsociativoNoOrdenado (C++11)   Elementos de contenedores InsertablePorDefecto (C++11) InsertablePorCopia (C++11) InsertablePorMovimiento (C++11) ConstruiblePorEmplazamiento (C++11) Borrable (C++11) Iteradores IteradorLegado IteradorDeEntradaLegado IteradorDeSalidaLegado IteradorDeAvanceLegado IteradorBidireccionalLegado IteradorDeAccesoAleatorioLegado IteradorContiguoLegado (C++17) IteradorConstexpr (C++20) E/S de flujos FunciónDeEntradaConFormato FunciónDeEntradaSinFormato FunciónDeSalidaConFormato FunciónDeSalidaSinFormato Formateadores FormateadorBásico (C++20) Formateador (C++20)

Números aleatorios SeedSequence (C++11) MotorDeNúmerosAleatorios (C++11) DistribuciónDeNúmerosAleatorios (C++11) GeneradorDeBitsAleatorioUniforme (C++11) AdaptadorDeMotorDeNúmerosAleatorios (C++11) Concurrencia BloqueableBásico (C++11) Bloqueable (C++11) BloqueableTemporizado (C++11) BloqueableCompartido (C++14) BloqueableTemporizadoCompartido (C++14) Mutex (C++11) MutexTemporizado (C++11) MutexCompartido (C++17) MutexTemporizadoCompartido (C++14) Rangos ObjetoAdaptadorDeRango (C++20) ObjetoCierreAdaptadorDeRango (C++20) Vista multidimensional LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) Otros RasgosDeCarácter RasgosDeExpresiónRegular (C++11)   TipoMáscaraDeBits TipoLiteral (C++11) TipoNumérico RasgoDeTipoUnario (C++11) RasgoDeTipoBinario (C++11) RasgoDeTransformación (C++11) Reloj (C++11) RelojTrivial (C++11)

 

Requisitos

See More

Una FormattedOutputFunction es una función de flujo de salida que realiza lo siguiente:

• Construye un objeto de tipo basic_ostream::sentry con duración automática de almacenamiento, lo que realiza lo siguiente:

• Si eofbit o badbit se activan en el flujo de salida, también se activa el failbit, y si se habilitan excepciones en failbit para la exception mask de este flujo de entrada ((exceptions() & failbit) != 0), lanza ios_base::failure.
• Vacía el flujo de salida atado, si aplica.

• Valida el estado del centinela por medio del llamado a sentry::operator bool(), lo que equivale a basic_ios::good.
• Si el centinela devolvió false, o el constructor del centinela lanzó una excepción, no se genera ninguna salida.
• Si el centinela devolvió true, intenta crear la salida deseada insertando los caracteres en el flujo de salida, como si fuera un llamado a rdbuf()->sputc(). Otros miembros públicos de std::basic_ostream también pueden ser usados, pero nunca serán llamados los miembros virtuales de rdbuf(), a excepción de overflow(), xsputn() y sync().

• Si la salida no se pudo generar, activa failbit. Si se habilitan excepciones en failbit para la exception mask de este flujo ((exceptions() & failbit) != 0), lanza ios_base::failure.
• Si se lanza una excepción en la salida, se activa badbit en el flujo de salida. Si se habilitan excepciones en badbit para la exception mask ((exceptions() & badbit) != 0) de este flujo, la excepción es relanzada.
• Si no se lanza ninguna excepción, devuelve *this.

• En cualquier caso, ya sea terminando por excepción o devolviendo un valor, el destructor del centinela es llamado antes de salir de esta función.

Relleno

Las funciones de salida formateada determinan el relleno de acuerdo a std::num_put::do_put() etapa 3.

(hasta C++14)

Si una función de salida formateada de un flujo os determina que debe haber relleno, lo hace de la siguiente manera. Dada una secuencia seq de caracteres CharT, donde CharT es el tipo contenedor de caracteres de os, si la longitud de seq es menor que os.width(), entonces se agregan suficientes copias de os.fill() a esta secuencia, según se requiera rellenar hasta el ancho de los caracteres os.width(). Si (os.flags() & std::ios_base::adjustfield) == std::ios_base::left es true, los caracteres de relleno se ubicarán después de la secuencia; de lo contrario, se ubicarán antes de la secuencia.

(desde C++14)

Biblioteca estándar

Las siguientes son funciones de la biblioteca estándar que corresponden a funciones FormattedOutputFunction.

• basic_ostream::operator<<(std::basic_ostream&, int / long / double / void* / bool)
• operator<<(std::basic_ostream&, char)
• operator<<(std::basic_ostream&, char*)
• operator<<(std::basic_ostream&, const std::bitset&)
• operator<<(std::basic_ostream&, const std::basic_string&)
• operator<< , cuando se llama sobre el valor devuelto de std::put_money

operator<<(std::basic_ostream&, std::basic_string_view)

(desde C++17)

print(std::ostream&, std::format_string<Args...>, Args&&...), println(std::ostream&, std::format_string<Args...>, Args&&...), vprint_unicode(std::ostream&, std::string_view, std::format_args), vprint_nonunicode(std::ostream&, std::string_view, std::format_args), excepto que (el os dado es un objeto de flujo de salida): Cualquier excepción lanzada por el llamado a std::vformat se propaga sin importar el valor de os.exceptions() y sin activar std::ios_base::badbit en el estado de error de os; Si la inserción en os falla, se llama a os.setstate(ios_base::badbit) (lo que puede lanzar std::ios_base::failure).

(desde C++23)

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 160	C++98	El proceso de determinar si la excepción atrapada es relanzada o no, hacía mención a una función exception() no existente	Corregido a exceptions()
LWG 165	C++98	El único miembro virtual al que se le permite ser llamado por rdbuf() era overflow()	También se les permite a xsputn() y sync()