pack_fgets(3alleg4) [debian man page]

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)