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)