pack_fgets(3)

💖 pack_fgets(3) — the Allegro manual, but make it cute 💖

okay bestie, welcome to the Allegro manual, section 3 (that's the library functions girlies ✨). today's main character is pack_fgets, and she's here to read you a whole entire line. periodt.

---

✨ NAME ✨

pack_fgets — reads a line from the stream. it's giving Allegro game programming library energy 🎀

---

🌸 SYNOPSIS 🌸

#include <allegro.h>

char *pack_fgets(char *p, int max, PACKFILE *f);

---

🦋 DESCRIPTION 🦋

so basically, this function reads a line from the stream f, and stores it at the location pointed to by p. iconic behavior, no cap.

it stops when it hits a linefeed, or when max bytes have been read — whichever comes first, and honestly same.

the end of line is handled by detecting the right combination of characters for the platform. she's multilingual, she's cultured 💅. she supports:

• CR-LF (DOS/Windows)
• LF (Unix)
• CR (Mac)

formats. however!! the trailing carriage return is not included in the returned string, and that's on purpose — it's so your code stays easy to port across platforms. it's giving cross-platform queen. if you actually need that carriage return, use pack_fread() and/or pack_getc() instead. iykyk.

📝 Note: this function internally may make calls to pack_ungetc, so you cannot use pack_ungetc directly afterwards. like, she already used it, bestie. it's taken. 🙈

Example:

char buf[256];
...
while (pack_fgets(buf, sizeof(buf), input_file)) {
   /* Process input line. */
}
fclose(input_file);

look at her looping like that 😭 ate and left no crumbs.

---

🌈 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)

---

and that's the whole page, bestie! this lil' section of the Allegro manual is from version 4.4.3, and you've been reading pack_fgets(3) 🫶 go read a line, slay, and remember: no trailing carriage returns in this house. bye bestie!! 👑✨🌸