.\" 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 \- funções da biblioteca padrão de entrada/saída .SH SINOPSE .B #include .sp .B FILE *stdin; .br .B FILE *stdout; .br .B FILE *stderr; .SH 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. .PP Uma corrente é associada a um arquivo externo (que pode ser um dispositivo físico) pela .I 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 .I indicador de posição 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 .BR fgetc (3) ; todas as saídas ocorrem como se todos os caracteres fossem lidos por chamadas successivas à função .BR fputc (3). .PP Um arquivo é desassociado de um fluxo pelo .I 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 .B FILE é indeterminado depois que um arquivo é fechado (lixo). .PP 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 .BR 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 .BR abort (3) , não se preocupam com o fechamento adequado dos arquivos. .PP Na inicialização de programas, três fluxos de texto são predefinidos e não 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 saída de diagnóstico de escrita). Estes fluxos são abreviados como .IR stdin , stdout e .IR 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. .PP 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 .BR fflush (3) na saída padrão antes do término e da computação, de forma que a saída apareça. .PP A biblioteca .B stdio é uma parte da biblioteca .B libc , e as rotinas são carregadas automaticamente, conforme necessárias para os compiladores .BR cc (1) e .BR pc (1). As seções .B 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. .PP As seguintes são definidas como macros; estes nomes não podem ser reusados sem primeiro remover suas definições 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 . Versões de função das funções de macro .BR feof , .BR ferror , .BR clearerr , .BR fileno , .BR getc , .BR getchar , .BR putc , e .B putchar existem e serão usadas se as definições de macros são removidas explicitamente. .SH "VEJA TAMBÉM" .BR open (2), .BR close (2), .BR read (2), .BR write (2), .BR stdout (3) .SH BUGS As funções armazenadas padrão não interagem bem com certas outras funções de biblioteca e sistema, especialmente .B vfork e .BR abort . Isto pode não ser o caso no Linux. .SH PADRÕES A biblioteca .B stdio tem conformidade com ANSI X3.159-1989 (``ANSI C''). .SH "LISTA DE FUNÇÕES" .TP .B Função .B Descrição .TP clearerr verifica e resseta o estado do fluxo .TP fclose fecha um fluxo .TP fdopen funções 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 próximo 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 funções de abertura do fluxo .TP fprintf conversão formatada de saída .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/saída binária de fluxo .TP freopen funções de abertura de fluxo .TP fropen abre um fluxo .TP fscanf conversão de formato de entrada .TP fseek reposiciona um fluxo .TP fsetpos reposiciona um fluxo .TP ftell reposiciona um fluxo .TP fwrite entrada/saída binária de fluxo .TP getc captura o próximo caractere ou palavra do fluxo de entrada .TP getchar captura o próximo caractere ou palavra do fluxo de entrada .TP gets captura uma nova linha do fluxo .TP getw captura o próximo caractere ou palavra do fluxo de entrada .TP mktemp faz nome de arquivo temporário (único) .TP perror mensagens de erro do sistema .TP printf conversão de saída 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 diretório .TP rewind reposiciona um fluxo .TP scanf conversão de formato de entrada .TP setbuf operações de armazenamento de fluxo .TP setbuffer operações de armazenamento de fluxo .TP setlinebuf operações de armazenamento de fluxo .TP setvbuf operações de armazenamento de fluxo .TP sprintf conversão de saída formatada .TP sscanf conversão 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 temporário .TP tmpfile rotinas de arquivo temporário .TP tmpnam rotinas de arquivo temporário .TP ungetc devolve caractere para um fluxo de entrada .TP vfprintf conversão de saída formatada .TP vfscanf conversão de formato de entrada .TP vprintf conversão de saída formatada .TP vscanf conversão de formato de entrada .TP vsprintf conversão de saída formatada .TP vsscanf conversão de formato de entrada .SH TRADUÇÃO PARA A LÍNGUA PORTUGUESA \&\fR\&\f(CWRUBENS DE JESUS NOGUEIRA (tradução)\fR \&\fR\&\f(CWXXXXXX XX XXXXX XXXXXXXX (revisão)\fR