Provided by:
manpages-pt-dev_20040726-2_all 
NOME
stdio - funções da biblioteca padrão de entrada/saída
SINOPSE
#include <stdio.h>
FILE *stdin;
FILE *stdout;
FILE *stderr;
DESCRIÇÃO
A biblioteca padrão de E/S provê uma interface de E/S de fluxo
’bufferizada’ simples e eficiente. Entrada e saída são mapeados para
correntes lógicas de dados, e as características físicas de E/S são
omitidas. As funções e macros são listadas abaixo; mais informações são
disponíveis das páginas de manual individuais.
Uma corrente é associada a um arquivo externo (que pode ser um
dispositivo físico) pela abertura de um arquivo, que pode envolver a
criação de um novo arquivo. A criação de um arquivo já existente faz
com que seu conteúdo anterior seja descartado. Se um arquivo pode
suportar pedidos de posicionamento (como um arquivo de disco, ao
contrário de um terminal), então um indicador de posio de arquivo
associado com a corrente é posicionada no início do arquivo (byte
zero), a menos que o arquivo seja aberto no modo ’acréscimo’. Se é
usado o modo ’acréscimo’, o indicador de posição será colocado no fim
de arquivo. O indicador de posição é mantido por leituras, escritas e
pedidos de posicionamento subsequentes. Todas as entradas ocorrem como
se os caracteres fossem lidos por chamadas successivas à função
fgetc(3) ; todas as saídas ocorrem como se todos os caracteres fossem
lidos por chamadas successivas à função fputc(3).
Um arquivo é desassociado de um fluxo pelo fechamento do arquivo.
Fluxos de saída são esvaziados (qualquer conteúdo de buffer não escrito
é transferido para o ambiente do host) antes do fluxo ser desassociado
do arquivo. O valor de um ponteiro para um objeto FILE é indeterminado
depois que um arquivo é fechado (lixo).
Um arquivo pode ser reaberto subsequentemente, pela mesma ou por outra
execução do programa, e seu conteúdo pode ser reivindicado ou
modificado (se ele puder ser reposicionado no início). Se a função
principal retorna para o seu chamador original ou a função exit(3) é
chamada, todos os arquivos abertos são fechados (portanto todos os
fluxos são esvaziados) antes do encerramento do programa. Outros
métodos de encerramento de programa, como o abort(3) , não se preocupam
com o fechamento adequado dos arquivos.
Na inicialização de programas, três fluxos de texto são predefinidos e
não precisam ser abertos explicitamente — standard input (para a
entrada convencional de leitura), — standard output (para a entrada
convencional de escrita), and standard error (para saída de diagnóstico
de escrita). Estes fluxos são abreviados como stdin,stdout e stderr.
Quando abertos, o fluxo de erro padrão não é completamente armazenados;
os fluxos padrão de entrada e saída são completamente armazenados se, e
somente se, os fluxos não se referem a um dispositivo interativo.
Fluxos de saída que se referem a dispositivos de terminal são sempre
armazenados em linha por padrão; saídas pendentes para tais fluxos são
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 computações é feita depois do serviço de impressão de uma
linha em um terminal de saída, é necessário executar fflush(3) na saída
padrão antes do término e da computação, de forma que a saída apareça.
A biblioteca stdio é uma parte da biblioteca libc , e as rotinas são
carregadas automaticamente, conforme necessárias para os compiladores
cc(1) e pc(1). As seções SINOPSE das seguintes páginas de manual
indicam quais arquivos de inclusão devem ser usados, com que se parecem
as declarações do compilador para a função, e quais variáveis externas
são de interesse.
As seguintes são definidas como macros; estes nomes não podem ser
reusados sem primeiro remover suas definições 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. Versões de função das funções de macro feof, ferror, clearerr,
fileno, getc, getchar, putc, e putchar existem e serão usadas se as
definições de macros são removidas explicitamente.
VEJA TAMBÉM
open(2), close(2), read(2), write(2), stdout(3)
BUGS
As funções armazenadas padrão não interagem bem com certas outras
funções de biblioteca e sistema, especialmente vfork e abort. Isto
pode não ser o caso no Linux.
PADRÕES
A biblioteca stdio tem conformidade com ANSI X3.159-1989 (‘‘ANSI C’’).
LISTA DE FUNÇÕES
Função Descrição
clearerr
verifica e resseta o estado do fluxo
fclose fecha um fluxo
fdopen funções 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 próximo 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 funções de abertura do fluxo
fprintf
conversão formatada de saída
fpurge esvazia um fluxo
fputc envia um caractere ou palavra para um fluxo
fputs envia uma linha para um fluxo
fread entrada/saída binária de fluxo
freopen
funções de abertura de fluxo
fropen abre um fluxo
fscanf conversão de formato de entrada
fseek reposiciona um fluxo
fsetpos
reposiciona um fluxo
ftell reposiciona um fluxo
fwrite entrada/saída binária de fluxo
getc captura o próximo caractere ou palavra do fluxo de entrada
getchar
captura o próximo caractere ou palavra do fluxo de entrada
gets captura uma nova linha do fluxo
getw captura o próximo caractere ou palavra do fluxo de entrada
mktemp faz nome de arquivo temporário (único)
perror mensagens de erro do sistema
printf conversão de saída 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 diretório
rewind reposiciona um fluxo
scanf conversão de formato de entrada
setbuf operações de armazenamento de fluxo
setbuffer
operações de armazenamento de fluxo
setlinebuf
operações de armazenamento de fluxo
setvbuf
operações de armazenamento de fluxo
sprintf
conversão de saída formatada
sscanf conversão 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 temporário
tmpfile
rotinas de arquivo temporário
tmpnam rotinas de arquivo temporário
ungetc devolve caractere para um fluxo de entrada
vfprintf
conversão de saída formatada
vfscanf
conversão de formato de entrada
vprintf
conversão de saída formatada
vscanf conversão de formato de entrada
vsprintf
conversão de saída formatada
vsscanf
conversão de formato de entrada
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)