Retorna uma string com até comprimento - 1 bytes lidos do arquivo apontado por fp. A leitura acaba quando comprimento - 1 bytes foram lidos, em uma nova linha (newline) (que é incluida no valor retornado), ou em um fim de arquivo (eof) (o que acontecer primeiro).
Se um erro ocorrer, retorna FALSE.
Equivocos comuns:
Pessoas acostumadas a semantica do fgets em 'C' devem notar a diferenca em como o fim do arquivo (eof) é retornado.
O ponteiro para o arquivo deve ser válido e deve apontar para um arquivo aberto com sucesso por fopen(), popen(), ou fsockopen().
Um simples exemplo segue:
Veja também fread(), fopen(), popen(), fgetc(), fsockopen(), e socket_set_timeout().