Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

stdin — fluxo de entrada padrão

`stdin` de `<stdio.h>` aponta para o fluxo de entrada padrão. Passe-o às funções de entrada; não é necessário abri-lo primeiro.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <stdio.h>
stdin

stdin é uma macro de <stdio.h> que se expande numa expressão do tipo FILE *. Num ambiente hosted, aponta para o fluxo de texto de entrada padrão, aberto no arranque do programa. Não significa exclusivamente o teclado.

O exemplo lê um fragmento de linha. fgets mantém o carácter de nova linha que lê e acrescenta um carácter nulo; o buffer comporta, no máximo, 31 caracteres lidos. O resto de uma linha mais longa permanece no fluxo.

fgets devolve NULL se ocorrer um erro de leitura ou se atingir o fim do ficheiro sem ler nenhum carácter. ferror(stdin) verifica se o indicador de erro do fluxo está ativo, não se a última chamada a fgets falhou devido a um erro de leitura. Se um erro anterior tiver deixado o indicador ativo, ferror(stdin) pode devolver um valor diferente de zero mesmo quando uma chamada posterior a fgets devolve NULL por ter atingido o fim do ficheiro. Neste exemplo, a verificação distingue os dois casos porque a chamada a fgets é a primeira operação sobre stdin. Não utilize fflush(stdin) para descartar a entrada: a norma C não define essa utilização.

Exemplos

#include <stdio.h>
#include <stdlib.h>

/* To reproduce the sample output, supply Hello followed by a newline on stdin. */
int main(void)
{
    char line[32];

    if (fgets(line, sizeof line, stdin) == NULL) {
        return ferror(stdin) ? EXIT_FAILURE : EXIT_SUCCESS;
    }
    if (fputs(line, stdout) == EOF || fflush(stdout) == EOF) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Resultado

Hello

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes