pack_fgets

Section: Allegro manual (3)
Updated: version 4.2.2
Index Return to Main Contents
 

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(3), pack_fopen_chunk(3), pack_fread(3), pack_getc(3), pack_ungetc(3)