pack_ungetc(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

💖 pack_ungetc — Allegro manual, bestie edition 💖

okay so real quick before anything: this is pack_ungetc(3) from the Allegro game programming library, and she is that girl. tiny function, big energy. let's get into it 🫶

✨ NAME ✨

pack_ungetc — moves one single character back to the input buffer. yeah. one. single. character. we'll get to why that word is doing heavy lifting here, Allegro game programming library girlies, this one's for you 🎀

🌸 SYNOPSIS 🌸

#include <allegro.h>

int pack_ungetc(int c, PACKFILE *f);

look at her. two args, one int, zero drama. the way that signature just works 💅

🦋 DESCRIPTION 🦋

so basically, bestie, pack_ungetc puts a character back into the file's input buffer. you know how you read something and then you're like "wait, actually, no, put that back, i wasn't ready"? that's her. she's the undo button for one (1) character. iconic behaviour honestly 😭

and like with ungetc from libc, only a single push back is guaranteed. so don't be greedy and try to shove a whole vibe back in there — one character, one shot. no cap. ⭐

note, and this one is important fr fr: pack_fgets internally uses pack_ungetc, so never use pack_ungetc directly after using pack_fgets on a PACKFILE. like, never. that's a collision, that's chaos, that's not the move. 🙈 this is the "two people showing up to the same party in the same outfit" of file I/O and one of them is gonna have a bad time 💀

👑 RETURN VALUE 👑

  • returns c on success 🥳 slay, we love a successful push back
  • or EOF on error 😔 and that's the whole range, no in-between, no secret third thing

🌈 SEE ALSO 🌈

go read those too, they're all in the same friend group, iykyk 💜

and that's the whole page!! short, sweet, and lowkey essential. this was pack_ungetc(3) from Allegro, version 4.4.3 — mwah, sending you and your input buffer nothing but love, go forth and push back exactly one character, periodt 💅✨🧚‍♀️

📦 where this page comes from