fgets, fgetws
Obtenha uma seqüência de caracteres 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 retornará str. NULL é retornado para indicar um erro ou uma condição de participante de arquivo. Use feof ou ferror para determinar se ocorreu um erro. If 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 for permitida para continuar, errno é definido como EINVAL e a função retorna NULL.
See _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre esses e outros, códigos de erro.
Comentários
The fgets função lê uma seqüência de caracteres de entrada stream argumento e o armazena no str. fgets Lê caracteres da posição corrente fluxo e incluindo o primeiro caractere de nova linha ao participante do fluxo, ou até que o número de caracteres lidos é igual a n – 1, o que vier primeiro. O resultado armazenado em str é anexado com um caractere nulo. A nova linha de caractere, se ler, incluídos na seqüência.
fgetws é uma versão de caractere largo da fgets.
fgetws lê o argumento de caractere largo str sistema autônomo uma seqüência de caracteres multibyte ou uma seqüência de caracteres largos acordo com a stream é aberto no modo de texto ou no modo binário, respectivamente. Para obter mais informações sobre como usar o texto e modos de binários em Unicode e multibyte fluxo de I/O, consulte Texto e o modo binário arquivo I/O and Unicode Stream I/O no texto e modos binários.
Mapeamentos de rotina de texto genérica
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS 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 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 );
}
}
Entrada: crt_fgets.txt
Line one.
Line two.
Saída
Line one.