NAME

       pack_fgets - Reads a line from the stream. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       char *pack_fgets(char *p, int max, PACKFILE *f);

DESCRIPTION

       Reads  a  line  from  the  stream `f', storing it at location pointed to by `p'. Stops when a linefeed is
       encountered, or `max' bytes have been  read.   The  end  of  line  is  handled  by  detecting  the  right
       combination  of  characters  for the platform. This supports CR-LF (DOS/Windows), LF (Unix), and CR (Mac)
       formats. However, the trailing carriage return is not included  in  the  returned  string,  in  order  to
       provide  easy code portability across platforms. If you need the carriage return, use pack_fread() and/or
       pack_getc() instead.

       Note: This function internally may make calls to pack_ungetc, so  you  cannot  use  pack_ungetc  directly
       afterwards.

       Example:

          char buf[256];
          ...
          while (pack_fgets(buf, sizeof(buf), input_file)) {
             /* Process input line. */
          }
          fclose(input_file);

RETURN VALUE

       Returns the pointer `p' on success, or NULL on error.

SEE ALSO

       pack_fopen(3alleg4),       pack_fopen_chunk(3alleg4),       pack_fread(3alleg4),      pack_getc(3alleg4),
       pack_ungetc(3alleg4)