Requisitos denominados de C++:FormattedInputFunction

 

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 FormattedInputFunction es una función de flujo de entrada que realiza lo siguiente:

• Construye un objeto de tipo basic_istream::sentry con duración de almacenamiento automática y con el argumento noskipws establecido a false, que realiza los siguiente:

• si eofbit o badbit están establecidos en el flujo de entrada, también se establece failbit, y, si las excepciones failbit están habilitadas en la máscara de excepciones de este flujo de entrada ((exceptions()& failbit)!=0), lanza la excepción ios_base::failure.
• vacía el flujo de salida ligado por tie(), si corresponde.
• si el indicador ios_base::skipws está establecido en el flujo de entrada, extrae y descarta caracteres del flujo de entrada hasta que una de las condiciones siguientes sea verdadera:

• el siguiente carácter disponible en el flujo de entrada no es un carácter de espacio en blanco, como se prueba mediante la faceta std::ctype de la configuración regional actualmente imbuida en este flujo de entrada. El carácter que no es un espacio en blanco no se extrae.
• se alcanza el final del flujo, en cuyo caso se establecen failbit y eofbit y, si el flujo está activado por excepciones de uno de esos bits, se lanza la excepción ios_base::failure.

• Comprueba el estado del centinela llamando a sentry::operator bool(), que es equivalente a basic_ios::good.
• Si el centinela devolvió false o el constructor lanzó una excepción, no se realiza ninguna entrada.
• Si el centinela devolvió true, se realiza la entrada como con una llamada a rdbuf()->sbumpc() o rdbuf()->sgetc().

• si se alcanza el final del flujo (la llamada a rdbuf()->sbumpc() o rdbuf()->sgetc() devuelve Traits::eof()), estabelce eofbit. Si la excepción eofbit está habilitada en la máscara de excepciones de este flujo ((exceptions()& eofbit)!=0), se lanza la excepción ios_base::failure.
• si se lanza una excepción durante la entrada, se establece badbit en el flujo de entrada. Si las excepciones badbit están habilitadas en la máscara de excepciones de este flujo ((exceptions()& badbit)!=0), también se vuelve a lanzar la excpeción.
• Si no se lanza ninguna excepción, devuelve *this.

• En cualquier caso, se termine por excepción o retornando, 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 FormattedInputFunction.

• basic_istream::operator>>(int, long, double, void*, bool)
• operator>>(std::basic_istream, char&)
• operator>>(std::basic_istream, char*)
• operator>>(std::basic_istream, std::bitset)
• operator>>(std::basic_istream, std::string)
• operator>>, cuando se llama en el valor de retorno de std::get_money

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 capturada se vuelve a lanzar menciona una función inexistente, exception().	Se corrigió a exceptions().