.\" Copyright (c) 1990, 1991 Regents of the University of California.
.\" All rights reserved.
.\"
.\" 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.
.\"
.\"     @(#)stdio.3	6.5 (Berkeley) 5/6/91
.\"
.\" Converted for Linux, Mon Nov 29 16:07:22 1993, faith@cs.unc.edu
.\"
.TH STDIO 3  "29 de novembro de 1993" "MANPAGE BSD" "Manual do Programador Linux"
.SH NOME
stdio \- funes da biblioteca padro de entrada/sada
.SH SINOPSE
.B #include <stdio.h>
.sp
.B FILE *stdin;
.br
.B FILE *stdout;
.br
.B FILE *stderr;
.SH DESCRIO
A biblioteca padro de E/S prov uma interface de E/S de fluxo 'bufferizada' simples
e eficiente. Entrada e sada so mapeados para correntes lgicas de dados, e as
caractersticas fsicas de E/S so omitidas. As funes e macros so listadas
abaixo; mais informaes so disponveis das pginas de manual individuais.
.PP
Uma corrente  associada a um arquivo externo (que pode ser um dispositivo fsico)
pela 
.I abertura
de um arquivo, que pode envolver a criao de um novo arquivo. A criao de um arquivo
j existente faz com que seu contedo anterior seja descartado. Se um arquivo pode
suportar pedidos de posicionamento (como um arquivo de disco, ao contrrio de um
terminal), ento um
.I indicador de posio de arquivo
associado com a corrente  posicionada no incio do arquivo (byte zero), a menos que
o arquivo seja aberto no modo 'acrscimo'. Se  usado o modo 'acrscimo', o indicador
de posio ser colocado no fim de arquivo. O indicador de posio  mantido por 
leituras, escritas e pedidos de posicionamento subsequentes. Todas as entradas 
ocorrem como se os caracteres fossem lidos por chamadas successivas  funo
.BR fgetc (3)
; todas as sadas ocorrem como se todos os caracteres fossem lidos por chamadas
successivas  funo
.BR fputc (3).
.PP
Um arquivo  desassociado de um fluxo pelo
.I fechamento
do arquivo. Fluxos de sada so esvaziados (qualquer contedo de buffer no escrito
 transferido para o ambiente do host) antes do fluxo ser desassociado do arquivo.
O valor de um ponteiro para um objeto
.B FILE
 indeterminado depois que um arquivo  fechado (lixo).
