fgetc, fgetwc
Ler um caractere de um fluxo.
int fgetc(
FILE *stream
);
wint_t fgetwc(
FILE *stream
);
Parâmetros
- stream
Ponteiro para FILE estrutura.
Valor de retorno
fgetc Retorna o caractere lido sistema autônomo um int Retorna ou EOF para indicar um erro ou o participante do arquivo. fgetwc Retorna, sistema autônomo um wint_t, o caractere de largo que corresponde ao caractere de leitura ou retorna WEOF para indicar um erro ou o participante do arquivo. Para ambas as funções, use feof ou ferror para distinguir entre um erro e uma condição de participante de arquivo. Se ocorrer um erro de leitura, o indicador de erro para o fluxo está conjunto.If stream é NULL, fgetc e fgetwc chamar o manipulador de parâmetro inválido sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções conjunto errno para EINVAL e retornar EOF.
Comentários
Cada uma dessas funções lê um único caractere de posição corrente do arquivo associado a stream. A função então incrementa o ponteiro de arquivo associado (se definidas) para apontar para o próximo caractere.Se o fluxo está no participante do arquivo, o indicador de participante de arquivo para o fluxo é definido.
fgetc é equivalente a getc, mas é implementado somente sistema autônomo uma função, em vez de uma função e uma macro.
fgetwc é a versão de caractere largo da fgetc; ele lê c sistema autônomo um caractere de vários bytes ou um caractere largo de acordo com a stream é aberto no modo de texto ou no modo binário.
As versões com o _nolock sufixo são idênticas exceto que eles não estão protegidos contra interferência por outros threads.
Para obter mais informações sobre o processamento ampla e caracteres multibyte em texto e modos de binário, consulte Unicode fluxo E/S no texto e modos binário.
Mapeamentos de rotina de texto genérica
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS 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 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 );
}
Entrada: crt_fgetc.txt
Line one.
Line two.
Saída
Line one.
Line two.