getc, getwc

Artigo
06/09/2015

Lê um caractere de um fluxo.

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

Parâmetros

stream
Fluxo de entrada.

Valor de retorno

Retorna a leitura de caracteres. Para indicar um erro de leitura ou uma condição de participante de Arquivo, retorna EOFde getc , e retorna WEOFde getwc . Para getc, use ferror ou feof para verificar para um erro ou a fim de arquivo. Se stream é NULL, getc e getwc invoca o manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro. Se a execução for permitida continuar, essas funções EOF de retorno (ou WEOF paragetwc) e errno definido como EINVAL.

Para obter mais informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.

Comentários

Cada rotina ler um único caractere de um arquivo na posição atual e incrementa o ponteiro de arquivo associado (se definido) para apontar para o próximo caractere. O arquivo é associado a stream.

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

As observações específicas da rotina são as seguintes:

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

Mapeamentos da rotina de texto genérico

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_gettc	getc	getc	getwc

Requisitos

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

Para 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);
}