Funciones miembro de flujo de entrada
Las funciones miembro de flujo de entrada se usan para la entrada de disco.
open
Si usa un flujo de archivos de entrada (ifstream), debe asociar ese flujo con un archivo de disco específico. Puede hacerlo en el constructor, o bien puede usar la función open. En cualquier caso, los argumentos son los mismos.
Normalmente se especifica una marca ios_base::openmode al abrir el archivo asociado a un flujo de entrada (el modo predeterminado es ios::in). Para ver una lista de las marcas openmode, consulte ios_base::openmode. Las marcas se pueden combinar con el operador "or" bit a bit (|).
Para leer un archivo, primero use la función miembro fail para determinar si existe:
istream ifile("FILENAME");
if (ifile.fail())
// The file does not exist ...
get
La función miembro get sin formato funciona como el operador >>, con dos excepciones. En primer lugar, la función get incluye caracteres de espacio en blanco, mientras que el extractor excluye el espacio en blanco cuando la marca skipws está establecida (el valor predeterminado). En segundo lugar, es menos probable que la función get provoque el vaciado de un flujo de salida vinculado (por ejemplo, cout).
Una variación de la función get especifica una dirección de búfer y el número máximo de caracteres que se van a leer. Esto es útil para limitar el número de caracteres que se envían a una variable específica, como se muestra en este ejemplo:
// ioo_get_function.cpp
// compile with: /EHsc
// Type up to 24 characters and a terminating character.
// Any remaining characters can be extracted later.
#include <iostream>
using namespace std;
int main()
{
char line[25];
cout << " Type a line terminated by carriage return\n>";
cin.get( line, 25 );
cout << line << endl;
}
Entrada
1234
Salida de ejemplo
1234
getline
La función miembro getline es similar a la función get. Ambas funciones permiten un tercer argumento que especifica el carácter de terminación de la entrada. El valor predeterminado es el carácter de nueva línea. Ambas funciones reservan un carácter para el carácter de terminación necesario, Sin embargo, get deja el carácter de terminación del flujo y getline quita el carácter de terminación.
En el ejemplo siguiente se especifica un carácter de terminación para el flujo de entrada:
// getline_func.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;
int main( )
{
char line[100];
cout << " Type a line terminated by 't'" << endl;
cin.getline( line, 100, 't' );
cout << line;
}
Entrada
test
read
La función miembro read lee los bytes de un archivo en un área de memoria especificada. El argumento de longitud determina el número de bytes leídos. Si no se incluye ese argumento, la lectura se detiene cuando se llega al final del archivo o, en el caso de un archivo en modo de texto, cuando se lee un carácter EOF insertado.
En este ejemplo se lee un registro binario de un archivo de nóminas en una estructura:
#include <fstream>
#include <iostream>
using namespace std;
int main()
{
struct
{
double salary;
char name[23];
} employee;
ifstream is( "payroll" );
if( is ) { // ios::operator void*()
is.read( (char *) &employee, sizeof( employee ) );
cout << employee.name << ' ' << employee.salary << endl;
}
else {
cout << "ERROR: Cannot open file 'payroll'." << endl;
}
}
El programa da por supuesto que los registros de datos tienen exactamente el mismo formato especificado por la estructura, sin caracteres de terminación de retorno de carro o avance de línea.
seekg y tellg
Los flujos de archivos de entrada conservan un puntero interno a la posición del archivo en la que se van a leer los datos a continuación. Este puntero se establece con la función seekg, como se muestra aquí:
#include <iostream>
#include <fstream>
using namespace std;
int main( )
{
char ch;
ifstream tfile( "payroll" );
if( tfile ) {
tfile.seekg( 8 ); // Seek 8 bytes in (past salary)
while ( tfile.good() ) { // EOF or failure stops the reading
tfile.get( ch );
if( !ch ) break; // quit on null
cout << ch;
}
}
else {
cout << "ERROR: Cannot open file 'payroll'." << endl;
}
}
Para usar seekg para implementar sistemas de administración de datos orientados a registros, multiplique el tamaño del registro de longitud fija por el número de registros para obtener la posición del byte con respecto al final del archivo y, después, use el objeto get para leer el registro.
La función miembro tellg devuelve la posición del archivo actual para la lectura. Este valor es de tipo streampos, un elemento typedef definido en <iostream>. En el ejemplo siguiente se lee un archivo y se muestran los mensajes que indican las posiciones de los espacios.
#include <fstream>
#include <iostream>
using namespace std;
int main( )
{
char ch;
ifstream tfile( "payroll" );
if( tfile ) {
while ( tfile.good( ) ) {
streampos here = tfile.tellg();
tfile.get( ch );
if ( ch == ' ' )
cout << "\nPosition " << here << " is a space";
}
}
else {
cout << "ERROR: Cannot open file 'payroll'." << endl;
}
}
close
La función miembro close cierra el archivo de disco asociado a un flujo de archivos de entrada y libera el identificador de archivo del sistema operativo. El destructor ifstream cierra el archivo automáticamente, pero puede usar la función close si necesita abrir otro archivo para el mismo objeto de flujo.