.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 1990, 1991 Regents of the University of California. .\" All rights reserved. .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\" @(#)stdio.3 6.5 (Berkeley) 5/6/91 .\" .\" Converted for Linux, Mon Nov 29 16:07:22 1993, faith@cs.unc.edu .\" Modified, 2001-12-26, aeb .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH stdio 3 "30 julho 2023" "Linux man\-pages 6.05.01" .SH NOME stdio \- funções de biblioteca padrão de entrada/saída .SH BIBLIOTECA Biblioteca C Padrão (\fIlibc\fP, \fI\-lc\fP) .SH SINOPSE .nf \fB#include \fP .PP \fBFILE *\fP\fIstdin\fP\fB;\fP \fBFILE *\fP\fIstdout\fP\fB;\fP \fBFILE *\fP\fIstderr\fP\fB;\fP .fi .SH DESCRIÇÃO A biblioteca padrão de E/S fornece uma interface simples e eficiente de fluxo bufferizado de E/S. Entrada e saída é mapeada nos fluxos lógicos de dados e as características físicas de E/S são ocultadas. As funções e macros são listadas abaixo; maiores informações estão disponíveis nas páginais de manual individuais. .PP A stream is associated with an external file (which may be a physical device) by \fIopening\fP a file, which may involve creating a new file. Creating an existing file causes its former contents to be discarded. If a file can support positioning requests (such as a disk file, as opposed to a terminal), then a \fIfile position indicator\fP associated with the stream is positioned at the start of the file (byte zero), unless the file is opened with append mode. If append mode is used, it is unspecified whether the position indicator will be placed at the start or the end of the file. The position indicator is maintained by subsequent reads, writes, and positioning requests. All input occurs as if the characters were read by successive calls to the \fBfgetc\fP(3) function; all output takes place as if all characters were written by successive calls to the \fBfputc\fP(3) function. .PP Um arquivo é desassociado de um fluxo pelo \fIfechamento\fP, usando a função close (closing), do mesmo. Fluxos de saída são descarregados (todo o conteúdo de um buffer não escrito é transferido para o ambiente) antes do fluxo ser desassociado do arquivo. O valor de um ponteiro para um objeto \fIFILE\fP é indeterminado após um arquivo ser fechado (lixo). .PP Um arquivo pode ser subsequentemente reaberto, pelo mesmo ou por outro programa, e seu conteúdo recuperado ou modificado (se puder ser reposicionado no início). Se a função 'main' retorna para seu chamador original, ou a função \fBexit\fP(3) é chamada, todos os arquivos abertos são fechados (portanto todos os fluxos de saída são descarregados) antes do fim do programa. Outros métodos de finalização de programa, tal como \fBabort\fP(3) não se preocupam em fechar os arquivos de maneira apropriada. .PP At program startup, three text streams are predefined and need not be opened explicitly: \fIstandard input\fP (for reading conventional input), \fIstandard output\fP (for writing conventional output), and \fIstandard error\fP (for writing diagnostic output). These streams are abbreviated \fIstdin\fP, \fIstdout\fP, and \fIstderr\fP. When opened, the standard error stream is not fully buffered; the standard input and output streams are fully buffered if and only if the streams do not refer to an interactive device. .PP Fluxos de saída que se referem a dispositivos de terminal são sempre bufferizados em linha por padrão; saída pendente para tais fluxos são escritas automaticamente sempre que um fluxo de entrada que se refere a um dispositivo de terminal for lido. Em casos em que uma grande quantidade de computação é feita após a impressão de uma linha em um terminal de saída, é necessário \fBfflush\fP(3) a saída padrão antes de desligar e processar então a saída aparecerá. .PP The \fIstdio\fP library is a part of the library \fBlibc\fP and routines are automatically loaded as needed by \fBcc\fP(1). The SYNOPSIS sections of the following manual pages indicate which include files are to be used, what the compiler declaration for the function looks like and which external variables are of interest. .PP .\" Not on Linux: .BR fropen , .\" Not on Linux: .BR fwopen , The following are defined as macros; these names may not be reused without first removing their current definitions with \fB#undef\fP: \fBBUFSIZ\fP, \fBEOF\fP, \fBFILENAME_MAX\fP, \fBFOPEN_MAX\fP, \fBL_cuserid\fP, \fBL_ctermid\fP, \fBL_tmpnam\fP, \fBNULL\fP, \fBSEEK_END\fP, \fBSEEK_SET\fP, \fBSEEK_CUR\fP, \fBTMP_MAX\fP, \fBclearerr\fP, \fBfeof\fP, \fBferror\fP, \fBfileno\fP, \fBgetc\fP, \fBgetchar\fP, \fBputc\fP, \fBputchar\fP, \fBstderr\fP, \fBstdin\fP, \fBstdout\fP. Function versions of the macro functions \fBfeof\fP, \fBferror\fP, \fBclearerr\fP, \fBfileno\fP, \fBgetc\fP, \fBgetchar\fP, \fBputc\fP, and \fBputchar\fP exist and will be used if the macros definitions are explicitly removed. .SS "List of functions" .TS ; lb lbx l l. Função Descrição _ \fBclearerr\fP(3) T{ verifica e reconfigura o estado do fluxo T} \fBfclose\fP(3) T{ fecha um fluxo T} \fBfdopen\fP(3) T{ funções de abertura de fluxo T} \fBfeof\fP(3) T{ verifica e reconfigura o estado do fluxo T} \fBferror\fP(3) T{ verifica e reconfigura o estado do fluxo T} \fBfflush\fP(3) T{ descarrega um fluxo T} \fBfgetc\fP(3) T{ lê o próximo caractere ou palavra de um fluxo de entrada T} \fBfgetpos\fP(3) T{ reposiciona um fluxo T} \fBfgets\fP(3) T{ lê uma linha do fluxo T} \fBfileno\fP(3) T{ return the integer descriptor of the argument stream T} \fBfopen\fP(3) T{ funções de abertura de fluxo T} \fBfprintf\fP(3) T{ conversão de saída formatada T} \fBfpurge\fP(3) T{ descarrega um fluxo T} \fBfputc\fP(3) T{ escreve um caractere ou palavra em um fluxo T} \fBfputs\fP(3) T{ escreve uma linha em um fluxo T} \fBfread\fP(3) T{ fluxo binário de entrada/saída T} \fBfreopen\fP(3) T{ funções de abertura de fluxo T} \fBfscanf\fP(3) T{ conversão de formato de entrada T} \fBfseek\fP(3) T{ reposiciona um fluxo T} \fBfsetpos\fP(3) T{ reposiciona um fluxo T} \fBftell\fP(3) T{ reposiciona um fluxo T} \fBfwrite\fP(3) T{ fluxo binário de entrada/saída T} \fBgetc\fP(3) T{ lê o próximo caractere ou palavra de um fluxo de entrada T} \fBgetchar\fP(3) T{ lê o próximo caractere ou palavra de um fluxo de entrada T} \fBgets\fP(3) T{ lê uma linha do fluxo T} \fBgetw\fP(3) T{ lê o próximo caractere ou palavra de um fluxo de entrada T} \fBmktemp\fP(3) T{ cria um nome de arquivo temporário (único) T} \fBperror\fP(3) T{ mensagens de erro do sistema T} \fBprintf\fP(3) T{ conversão de saída formatada T} \fBputc\fP(3) T{ escreve um caractere ou palavra em um fluxo T} \fBputchar\fP(3) T{ escreve um caractere ou palavra em um fluxo T} \fBputs\fP(3) T{ escreve uma linha em um fluxo T} \fBputw\fP(3) T{ escreve um caractere ou palavra em um fluxo T} \fBremove\fP(3) T{ remoção de entrada de diretório T} \fBrewind\fP(3) T{ reposiciona um fluxo T} \fBscanf\fP(3) T{ conversão de formato de entrada T} \fBsetbuf\fP(3) T{ operações de buffering de fluxo T} \fBsetbuffer\fP(3) T{ operações de buffering de fluxo T} \fBsetlinebuf\fP(3) T{ operações de buffering de fluxo T} \fBsetvbuf\fP(3) T{ operações de buffering de fluxo T} \fBsprintf\fP(3) T{ conversão de saída formatada T} \fBsscanf\fP(3) T{ conversão de formato de entrada T} \fBstrerror\fP(3) T{ mensagens de erro do sistema T} \fBsys_errlist\fP(3) T{ mensagens de erro do sistema T} \fBsys_nerr\fP(3) T{ mensagens de erro do sistema T} \fBtempnam\fP(3) T{ rotinas de arquivo temporário T} \fBtmpfile\fP(3) T{ rotinas de arquivo temporário T} \fBtmpnam\fP(3) T{ rotinas de arquivo temporário T} \fBungetc\fP(3) T{ un\-get caractere do fluxo de entrada T} \fBvfprintf\fP(3) T{ conversão de saída formatada T} \fBvfscanf\fP(3) T{ conversão de formato de entrada T} \fBvprintf\fP(3) T{ conversão de saída formatada T} \fBvscanf\fP(3) T{ conversão de formato de entrada T} \fBvsprintf\fP(3) T{ conversão de saída formatada T} \fBvsscanf\fP(3) T{ conversão de formato de entrada T} .TE .SH PADRÕES C11, POSIX.1\-2008. .SH HISTÓRICO C89, POSIX.1\-2001. .SH "VEJA TAMBÉM" \fBclose\fP(2), \fBopen\fP(2), \fBread\fP(2), \fBwrite\fP(2), \fBstdout\fP(3), \fBunlocked_stdio\fP(3) .PP .SH TRADUÇÃO A tradução para português brasileiro desta página man foi criada por Valter Ferraz Sanches e André Luiz Fassone . .PP Esta tradução é uma documentação livre; leia a .UR https://www.gnu.org/licenses/gpl-3.0.html Licença Pública Geral GNU Versão 3 .UE ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita. .PP Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para .MT debian-l10n-portuguese@lists.debian.org a lista de discussão de tradutores .ME .