Requisitos denominados de C++: UnformattedOutputFunction

 

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

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

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

• Si eofbit o badbit están configurados en el flujo de salida, también configura failbit y, si las excepciones en failbit están habilitadas en la máscara de excepciones de este flujo de salida ((exceptions() & failbit) != 0), lanza ios_base::failure.
• Vacía el flujo de salida ligado por tie(), si corresponde.

2) Verifica el estado del centinela llamando a sentry::operator bool(), que es equivalente a basic_ios::good.

• Si el operador devuelve false o el constructor del centinela lanza una excepción, no se produce ninguna salida.
• Si el operador devuelve true, intenta realizar la salida deseada insertando los caracteres en el flujo de salida como si llamara a rdbuf()->sputc(). También se pueden usar otros miembros públicos de std::basic_ostream, pero nunca se llamarán a los miembros virtuales de rdbuf() excepto overflow(), xsputn() y sync().

• Si se lanza una excepción durante la salida, establece badbit en el flujo de salida. Si las excepciones en badbit están habilitadas en la máscara de excepciones de este flujo ((exceptions() & badbit) != 0), la excepción también se vuelve a lanzar.
• Si no se lanzó ninguna excepción, devuelve el valor especificado por la función.

3) En cualquier caso, ya sea que se termine por excepción o por retorno, se llama al destructor del centinela antes de salir de esta función.

Biblioteca estándar

Las siguientes funciones de la biblioteca estándar son UnformattedOutputFunction.

• basic_ostream::operator<<(basic_streambuf*)
• basic_ostream::put
• basic_ostream::write
• basic_ostream::flush

basic_ostream::tellp (excepto que llama a pubseekoff en lugar de a la salida) basic_ostream::seekp (excepto que llama a pubseekoff o pubseekpos en lugar de a la salida)

(desde C++11)

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 63	C++98	Faltaba la política de manejo de excepciones.	Se agregó.
LWG 160	C++98	El proceso de determinar si la excepción capturada se vuelve a generar mencionó una función inexistente exception().	Se corrigió a exceptions().
LWG 165	C++98	El único miembro virtual que se podía llamar en rdbuf() era overflow().	También se permitía xsputn() y sync().