NOMBRE

       fopen, fdopen, freopen - funciones de apertura de flujos

SINOPSIS

       #include <stdio.h>

       FILE *fopen(const char *path, const char *mode);
       FILE *fdopen(int fildes, const char *mode);
       FILE *freopen(const char *path, const char *mode, FILE *stream);

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.

       La cadena modo también puede incluir la letra ``b'' como último carácter o  entre  los  de
       cualquiera  de  las  cadenas  de  dos  caracteres  descritas  anteriormente.  Todo esto es
       estrictamente por compatibilidad con ANSI X3.159-1989 (``ANSI C'') y no tiene  efecto.  La
       ``b''  se  ignora  en  todos  los  sistemas  conformes  con POSIX, incluido Linux.  (Otros
       sistemas pueden tratar los ficheros de texto y los ficheros binarios de forma diferente, y
       añadir la ``b'' puede ser una buena idea si realiza E/S de un fichero binario y espera que
       su programa pueda ser transportado a entornos no Unix).

       Cualquier          fichero          creado          tendrá           de           permisos
       S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH  (0666),  modificados  por  el valor de la
       máscara umask del proceso (vea umask(2)).

       Las lecturas y las escrituras pueden mezclarse en flujos abiertos  para  lectura/escritura
       en   cualquier  orden.  Observe  que  C  ANSI  requiere  que  intervenga  una  función  de
       posicionamiento entre la salida y la  entrada,  a  menos  que  una  operación  de  entrada
       encuentre  el  fin-de-fichero.  (Si esta condición no se cumple, entonces se permite a una
       lectura devolver el resultado de escrituras distintas a la más reciente.)  Por lo tanto es
       buena  práctica  (y  desde  luego  necesario algunas veces bajo Linux) hacer una operación
       fseek o fgetpos entre operaciones de escritura y lectura  en  tal  flujo.  Esta  operación
       puede  ser  aparentemente inútil (como en fseek(..., 0L, SEEK_CUR)), llamada por su efecto
       lateral de sincronización.

       Abrir un fichero para añadir (a como primer  carácter  de  mode)  implica  que  todas  las
       operaciones de escritura posteriores sobre el flujo se realicen al final del fichero, como
       si fueran precedidas por una llamada
              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.

       Las funciones fopen, fdopen y freopen también pueden fallar y poner un valor en errno para
       cualquiera de los errores especificados para la rutina malloc(3).

       La  función  fopen  también  puede fallar y poner un valor en errno para cualquiera de los
       errores especificados para la rutina open(2).

       La función fdopen también puede fallar y poner un valor en errno para  cualquiera  de  los
       errores especificados para la rutina fcntl(2).

       La  función  freopen también puede fallar y poner un valor en errno para cualquiera de los
       errores especificados para las rutinas open(2), fclose(3) y fflush(3).

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)