Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pack_fgets(3)			 Allegro manual 		   pack_fgets(3)

NAME
     pack_fgets  -  Reads  a  line from the stream. Allegro game programming li-
     brary.

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  re-
     turned  string, in order to provide easy code portability across platforms.
     If you need the carriage return, use pack_fread()	and/or	pack_getc()  in-
     stead.

     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)

Allegro 			  version 4.4.3 		   pack_fgets(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pack_fgets&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help