stdio(3)

NOME
stdio - funções de biblioteca padrão de entrada/saída

BIBLIOTECA
Biblioteca C Padrão (libc, -lc)

SINOPSE
#include <stdio.h>

FILE *stdin;
FILE *stdout;
FILE *stderr;

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.

A stream is associated with an external file (which may be a physical device) by opening 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 file position indicator 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 fgetc(3) function; all output takes place as if all characters were written by successive calls to the fputc(3) function.

Um arquivo é desassociado de um fluxo pelo fechamento, 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 FILE é indeterminado após um arquivo ser fechado (lixo).

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 exit(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 abort(3) não se preocupam em fechar os arquivos de maneira apropriada.

At program startup, three text streams are predefined and need not be opened explicitly: standard input (for reading conventional input), standard output (for writing conventional output), and standard error (for writing diagnostic output). These streams are abbreviated stdin, stdout, and stderr. 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.

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 fflush(3) a saída padrão antes de desligar e processar então a saída aparecerá.

The stdio library is a part of the library libc and routines are automatically loaded as needed by cc(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.

The following are defined as macros; these names may not be reused without first removing their current definitions with #undef: BUFSIZ, EOF, FILENAME_MAX, FOPEN_MAX, L_cuserid, L_ctermid, L_tmpnam, NULL, SEEK_END, SEEK_SET, SEEK_CUR, TMP_MAX, clearerr, feof, ferror, fileno, getc, getchar, putc, putchar, stderr, stdin, stdout. Function versions of the macro functions feof, ferror, clearerr, fileno, getc, getchar, putc, and putchar exist and will be used if the macros definitions are explicitly removed.

  List of functions
Função | Descrição
clearerr(3) | verifica e reconfigura o estado do fluxo
fclose(3) | fecha um fluxo
fdopen(3) | funções de abertura de fluxo
feof(3) | verifica e reconfigura o estado do fluxo
ferror(3) | verifica e reconfigura o estado do fluxo
fflush(3) | descarrega um fluxo
fgetc(3) | lê o próximo caractere ou palavra de um fluxo de entrada
fgetpos(3) | reposiciona um fluxo
fgets(3) | lê uma linha do fluxo
fileno(3) | return the integer descriptor of the argument stream
fopen(3) | funções de abertura de fluxo
fprintf(3) | conversão de saída formatada
fpurge(3) | descarrega um fluxo
fputc(3) | escreve um caractere ou palavra em um fluxo
fputs(3) | escreve uma linha em um fluxo
fread(3) | fluxo binário de entrada/saída
freopen(3) | funções de abertura de fluxo
fscanf(3) | conversão de formato de entrada
fseek(3) | reposiciona um fluxo
fsetpos(3) | reposiciona um fluxo
ftell(3) | reposiciona um fluxo
fwrite(3) | fluxo binário de entrada/saída
getc(3) | lê o próximo caractere ou palavra de um fluxo de entrada
getchar(3) | lê o próximo caractere ou palavra de um fluxo de entrada
gets(3) | lê uma linha do fluxo
getw(3) | lê o próximo caractere ou palavra de um fluxo de entrada
mktemp(3) | cria um nome de arquivo temporário (único)
perror(3) | mensagens de erro do sistema
printf(3) | conversão de saída formatada
putc(3) | escreve um caractere ou palavra em um fluxo
putchar(3) | escreve um caractere ou palavra em um fluxo
puts(3) | escreve uma linha em um fluxo
putw(3) | escreve um caractere ou palavra em um fluxo
remove(3) | remoção de entrada de diretório
rewind(3) | reposiciona um fluxo
scanf(3) | conversão de formato de entrada
setbuf(3) | operações de buffering de fluxo
setbuffer(3) | operações de buffering de fluxo
setlinebuf(3) | operações de buffering de fluxo
setvbuf(3) | operações de buffering de fluxo
sprintf(3) | conversão de saída formatada
sscanf(3) | conversão de formato de entrada
strerror(3) | mensagens de erro do sistema
sys_errlist(3) | mensagens de erro do sistema
sys_nerr(3) | mensagens de erro do sistema
tempnam(3) | rotinas de arquivo temporário
tmpfile(3) | rotinas de arquivo temporário
tmpnam(3) | rotinas de arquivo temporário
ungetc(3) | un-get caractere do fluxo de entrada
vfprintf(3) | conversão de saída formatada
vfscanf(3) | conversão de formato de entrada
vprintf(3) | conversão de saída formatada
vscanf(3) | conversão de formato de entrada
vsprintf(3) | conversão de saída formatada
vsscanf(3) | conversão de formato de entrada

PADRÕES
C11, POSIX.1-2008.

HISTÓRICO
C89, POSIX.1-2001.

VEJA TAMBÉM
close(2), open(2), read(2), write(2), stdout(3), unlocked_stdio(3)

TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por Valter Ferraz Sanches <vfs@ezlinux.cjb.net> e André Luiz Fassone <lonely_wolf@ig.com.br>

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 (https://www.gnu.org/licenses/gpl-3.0.html) ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores (debian-l10n-portuguese@lists.debian.org).