Controlar secuenciasControlling Streams

fopen devuelve la dirección de un objeto de tipo FILE.fopen returns the address of an object of type FILE. Use esta dirección como el argumento stream de varias funciones de la biblioteca para realizar distintas operaciones en un archivo abierto.You use this address as the stream argument to several library functions to perform various operations on an open file. Para una secuencia de bytes, todas las entradas se realizan como si cada carácter se leyera mediante una llamada a fgetc, y todas las salidas se obtienen como si cada carácter se escribiera mediante una llamada a fputc.For a byte stream, all input takes place as if each character is read by calling fgetc, and all output takes place as if each character is written by calling fputc. Para una secuencia ancha, todas las entradas se realizan como si cada carácter se leyera mediante una llamada a fgetwc, y todas las salidas se obtienen como si cada carácter se escribiera mediante una llamada a fputwc.For a wide stream, all input takes place as if each character is read by calling fgetwc, and all output takes place as if each character is written by calling fputwc.

Puede cerrar un archivo mediante una llamada a fclose, operación tras la cual la dirección del objeto FILE ya no es válida.You can close a file by calling fclose, after which the address of the FILE object is invalid.

Un objeto FILE almacena el estado de una secuencia, incluidos:A FILE object stores the state of a stream, including:

  • Un indicador de error establecido como no nulo por una función que detecta un error de lectura o escritura.An error indicator set nonzero by a function that encounters a read or write error.

  • Un indicador de final de archivo establecido como no nulo por una función que detecta el final del archivo durante la lectura.An end-of-file indicator set nonzero by a function that encounters the end of the file while reading.

  • Un indicador de posición de archivo especifica el siguiente byte de la secuencia que se va a leer o escribir, en caso de que el archivo admita solicitudes de posicionamiento.A file-position indicator specifies the next byte in the stream to read or write, if the file can support positioning requests.

  • Un estado de secuencia especifica si la secuencia aceptará lecturas o escrituras y si dicha secuencia no está vinculada, está basada en bits o es ancha.A stream state specifies whether the stream will accept reads and/or writes and whether the stream is unbound, byte oriented, or wide oriented.

  • Un estado de conversión recuerda el estado de cualquier carácter multibyte generalizado generado o ensamblado parcialmente, así como cualquier estado de desplazamiento de la secuencia de bytes del archivo.A conversion state remembers the state of any partly assembled or generated generalized multibyte character, as well as any shift state for the sequence of bytes in the file).

  • Un búfer de archivo especifica la dirección y el tamaño de un objeto de matriz que las funciones de la biblioteca pueden usar para mejorar el rendimiento de las operaciones de lectura y escritura de la secuencia.A file buffer specifies the address and size of an array object that library functions can use to improve the performance of read and write operations to the stream.

No modifique cualquier valor almacenado en un objeto FILE o en un búfer de archivo que especifique para usarlo con ese objeto.Do not alter any value stored in a FILE object or in a file buffer that you specify for use with that object. No puede copiar un objeto FILE y usar de manera portátil la dirección de la copia como un argumento stream para una función de la biblioteca.You cannot copy a FILE object and portably use the address of the copy as a stream argument to a library function.

Vea tambiénSee also

Archivos y secuenciasFiles and Streams