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.

PADRÕES¶

The stdio library conforms to C99.

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 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.