NOME

       fopen, fdopen, freopen - funções de abertura de fluxo

SINOPSE

       #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);

DESCRIÇÃO

       A função fopen abre o arquivo cujo nome é a string apontada por path e associa um fluxo com ele.

       O  argumento  mode  aponta  para  uma string que começa com uma ou mais sequências (Caracteres adicionais
       podem seguir essas sequências.):

       r      Abre arquivo de texto para leitura. O fluxo é posicionado no começo do arquivo.

       r+     Abre para leitura e escrita. O fluxo é posicionado no começo do arquivo.

       w      Trunca o arquivo para comprimento zero,  ou  cria  arquivo  de  texto  para  escrita.  O  fluxo  é
              posicionado no começo do arquivo.

       w+     Abre  para  leitura e escrita. O arquivo é criado se não existir, caso contrário ele é truncado. O
              fluxo é posicionado no começo do arquivo.

       a      Abre para escrita. O arquivo é criado se não existir. O fluxo é posicionado no fim do arquivo.

       a+     Abre para leitura e escrita. O arquivo é criado se não existir. O fluxo é posicionado  no  fim  do
              arquivo.

       A string de mode também pode incluir a letra ``b'' como um último caractere ou como um caractere entre os
       caracteres  em  qualquer  uma  das  strings  de dois caracteres descritas acima. Isto é estritamente para
       compatibilidade com ANSI X3.159-1989 (``ANSI C'') e não tem efeito;  o  ``b''  é  ignorado  em  todos  os
       sistemas  conformes  com  POSIX,  incluindo  o  Linux.  (Outros sistemas podem tratar arquivos de texto e
       arquivos binários de formas diferentes, e o acréscimo de ``b'' pode ser uma boa idéia  se  você  faz  E/S
       para um arquivo binário e espera que seu programa possa ser portado para ambientes não-Unix.)

       Quaisquer  arquivos criados terão o modo S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH (0666), conforme
       modificado pelo valor de 'umask' do processo (veja umask(2).

       Leitura e escrita pode ser mescladas em fluxos de leitura/escrita em qualquer ordem.  Note que o  C  ANSI
       requer  que  uma  função de posicionamento de arquivo intercale-se entre a saída e a entrada, a menos que
       uma operação de entrada encontre o fim do arquivo. (Se esta condição não é encontrada, então uma  leitura
       é  permitida  para  retornar  o  resultado de escritas que não sejam a mais recente.)  Portanto é uma boa
       prática (e de fato necessário sob o Linux,  às  vezes)  colocar  uma  operação  fseek  ou  fgetpos  entre
       operações de escrita e leitura em tais fluxos. Esta operação pode ser um aparente no-op ("no operation"),
       como em fseek(..., 0L, SEEK_CUR) chamado para seu efeito colateral de sincronismo.

       A  função fdopen associa um fluxo com o descritor de arquivos existente, fildes.  O modo do fluxo (um dos
       valores "r", "r+", "w", "w+", "a", "a+") precisa ser compatível com o modo do descritor  de  arquivo.   O
       indicador  de  posição  do  arquivo  do  novo  fluxo  é  setado  para  aquele pertencente ao fildes, e os
       indicadores de erro e fim de arquivo são limpos.  Os modos  "w"  ou  "w+"  não  provocam  truncamento  do
       arquivo.   O descritor de arquivo não sofre um 'dup', e será fechado quando o fluxo criado por fdopen for
       fechado.  O resultado da aplicação de fdopen para um objeto de memória compartilhado é indefinido.

       A função freopen abre o arquivo cujo nome é a string apontada por path e associa  o  fluxo  apontado  por
       stream  a  ele. O fluxo original (se existir) é encerrado. O argumento mode é usado apenas como na função
       fopen.  O uso primário da função freopen é mudar o arquivo associado com o fluxo de texto padrão (stderr,
       stdin, ou stdout).

VALORES DE RETORNO

       Em caso de término bem-sucedido, fopen, fdopen e freopen retornam um ponteiro para FILE.  Caso contrário,
       é retornado um NULL e a variável global errno é setada para indicar o erro.

ERROS

       EINVAL O mode fornecido para fopen, fdopen, ou freopen era inválido.

       As funções fopen, fdopen  e  freopen  também  podem  falhar  e  setar  errno  para  quaisquer  dos  erros
       especificados para a rotina malloc(3).

       A  função  fopen  também  pode  falhar e setar errno para quaisquer dos erros especificados para a rotina
       open(2).

       A função fdopen também pode falhar e setar errno para quaisquer dos erros  especificados  para  a  rotina
       fcntl(2).

       A  função freopen também pode falhar e setar errno para quaisquer dos erros especificados para as rotinas
       open(2), fclose(3) e fflush(3).

VEJA TAMBÉM

       open(2), fclose(3)

PADRÕES

       As funções fopen e freopen estão em conformidade com ANSI X3.159-1989 (``ANSI C''). A função fdopen  está
       em conformidade com IEEE Std1003.1-1988 (``POSIX.1'').

TRADUÇÃO PARA A LÍNGUA PORTUGUESA

       RUBENS  DE  JESUS  NOGUEIRA <darkseid99@usa.net> (tradução) XXXXXX XX XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx>
       (revisão)

BSD MANPAGE                                  13 de dezembro de 1995                                     FOPEN(3)