ugetc(3alleg4)

✨ ugetc ✨

okay so bestie, welcome to the Allegro manual — yes, that Allegro, the game programming library, and today's main character is ugetc. it's a low level helper function for reading Unicode text data. lowkey iconic, highkey underrated. 💅

🌸 NAME 🌸

ugetc — low level helper function for reading Unicode text data. Allegro game programming library. periodt.

🦋 SYNOPSIS 🦋

#include <allegro.h>

int ugetc(const char *s);

like, that's the whole vibe. one include, one function, no drama. 🎀

💖 DESCRIPTION 💖

so here's the tea: ugetc is a low level helper function for reading Unicode text data. that's literally its whole job and it does it slayfully. no cap.

and because Allegro knows we love a lil demo, here's the example straight from the source:

int first_unicode_letter = ugetc(text_string);

not me reading the first Unicode letter of a string with one (1) function call. obsessed. ✨

👑 RETURN VALUE 👑

it returns the character pointed to by s in the current encoding format. yes bestie, the current one — whatever encoding you've got going on right now, that's the one it's reading through. no guessing, no converting, just vibes and the current encoding. 🫶

🌈 SEE ALSO 🌈

the whole friend group, fr fr:

• ugetx(3alleg4)
• usetc(3alleg4)
• uwidth(3alleg4)
• ucwidth(3alleg4)
• uisok(3alleg4)

go give them a read too, they're all part of the Unicode squad. 💜

and that's the page!! brought to you by Allegro, version 4.4.3 — mwah, ty for coming to my TED talk, ily, go read your Unicode strings responsibly. 💖✨🎀🦋🌸💅