getc, getwc

Artigo
02/25/2013

Ler um caractere a partir de um fluxo.

int getc( 
   FILE *stream 
);
wint_t getwc( 
   FILE *stream 
);

Parâmetros

stream
Fluxo de entrada.

Valor de retorno

Retorna o caractere de leitura.Para indicar um erro de leitura ou a condição de final de arquivo, getc retorna EOF, e getwc retorna WEOF.Para getc, use ferror ou feof para verificar se um erro ou para o final do arquivo.Se stream é NULL, getc e getwc chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, essas funções retornam EOF (ou WEOF paragetwc) e defina errno para EINVAL.

Consulte _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre estes e outros, códigos de erro.

Comentários

Cada rotina lê um único caractere de um arquivo na posição atual e incrementos o ponteiro de arquivo associado (se definido) para apontar para o próximo caractere.O arquivo está associado stream.

Essas funções bloquear o thread de chamada e, portanto, são thread-safe.Para obter uma versão não-bloqueio, consulte _getc_nolock, _getwc_nolock.

Siga a rotina específica comentários.

Rotina	Comentários
getc	Mesmo que fgetc, mas implementado como uma função e uma macro.
getwc	Versão de caractere largo do getc.Lê um caracteres multibyte ou um caractere largo de acordo com a stream é aberto no modo de texto ou binário.

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_gettc	getc	getc	getwc

Requisitos

Rotina	Cabeçalho necessário
getc	<stdio.h>
getwc	<stdio.h> ou <wchar.h>

Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.

Exemplo

// crt_getc.c
// Use getc to read a line from a file.

#include <stdio.h>

int main()
{
    char buffer[81];
    int i, ch;
    FILE* fp;
    
    // Read a single line from the file "crt_getc.txt". 

    fopen_s(&fp, "crt_getc.txt", "r");
    if (!fp)
    {
       printf("Failed to open file crt_getc.txt.\n");
       exit(1);
    }

    for (i = 0; (i < 80) && ((ch = getc(fp)) != EOF)
                         && (ch != '\n'); i++)
    {
        buffer[i] = (char) ch;
    }
       
    // Terminate string with a null character 
    buffer[i] = '\0';
    printf( "Input was: %s\n", buffer);

    fclose(fp);
}