Uso e exemplo da função fgets() da biblioteca C

Biblioteca Padrão - <stdio.h>

Função da biblioteca C char *char fgets(char *str, int n, FILE *stream) Ler uma linha do fluxo especificado stream e armazená-la em str no string apontada. (n-1) caracteres ou encontrar o caractere de nova linha ou chegar ao final do arquivo, ele para, dependendo do caso.

Declaração

Abaixo está a declaração da função fgets().

char　*char fgets(char　*str, int n, FILE　*stream)

Parâmetros

• str -- Este é um ponteiro para um array de caracteres, que armazena a string a ser lida.

• n -- Este é o número máximo de caracteres a serem lidos (incluindo o caractere nulo final). Geralmente é a mesma que a长度 do array passado por str.

• stream -- Este é um ponteiro para um objeto FILE, que identifica o fluxo a ser lido.

Retorno

Se for bem-sucedido, a função retorna o mesmo parâmetro str. Se chegar ao final do arquivo ou não ler nenhum caractere, o conteúdo de str permanece inalterado e retorna um ponteiro vazio.

Se houver erro, retorna um ponteiro vazio.

Exemplo Online

Abaixo está um exemplo de uso da função fgets().

#include <stdio.h>
int main()
{
　　　FILE　*fp;
　　　char str[60];
　　　/*　Abrir arquivo para leitura　*/
　　　fp = fopen("file.txt", "r");
　　　if(fp == NULL) {
　　　　　　perror("Erro ao abrir arquivo");
　　　　　　return(-1:
　　　}
　　　if( fgets(str,　60, fp)!=NULL ) {
　　　　　　/*　Escrever conteúdo no saída padrão stdout　*/
　　　　　　puts(str);
　　　}
　　　fclose(fp);
　　　
　　　return(0);
}

Suponha que tenhamos um arquivo de texto file.txtSeu conteúdo é o seguinte. O arquivo será usado como entrada no exemplo:

Estamos em　2009

Vamos compilar e executar o programa acima, o que produzirá o seguinte resultado:

Estamos em　2009

Biblioteca Padrão - <stdio.h>