.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" Chris Torek and the American National Standards Committee X3,
.\" on Information Processing Systems.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)fopen.3	6.8 (Berkeley) 6/29/91
.\"
.\" Converted for Linux, Mon Nov 29 15:22:01 1993, faith@cs.unc.edu
.\" Modified, aeb, 960421, 970806
.\"
.TH FOPEN 3  "13 de dezembro de 1995" "BSD MANPAGE" "Manual do Programador Linux"
.SH NOME
fopen, fdopen, freopen \- funes de abertura de fluxo
.SH SINOPSE
.B #include <stdio.h>
.sp
.BI "FILE *fopen (const char *" path ", const char *" mode );
.br
.BI "FILE *fdopen (int " fildes ", const char *" mode );
.br
.BI "FILE *freopen (const char *" path ", const char *" mode ", FILE *" stream );
.SH DESCRIO
A funo
.B fopen
abre o arquivo cujo nome  a string apontada por
.I path
e associa um fluxo com ele.
.PP
O argumento
.I mode
aponta para uma string que comea com uma ou mais sequncias
(Caracteres adicionais podem seguir essas sequncias.):
.TP
.B r
Abre arquivo de texto para leitura. O fluxo  posicionado no comeo do arquivo.
.TP
.B r+
Abre para leitura e escrita. O fluxo  posicionado no comeo do arquivo.
.TP
.B w
Trunca o arquivo para comprimento zero, ou cria arquivo de texto para escrita. O fluxo
 posicionado no comeo do arquivo.
.TP
.B w+
Abre para leitura e escrita. O arquivo  criado se no existir, caso contrrio
ele  truncado. O fluxo  posicionado no comeo do arquivo.
.TP
.B a
Abre para escrita. O arquivo  criado se no existir. O fluxo  posicionado no fim do arquivo.
.TP
.B a+
Abre para leitura e escrita. O arquivo  criado se no existir. O fluxo  posicionado no 
fim do arquivo.
.PP
A string de
.I mode
tambm 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 no tem efeito; o ``b''  ignorado
em todos os sistemas conformes com POSIX, incluindo o Linux. (Outros sistemas podem tratar
arquivos de texto e arquivos binrios de formas diferentes, e o acrscimo de ``b'' pode ser uma
boa idia se voc faz E/S para um arquivo binrio e espera que seu programa possa ser portado
para ambientes no-Unix.)
.PP
Quaisquer arquivos criados tero o modo
.BR S_IRUSR \&| S_IWUSR \&|  S_IRGRP \&|  S_IWGRP \&| S_IROTH \&| S_IWOTH
(0666), conforme modificado pelo valor de 'umask' do processo (veja
.BR umask (2).
.PP
Leitura e escrita pode ser mescladas em fluxos de leitura/escrita em qualquer ordem.
Note que o C ANSI requer que uma funo de posicionamento de arquivo intercale-se entre a 
sada e a entrada, a menos que uma operao de entrada encontre o fim do arquivo. (Se esta
condio no  encontrada, ento uma leitura  permitida para retornar o resultado de escritas
que no sejam a mais recente.)
Portanto  uma boa prtica (e de fato necessrio sob o Linux, s vezes) colocar uma operao
.B fseek
ou
.B fgetpos
entre operaes de escrita e leitura em tais fluxos. Esta operao pode ser um aparente no-op
("no operation", como em \fIfseek(..., 0L, SEEK_CUR)\fR chamado para seu efeito colateral de
sincronismo.
.PP
A funo
.B fdopen
associa um fluxo com o descritor de arquivos existente,
.IR fildes .
O
.I modo
do fluxo (um dos valores "r", "r+", "w", "w+", "a", "a+") precisa ser compatvel com o modo do
descritor de arquivo.
O indicador de posio do arquivo do novo fluxo  setado para aquele pertencente ao
.IR fildes ,
e os indicadores de erro e fim de arquivo so limpos.
Os modos "w" ou "w+" no provocam truncamento do arquivo.
O descritor de arquivo no sofre um 'dup', e ser fechado quando o fluxo criado por
.B fdopen
for fechado.
O resultado da aplicao de
.B fdopen
para um objeto de memria compartilhado  indefinido.
.PP
A funo
.B freopen
abre o arquivo cujo nome  a string apontada por
.I path
e associa o fluxo apontado por
.I stream
a ele. O fluxo original (se existir)  encerrado. O argumento
.I mode
 usado apenas como na funo
.B fopen.
O uso primrio da funo
.B freopen
 mudar o arquivo associado com o fluxo de texto padro
.IR "" ( stderr ", " stdin ", ou " stdout ).
.SH "VALORES DE RETORNO"
Em caso de trmino bem-sucedido,
.BR fopen ,
.B fdopen
e
.B freopen
retornam um ponteiro para
.B FILE.
Caso contrrio,  retornado um
.B NULL
e a varivel global
.I errno
 setada para indicar o erro.
.SH ERROS
.TP
.B EINVAL
O
.I mode
fornecido para
.BR fopen ,
.BR fdopen ,
ou
.B freopen
era invlido.
.PP
As funes
.BR fopen ,
.B fdopen
e
.B freopen
tambm podem falhar e setar
.I errno
para quaisquer dos erros especificados para a rotina
.BR malloc (3).
.PP
A funo
.B fopen
tambm pode falhar e setar
.I errno
para quaisquer dos erros especificados para a rotina
.BR open (2).
.PP
A funo
.B fdopen
tambm pode falhar e setar
.I errno
para quaisquer dos erros especificados para a rotina
.BR fcntl (2).
.PP
A funo
.B freopen
tambm pode falhar e setar
.I errno
para quaisquer dos erros especificados para as rotinas
.BR open (2),
.BR fclose (3)
e
.BR fflush (3).
.SH "VEJA TAMBM"
.BR open "(2), " fclose (3)
.SH PADRES
As funes
.B fopen
e
.B freopen
esto em conformidade com ANSI X3.159-1989 (``ANSI C''). A funo
.B fdopen
est em conformidade com IEEE Std1003.1-1988 (``POSIX.1'').
.SH TRADUO PARA A LNGUA PORTUGUESA
\&\fR\&\f(CWRUBENS DE JESUS NOGUEIRA <darkseid99@usa.net> (traduo)\fR
\&\fR\&\f(CWXXXXXX XX XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (reviso)\fR