debian man page for pack_fgets

pack_fgets(3alleg4)						  Allegro manual					       pack_fgets(3alleg4)

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)

Allegro 							   version 4.4.2					       pack_fgets(3alleg4)