std:: basic_istream
|
Definido en el encabezado
<istream>
|
||
|
template
<
class
CharT,
|
||
La plantilla de clase
basic_istream
proporciona soporte para operaciones de entrada de alto nivel en flujos de caracteres. Las operaciones soportadas incluyen entrada formateada (por ejemplo, valores enteros o caracteres separados por espacios en blanco y cadenas de caracteres) y entrada no formateada (por ejemplo, caracteres sin procesar y arreglos de caracteres). Esta funcionalidad se implementa en términos de la interfaz proporcionada por la clase subyacente
basic_streambuf
, accedida a través de la clase base
basic_ios
. El único miembro de datos no heredado de
basic_istream
, en la mayoría de implementaciones, es el valor devuelto por
basic_istream::gcount()
.
Diagrama de herencia
Se proporcionan varios typedefs para tipos de caracteres comunes:
|
Definido en el encabezado
<istream>
|
|
| Tipo | Definición |
std::istream
|
std :: basic_istream < char > |
std::wistream
|
std :: basic_istream < wchar_t > |
Contenidos |
Objetos globales
La biblioteca estándar proporciona dos objetos globales basic_istream.
|
Definido en el encabezado
<iostream>
|
|
|
lee desde el flujo de entrada estándar de C
stdin
(objeto global) |
|
Tipos de miembros
| Tipo de miembro | Definición |
char_type
|
CharT
|
traits_type
|
Traits
; el programa está mal formado si
Traits::char_type
no es
CharT
.
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
Funciones miembro
|
construye el objeto
(función miembro pública) |
|
|
[virtual]
|
destruye el objeto
(función miembro pública virtual) |
|
(C++11)
|
asigna por movimiento desde otro
basic_istream
(función miembro protegida) |
Entrada formateada |
|
|
extrae datos formateados
(función miembro pública) |
|
Entrada no formateada |
|
|
extrae caracteres
(función miembro pública) |
|
|
lee el siguiente carácter sin extraerlo
(función miembro pública) |
|
|
retrocede un carácter
(función miembro pública) |
|
|
devuelve un carácter al flujo de entrada
(función miembro pública) |
|
|
extrae caracteres hasta encontrar el carácter especificado
(función miembro pública) |
|
|
extrae y descarta caracteres hasta encontrar el carácter especificado
(función miembro pública) |
|
|
extrae bloques de caracteres
(función miembro pública) |
|
|
extrae bloques de caracteres ya disponibles
(función miembro pública) |
|
|
devuelve el número de caracteres extraídos por la última operación de entrada no formateada
(función miembro pública) |
|
Posicionamiento |
|
|
devuelve el indicador de posición de entrada
(función miembro pública) |
|
|
establece el indicador de posición de entrada
(función miembro pública) |
|
Miscelánea |
|
|
sincroniza con el dispositivo de almacenamiento subyacente
(función miembro pública) |
|
|
(C++11)
|
intercambia objetos de flujo, excepto el búfer asociado
(función miembro protegida) |
Clases miembro
|
implementa la lógica básica para la preparación del stream para operaciones de entrada
(clase miembro pública) |
Funciones no miembro
|
extrae caracteres y arreglos de caracteres
(plantilla de función) |
Heredado de std:: basic_ios
Tipos de miembro
| Tipo de miembro | Definición |
char_type
|
CharT
|
traits_type
|
Traits
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
Funciones miembro
Funciones de estado |
|
|
verifica que no ha ocurrido ningún error, es decir, las operaciones de E/S están disponibles
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
verifica si se ha alcanzado el fin de archivo
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
verifica si ha ocurrido un error
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
verifica si ha ocurrido un error irrecuperable
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
verifica si ha ocurrido un error (sinónimo de
fail()
)
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
verifica que no ha ocurrido ningún error (sinónimo de
!
fail()
)
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
devuelve los indicadores de estado
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
establece los indicadores de estado
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
modifica los indicadores de estado
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
Formato |
|
|
copia información de formato
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
gestiona el carácter de relleno
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
Misceláneos |
|
|
gestiona la máscara de excepciones
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
establece la configuración regional
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
gestiona el búfer de flujo asociado
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
gestiona el flujo vinculado
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
reduce caracteres
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
|
amplía caracteres
(función miembro pública de
std::basic_ios<CharT,Traits>
)
|
|
Heredado de std:: ios_base
Funciones miembro
Formato |
|
|
gestiona los indicadores de formato
(función miembro pública de
std::ios_base
)
|
|
|
establece un indicador de formato específico
(función miembro pública de
std::ios_base
)
|
|
|
limpia un indicador de formato específico
(función miembro pública de
std::ios_base
)
|
|
|
gestiona la precisión decimal de operaciones de punto flotante
(función miembro pública de
std::ios_base
)
|
|
|
gestiona el ancho de campo
(función miembro pública de
std::ios_base
)
|
|
Configuraciones regionales |
|
|
establece la configuración regional
(función miembro pública de
std::ios_base
)
|
|
|
devuelve la configuración regional actual
(función miembro pública de
std::ios_base
)
|
|
Arreglo extensible interno |
|
|
[static]
|
devuelve un entero único a nivel de programa que es seguro usar como índice para
pword()
y
iword()
(función miembro estática pública de
std::ios_base
)
|
|
redimensiona el almacenamiento privado si es necesario y accede al elemento
long
en el índice dado
(función miembro pública de
std::ios_base
)
|
|
|
redimensiona el almacenamiento privado si es necesario y accede al elemento
void
*
en el índice dado
(función miembro pública de
std::ios_base
)
|
|
Misceláneo |
|
|
registra función de callback de eventos
(función miembro pública de
std::ios_base
)
|
|
|
[static]
|
establece si las bibliotecas de E/S de C++ y C son interoperables
(función miembro estática pública de
std::ios_base
)
|
Clases miembro |
|
|
excepción de flujo
(clase miembro pública de
std::ios_base
)
|
|
|
inicializa objetos de flujo estándar
(clase miembro pública de
std::ios_base
)
|
|
Tipos de miembros y constantes |
|||||||||||||||||||||||||||||||||||||||
| Tipo | Explicación | ||||||||||||||||||||||||||||||||||||||
|
tipo de modo de apertura de flujo
También se definen las siguientes constantes:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
|
tipo de banderas de formato
También se definen las siguientes constantes:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
|
tipo de estado del flujo
También se definen las siguientes constantes:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
|
tipo de dirección de búsqueda
También se definen las siguientes constantes:
(typedef) |
|||||||||||||||||||||||||||||||||||||||
|
especifica el tipo de evento
(enum) |
|||||||||||||||||||||||||||||||||||||||
|
tipo de función de callback
(typedef) |
|||||||||||||||||||||||||||||||||||||||