Provided by:
manpages-pt-dev_20040726-4_all 
NOME
stdio - funcoes da biblioteca padrao de entrada/saida
SINOPSE
#include <stdio.h>
FILE *stdin;
FILE *stdout;
FILE *stderr;
DESCRI,C~AO
A biblioteca padrao de E/S prove uma interface de E/S de fluxo
'bufferizada' simples e eficiente. Entrada e saida sao mapeados para
correntes logicas de dados, e as caracteristicas fisicas de E/S sao
omitidas. As funcoes e macros sao listadas abaixo; mais informacoes sao
disponiveis das paginas de manual individuais.
Uma corrente e associada a um arquivo externo (que pode ser um
dispositivo fisico) pela abertura de um arquivo, que pode envolver a
criacao de um novo arquivo. A criacao de um arquivo ja existente faz
com que seu conteudo anterior seja descartado. Se um arquivo pode
suportar pedidos de posicionamento (como um arquivo de disco, ao
contrario de um terminal), entao um indicador de posi,c~ao de arquivo
associado com a corrente e posicionada no inicio do arquivo (byte
zero), a menos que o arquivo seja aberto no modo 'acrescimo'. Se e
usado o modo 'acrescimo', o indicador de posicao sera colocado no fim
de arquivo. O indicador de posicao e mantido por leituras, escritas e
pedidos de posicionamento subsequentes. Todas as entradas ocorrem como
se os caracteres fossem lidos por chamadas successivas a funcao
fgetc(3) ; todas as saidas ocorrem como se todos os caracteres fossem
lidos por chamadas successivas a funcao fputc(3).
Um arquivo e desassociado de um fluxo pelo fechamento do arquivo.
Fluxos de saida sao esvaziados (qualquer conteudo de buffer nao escrito
e transferido para o ambiente do host) antes do fluxo ser desassociado
do arquivo. O valor de um ponteiro para um objeto FILE e indeterminado
depois que um arquivo e fechado (lixo).
Um arquivo pode ser reaberto subsequentemente, pela mesma ou por outra
execucao do programa, e seu conteudo pode ser reivindicado ou
modificado (se ele puder ser reposicionado no inicio). Se a funcao
principal retorna para o seu chamador original ou a funcao exit(3) e
chamada, todos os arquivos abertos sao fechados (portanto todos os
fluxos sao esvaziados) antes do encerramento do programa. Outros
metodos de encerramento de programa, como o abort(3) , nao se preocupam
com o fechamento adequado dos arquivos.
Na inicializacao de programas, tres fluxos de texto sao predefinidos e
nao precisam ser abertos explicitamente -- standard input (para a
entrada convencional de leitura), -- standard output (para a entrada
convencional de escrita), and standard error (para saida de diagnostico
de escrita). Estes fluxos sao abreviados como stdin,stdout e stderr.
Quando abertos, o fluxo de erro padrao nao e completamente armazenados;
os fluxos padrao de entrada e saida sao completamente armazenados se, e
somente se, os fluxos nao se referem a um dispositivo interativo.
Fluxos de saida que se referem a dispositivos de terminal sao sempre
armazenados em linha por padrao; saidas pendentes para tais fluxos sao
escritos automaticamente sempre que que se le um fluxo de entrada que
se refere a um dispositivo de terminal. Nos casos onde uma grande
quantidade de computacoes e feita depois do servico de impressao de uma
linha em um terminal de saida, e necessario executar fflush(3) na saida
padrao antes do termino e da computacao, de forma que a saida apareca.
A biblioteca stdio e uma parte da biblioteca libc , e as rotinas sao
carregadas automaticamente, conforme necessarias para os compiladores
cc(1) e pc(1). As secoes SINOPSE das seguintes paginas de manual
indicam quais arquivos de inclusao devem ser usados, com que se parecem
as declaracoes do compilador para a funcao, e quais variaveis externas
sao de interesse.
As seguintes sao definidas como macros; estes nomes nao podem ser
reusados sem primeiro remover suas definicoes atuais com #undef:
BUFSIZ, EOF, FILENAME_MAX, FOPEN_MAX, L_cuserid, L_ctermid, L_tmpnam,
NULL, SEEK_END, SEEK_SET, SEE_CUR, TMP_MAX, clearerr, feof, ferror,
fileno, fropen, fwopen, getc, getchar, putc, putchar, stderr, stdin,
stdout. Versoes de funcao das funcoes de macro feof, ferror, clearerr,
fileno, getc, getchar, putc, e putchar existem e serao usadas se as
definicoes de macros sao removidas explicitamente.
VEJA TAMB'EM
open(2), close(2), read(2), write(2), stdout(3)
BUGS
As funcoes armazenadas padrao nao interagem bem com certas outras
funcoes de biblioteca e sistema, especialmente vfork e abort. Isto
pode nao ser o caso no Linux.
PADR~OES
A biblioteca stdio tem conformidade com ANSI X3.159-1989 (``ANSI C'').
LISTA DE FUN,C~OES
Fun,c~ao Descri,c~ao
clearerr
verifica e resseta o estado do fluxo
fclose fecha um fluxo
fdopen funcoes de abertura de fluxo
feof verifica e resseta o estado do fluxo
ferror verifica e resseta o estado do fluxo
fflush esvazia um fluxo
fgetc captura o proximo caractere ou palavra do fluxo de entrada
fgetline
captura uma linha do fluxo
fgetpos
reposiciona um fluxo
fgets captura uma linha de um fluxo
fileno verifica e resseta o estado do fluxo
fopen funcoes de abertura do fluxo
fprintf
conversao formatada de saida
fpurge esvazia um fluxo
fputc envia um caractere ou palavra para um fluxo
fputs envia uma linha para um fluxo
fread entrada/saida binaria de fluxo
freopen
funcoes de abertura de fluxo
fropen abre um fluxo
fscanf conversao de formato de entrada
fseek reposiciona um fluxo
fsetpos
reposiciona um fluxo
ftell reposiciona um fluxo
fwrite entrada/saida binaria de fluxo
getc captura o proximo caractere ou palavra do fluxo de entrada
getchar
captura o proximo caractere ou palavra do fluxo de entrada
gets captura uma nova linha do fluxo
getw captura o proximo caractere ou palavra do fluxo de entrada
mktemp faz nome de arquivo temporario (unico)
perror mensagens de erro do sistema
printf conversao de saida formatada
putc envia um caractere ou palavra para um fluxo
putchar
envia um caractere ou palavra para um fluxo
puts envia uma linha para um fluxo
putw envia um caractere ou palavra para um fluxo
remove remove entrada de diretorio
rewind reposiciona um fluxo
scanf conversao de formato de entrada
setbuf operacoes de armazenamento de fluxo
setbuffer
operacoes de armazenamento de fluxo
setlinebuf
operacoes de armazenamento de fluxo
setvbuf
operacoes de armazenamento de fluxo
sprintf
conversao de saida formatada
sscanf conversao de formato de entrada
strerror
mensagens de erro de sistema
sys_errlist
mensagens de erro de sistema
sys_nerr
mensagens de erro de sistema
tempnam
rotinas de arquivo temporario
tmpfile
rotinas de arquivo temporario
tmpnam rotinas de arquivo temporario
ungetc devolve caractere para um fluxo de entrada
vfprintf
conversao de saida formatada
vfscanf
conversao de formato de entrada
vprintf
conversao de saida formatada
vscanf conversao de formato de entrada
vsprintf
conversao de saida formatada
vsscanf
conversao de formato de entrada
TRADU,C~AO PARA A L'INGUA PORTUGUESA
RUBENS DE JESUS NOGUEIRA <darkseid99@usa.net> (traducao) XXXXXX XX
XXXXX XXXXXXXX <xxxxxxxxxx@xxx.xxx> (revisao)