.PP
Um arquivo pode ser reaberto subsequentemente, pela mesma ou por outra execuo do
programa, e seu contedo pode ser reivindicado ou modificado (se ele puder ser reposicionado
no incio). Se a funo principal retorna para o seu chamador original ou a funo
.BR exit (3)
 chamada, todos os arquivos abertos so fechados (portanto todos os fluxos so
esvaziados) antes do encerramento do programa. Outros mtodos de encerramento de programa,
como o
.BR abort (3)
, no se preocupam com o fechamento adequado dos arquivos.
.PP
Na inicializao de programas, trs fluxos de texto so predefinidos e no precisam ser
abertos explicitamente \(em
.I standard input 
(para a entrada convencional de leitura), \(em
.I standard output 
(para a entrada convencional de escrita), and
.I standard error
(para sada de diagnstico de escrita). Estes fluxos so abreviados como
.IR stdin , stdout
e
.IR stderr .
Quando abertos, o fluxo de erro padro no  completamente armazenados; os fluxos
padro de entrada e sada so completamente armazenados se, e somente se, os fluxos
no se referem a um dispositivo interativo.
.PP
Fluxos de sada que se referem a dispositivos de terminal so sempre armazenados em linha
por padro; sadas pendentes para tais fluxos so escritos automaticamente sempre que
que se l um fluxo de entrada que se refere a um dispositivo de terminal. Nos casos onde
uma grande quantidade de computaes  feita depois do servio de impresso de uma linha 
em um terminal de sada,  necessrio executar
.BR fflush (3)
na sada padro antes do trmino e da computao, de forma que a sada aparea.
.PP
A biblioteca 
.B stdio
 uma parte da biblioteca
.B libc
, e as rotinas so carregadas automaticamente, conforme necessrias para os compiladores
.BR cc (1)
e
.BR pc (1).
As sees
.B SINOPSE
das seguintes pginas de manual indicam quais arquivos de incluso devem ser usados, 
com que se parecem as declaraes do compilador para a funo, e quais variveis externas
so de interesse.
.PP
As seguintes so definidas como macros; estes nomes no podem ser reusados sem primeiro
remover suas definies atuais com
.BR #undef :
.BR BUFSIZ ,
.BR EOF ,
.BR FILENAME_MAX ,
.BR FOPEN_MAX ,
.BR L_cuserid ,
.BR L_ctermid ,
.BR L_tmpnam,
.BR NULL ,
.BR SEEK_END ,
.BR SEEK_SET ,
.BR SEE_CUR ,
.BR TMP_MAX ,
.BR clearerr ,
.BR feof ,
.BR ferror ,
.BR fileno ,
.BR fropen ,
.BR fwopen ,
.BR getc ,
.BR getchar ,
.BR putc ,
.BR putchar ,
.BR stderr ,
.BR stdin ,
.BR stdout .
Verses de funo das funes de macro
.BR feof ,
.BR ferror ,
.BR clearerr ,
.BR fileno ,
.BR getc ,
.BR getchar ,
.BR putc ,
e
.B putchar
existem e sero usadas se as definies de macros so removidas explicitamente.
.SH "VEJA TAMBM"
.BR open (2),
.BR close (2),
.BR read (2),
.BR write (2),
.BR stdout (3)
.SH BUGS
As funes armazenadas padro no interagem bem com certas outras funes de biblioteca
e sistema, especialmente
.B vfork
e
.BR abort .
Isto pode no ser o caso no Linux.
.SH PADRES
A biblioteca 
.B stdio
tem conformidade com ANSI X3.159-1989 (``ANSI C'').
.SH "LISTA DE FUNES"
.TP
.B Funo
.B Descrio
.TP
clearerr
verifica e resseta o estado do fluxo
.TP
fclose
fecha um fluxo
.TP
fdopen
funes de abertura de fluxo
.TP
feof
verifica e resseta o estado do fluxo
.TP
ferror
verifica e resseta o estado do fluxo
.TP
fflush
esvazia um fluxo
.TP
fgetc
captura o prximo caractere ou palavra do fluxo de entrada
.TP
fgetline
captura uma linha do fluxo
.TP
fgetpos
reposiciona um fluxo
.TP
fgets
captura uma linha de um fluxo
.TP
fileno
verifica e resseta o estado do fluxo
.TP
fopen
funes de abertura do fluxo
.TP
fprintf
converso formatada de sada
.TP
fpurge
esvazia um fluxo
.TP
fputc
envia um caractere ou palavra para um fluxo
.TP
fputs
envia uma linha para um fluxo
.TP
fread
entrada/sada binria de fluxo
.TP
freopen
funes de abertura de fluxo
.TP
fropen
abre um fluxo
.TP
fscanf
converso de formato de entrada
.TP
fseek
reposiciona um fluxo
.TP
fsetpos
reposiciona um fluxo
.TP
ftell
reposiciona um fluxo
.TP
fwrite
entrada/sada binria de fluxo
.TP
getc
captura o prximo caractere ou palavra do fluxo de entrada
.TP
getchar
captura o prximo caractere ou palavra do fluxo de entrada
.TP
gets
captura uma nova linha do fluxo
.TP
getw
captura o prximo caractere ou palavra do fluxo de entrada
.TP
mktemp
faz nome de arquivo temporrio (nico)
.TP
perror
mensagens de erro do sistema
.TP
printf
converso de sada formatada
.TP
putc
envia um caractere ou palavra para um fluxo
.TP
putchar
envia um caractere ou palavra para um fluxo
.TP
puts
envia uma linha para um fluxo
.TP
putw
envia um caractere ou palavra para um fluxo
.TP
remove
remove entrada de diretrio
.TP
rewind
reposiciona um fluxo
.TP
scanf
converso de formato de entrada
.TP
setbuf
operaes de armazenamento de fluxo
.TP
setbuffer
operaes de armazenamento de fluxo
.TP
setlinebuf
operaes de armazenamento de fluxo
.TP
setvbuf
operaes de armazenamento de fluxo
.TP
sprintf
converso de sada formatada
.TP
sscanf
converso de formato de entrada
.TP
strerror
mensagens de erro de sistema
.TP
sys_errlist
mensagens de erro de sistema
.TP
sys_nerr
mensagens de erro de sistema
.TP
tempnam
rotinas de arquivo temporrio
.TP
tmpfile
rotinas de arquivo temporrio
.TP
tmpnam
rotinas de arquivo temporrio
.TP
ungetc
devolve caractere para um fluxo de entrada
.TP
vfprintf
converso de sada formatada
.TP
vfscanf
converso de formato de entrada
.TP
vprintf
converso de sada formatada
.TP
vscanf
converso de formato de entrada
.TP
vsprintf
converso de sada formatada
.TP
vsscanf
converso de formato de entrada
.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