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

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)