Provided by: manpages-pt-dev_20040726-4_all bug

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)