fgetc, fgetwc

Artigo
02/25/2013

Ler um caractere a partir de um fluxo.

int fgetc( 
   FILE *stream 
);
wint_t fgetwc( 
   FILE *stream 
);

Parâmetros

stream
Ponteiro para FILE estrutura.

Valor de retorno

fgetcRetorna o caractere lido como um int ou retorna EOF para indicar um erro ou o fim do arquivo.fgetwcRetorna, como um wint_t, o caractere de largo que corresponde ao caractere de leitura ou retorna WEOF para indicar um erro ou o fim do arquivo.Para ambas as funções, use feof ou ferror para distinguir entre um erro e uma condição de fim-de-arquivo.Se ocorrer um erro de leitura, o indicador de erro para o fluxo é definido.Se stream é NULL, fgetc e fgetwc 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 definir errno para EINVAL e retornar EOF.

Comentários

Cada uma dessas funções lê um único caractere a partir da posição atual do arquivo associado a stream.A função, em seguida, incrementa o ponteiro de arquivo associado (se definido) para apontar para o próximo caractere.Se o fluxo está no fim do arquivo, o indicador de final de arquivo para o fluxo é definido.

fgetcé equivalente a getc, mas é implementada apenas como uma função em vez de uma função e uma macro.

fgetwcé a versão de caractere largo da fgetc; ele lê c como um caracteres multibyte ou um caractere largo de acordo com a stream é aberto no modo de texto ou binário.

As versões com o _nolock sufixo são idênticas exceto que eles não são protegidos contra interferência por outros threads.

Para obter mais informações sobre o processamento de caracteres de largura e caracteres multibyte em modos de texto e binários, consulte I/O fluxo de Unicode em texto e modos de 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
_fgettc	fgetc	fgetc	fgetwc

Requisitos

Função	Cabeçalho necessário
fgetc	<stdio.h>
fgetwc	<stdio.h> ou <wchar.h>

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

Exemplo

// crt_fgetc.c
// This program uses getc to read the first
// 80 input characters (or until the end of input)
// and place them into a string named buffer.
 

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

int main( void )
{
   FILE *stream;
   char buffer[81];
   int  i, ch;

   // Open file to read line from:
   fopen_s( &stream, "crt_fgetc.txt", "r" );
   if( stream == NULL )
      exit( 0 );

   // Read in first 80 characters and place them in "buffer": 
   ch = fgetc( stream );
   for( i=0; (i < 80 ) && ( feof( stream ) == 0 ); i++ )
   {
      buffer[i] = (char)ch;
      ch = fgetc( stream );
   }

   // Add null to end string 
   buffer[i] = '\0';
   printf( "%s\n", buffer );
   fclose( stream );
}