Requisitos denominados de C++:UnformattedInputFunction

 

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

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

• Si están establecidos eofbit o badbit en el flujo de entrada, también establece failbit y, si las excepciones en 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.
• Limpia el flujo de salida tie(), si corresponde.

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

• Si el operador devuelve false o el constructor de sentry lanza una excepción:

• Establece el número de caracteres extraídos (gcount) en el flujo de entrada en cero.
• Si se llamó a la función para escribir en un array de CharT, escribe CharT() (el carácter nulo) en la primera ubicación del array.

• Si el operador devuelve true, realiza la entrada como si llamara a rdbuf()->sbumpc() o rdbuf()->sgetc().

• Si se alcanza el final del flujo (la llamada a rdbuf()->sbumpc() o rdbuf()->sgetc() devuelve Traits::eof()), se establece eofbit. Si las excepciones en eofbit están habilitadas en la máscara de exccepciones de este flujo ((exceptions()& eofbit)!=0), lanza la excepción ios_base::failure.
• Si se genera 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), la excepción también se vuelve a generar.

• Las excepciones lanzadas desde basic_ios::clear no se capturan ni se relanzan.

• Si no se lanzó ninguna excepción durante la entrada, establece la cantidad de caracteres extraídos (gcount) en el flujo de entrada.

3) En cualquier caso, ya sea terminando 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 FunciónDeEntradaSinFormato.

• std::getline, excepto que no modifica gcount.
• basic_istream::operator>>(basic_streambuf*)
• basic_istream::get
• basic_istream::getline
• basic_istream::ignore
• basic_istream::peek
• basic_istream::read
• basic_istream::readsome
• basic_istream::putback, excepto que primero borra eofbit
• basic_istream::unget, excepto que primero borra eofbit
• basic_istream::sync, excepto que no modifica gcount
• basic_istream::tellg, excepto que no modifica gcount
• basic_istream::seekg, excepto que primero borra eofbit y no modifica gcount
• std::ws, excepto que no modifica gcount

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 61	C++98	No estaba claro si lanzar un excepción debido a la configuración de eofbit y/o failbit resultaba en la configuración de badbit.	Las excepciones lanzadas desde basic_ios::clear no se capturan ni se vuelven a lanzar.
LWG 160	C++98	El proceso de determinar si la excepción capturada se vuelve a generar menciona una función inexistente, exception().	Corregido a exceptions().
LWG 243	C++98	No se especificaba el comportamiento cuando sentry::operator bool() devuelve false o el objeto centinela no se puede construir.	Se especifica.