Provided by: allegro4-doc_4.4.3.1-3_all bug

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)