table of contents
other languages
FOPEN(3) | Manual del Programador de Linux | FOPEN(3) |
NOMBRE¶
fopen, fdopen, freopen - funciones de apertura de flujosSINOPSIS¶
#include <stdio.h> FILE *fopen(const char *path, const char *mode);DESCRIPCIÓN¶
La función fopen abre el fichero cuyo nombre es la cadena apuntada por camino y asocia un flujo de datos a él. El argumento modo apunta a una cadena que empieza con una de las siguientes secuencias (a las que pueden seguir caracteres adicionales):- r
- Abre un fichero de texto para lectura. El flujo se posiciona al principio del fichero.
- r+
- Abre para lectura y escritura. El flujo se posiciona al principio del fichero.
- w
- Trunca el fichero a longitud cero o crea un fichero de texto para escritura. El flujo se posiciona al principio del fichero.
- w+
- Abre para lectura y escritura. El fichero se crea si no existe, en otro caso se trunca. El flujo se posiciona al principio del fichero.
- a
- Abre para añadir (escribir al final del fichero). El fichero se crea si no existe. El flujo se posiciona al final del fichero.
- a+
- Abre para leer y añadir (escribir al final del fichero). El fichero se crea si no existe. El flujo se posiciona al final del fichero.
fseek(stream,0,SEEK_END);
La función fdopen asocia un flujo con el descriptor de fichero
existente, descf. El modo del flujo (uno de los valores
"r", "r+", "w", "w+", "a",
"a+") debe ser compatible con el del descriptor de fichero. Al
indicador de posición de fichero del nuevo flujo se le asigna el valor
del indicador de posición perteneciente a descf y los
indicadores de error y de fin-de-fichero se limpian. Los modos "w" y
"w+" no provocan el trucamiento del fichero. El descriptor de
fichero no es duplicado y se cerrará cuando el flujo creado por
fdopen se cierre. El resultado de aplicar fdopen a un objeto
compartido de memoria es indefinido.
La función freopen abre el fichero cuyo nombre es la cadena
apuntada por camino y asocia el flujo apuntado por flujo con
él. El flujo original (si existe) se cierra. El argumento modo
se emplea igual que en la función fopen. El uso principal de la
función freopen es cambiar el fichero asociado con un flujo de
texto estándar (stderr, stdin, o
stdout).
VALOR DEVUELTO¶
Cuando acaban bien, fopen, fdopen y freopen devuelven un puntero a FILE. Cuando no, devuelven NULL y la variable global errno contiene un valor que indica el error.ERRORES¶
- EINVAL
- El modo pasado a fopen, fdopen, o a freopen no era válido.
CONFORME A¶
Las funciones fopen y freopen son conformes con ANSI X3.159-1989 (``C ANSI''). La función fdopen es conforme con IEEE Std1003.1-1988 (``POSIX.1'').VÉASE TAMBIÉN¶
open(2), fclose(3), fileno(3)3 enero 2002 | BSD |