get_uformat(3alleg4)

💖 get_uformat — bestie edition 💖

okay so this is from the Allegro manual, and it's giving "tiny function, big vibes". lowkey one of those little guys that just tells you a thing. no cap.

✨ NAME ✨

get_uformat — finds out what text encoding format is currently selected. Also: it's part of the Allegro game programming library. 🎀

🌸 SYNOPSIS 🌸

#include <allegro.h>

int get_uformat(void);

🦋 DESCRIPTION 🦋

so basically: it finds out what text encoding format is currently selected. that's it. that's the whole job. and honestly? it ate. 💅

ngl though, this one is probably useful only if you're writing an Allegro addon that deals with text strings, and you want to take a different codepath for each possible format. like, you're out here handling multiple encodings and you need to know which one you're in. iykyk. 🙈

example, bestie — literally copy this vibe:

switch(get_uformat()) {
   case U_ASCII:
      do_something();
      break;
   case U_UTF8:
      do_something_else();
      break;
   ...
}

not me writing a switch statement with a ... in it, iconic behaviour fr fr. but that's literally what the manpage shows so that's what you get. 💖

⭐ RETURN VALUE ⭐

it returns the currently selected text encoding format. that's the whole tea. ☕

if you want the actual list of encoding formats, go read the documentation of set_uformat() — that's where the formats are listed, not here. this function is just the messenger, not the encyclopedia. 🧚

🔥 SEE ALSO 🔥

• set_uformat(3alleg4) — the sibling. the other half. go read it for the format list. 👑

Allegro, version 4.4.3. that's the source and the version, bestie — consider this your cute lil sign-off. stay encoded, stay slay. 🌈💜✨