fgets, fgetws

Artigo
02/25/2013

Obtenha uma seqüência de caracteres a partir de um fluxo.

char *fgets( 
   char *str,
   int n,
   FILE *stream 
);
wchar_t *fgetws( 
   wchar_t *str,
   int n,
   FILE *stream 
);

Parâmetros

str
Local de armazenamento de dados.
n
Número máximo de caracteres a serem lidos.
stream
Ponteiro para FILE estrutura.

Valor de retorno

Cada uma dessas funções retorna str.NULLé retornado para indicar um erro ou uma condição de fim-de-arquivo.Use feof ou ferror para determinar se ocorreu um erro.Se str ou stream é um ponteiro nulo, ou n é menor ou igual a zero, essa função chama o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, errno for definido como EINVAL e a função retornará NULL.

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

Comentários

O fgets função lê uma seqüência de caracteres provenientes da entrada stream argumento e o armazena em str.fgetsLê caracteres da posição do fluxo atual e incluindo o primeiro caractere de nova linha, até o fim do fluxo, ou até que o número de caracteres lidos é igual a n – 1, que vier primeiro.O resultado é armazenado em str é acrescentado com um caractere nulo.A nova linha de caracteres, se ler, está incluído na seqüência de caracteres.

fgetwsé uma versão de caractere largo de fgets.

fgetwslê o argumento de caractere largo str como uma seqüência de caracteres multibyte ou uma seqüência de caracteres largos acordo com a stream é aberto no modo de texto ou o modo binário, respectivamente.Para obter mais informações sobre como usar os modos de texto e binários em Unicode e multibyte fluxo de I/O, consulte texto e binário e/S de arquivos de modo e 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
_fgetts	fgets	fgets	fgetws

Requisitos

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

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

Exemplo

// crt_fgets.c
// This program uses fgets to display
// a line from a file on the screen.
//

#include <stdio.h>

int main( void )
{
   FILE *stream;
   char line[100];

   if( fopen_s( &stream, "crt_fgets.txt", "r" ) == 0 )
   {
      if( fgets( line, 100, stream ) == NULL)
         printf( "fgets error\n" );
      else
         printf( "%s", line);
      fclose( stream );
   }
}