buffer_peekc(3)

✨ NAME ✨

buffer_peekc — read one char from buffer 👀

🎀 SYNTAX 🎀

okay so first you gotta pull in the header, bestie:

#include <libowfat/buffer.h>

int buffer_peekc(buffer* b,char* x);

💅 DESCRIPTION 💅

So buffer_peekc(b,x) is literally the same vibe as buffer_get(b,x,1), except — and this is the whole point, the moment, the main character energy — it does not advance the buffer pointer. 🫶

Which means if you call it again, or you call buffer_getc right after it, you get the exact same data again. It's giving "look but don't touch". It's giving window shopping. No cap. 🦋

peek responsibly bestie, the pointer is staying exactly where it is 🌸

🔥 RETURN VALUE 🔥

• 1 — slay, success, you got your char 💖
• 0 — you've hit the end of the file, that's a wrap 🥲
• -1 — there was an I/O error, and it sets errno appropriately so you can go find out what went wrong 💀

👑 SEE ALSO 👑

• buffer_init(3)
• buffer_get(3)
• buffer_getc(3)
• buffer(3)

and that's the tea, bestie 🍓 this lil icon lives in the Library Functions Manual, filed under buffer_peekc(3) — go peek at your buffers, but like, respectfully 💜🧚