get_font_ranges(3)

✨ get_font_ranges ✨

okay bestie, gather round, it's a get_font_ranges(3) moment 💖 this one lives in the Allegro manual, and it's literally the Allegro game programming library, so you know it's iconic 💅

---

🌸 NAME 🌸

get_font_ranges — returns the number of character ranges in a font. Allegro game programming library. 🎀

---

🦋 SYNOPSIS 🦋

#include <allegro.h>

int get_font_ranges(FONT *f)

no cap, that's the whole signature, it's giving short and sweet ✨

---

💜 DESCRIPTION 💜

so like, you call this function when you wanna know how many character ranges are in a font. that's it, that's the job 🫶

but listen — knowing the count is only the appetizer, bestie. you then gotta go query each one of those ranges with get_font_range_begin() and get_font_range_end() to actually find out what characters are available in the font. like, the count tells you how many lil boxes to open, and those two functions tell you what's inside each box 📦✨

here's the example, verbatim, because I would never mess with your code:

FONT *f;
int range;
int n;
...

range = get_font_ranges(f);
printf("The font has %d character ranges:\n", range);
for (n = 0; n < range; n++)
   printf("Range %d from 0x%03x - 0x%03x\n",
          get_font_range_begin(f, n),
          get_font_range_end(f, n));

look at that loop go, it's literally the main character 👑

---

🎀 RETURN VALUE 🎀

it hands you back the number of continuous character ranges in a font 💚

OR — and this is the plot twist — it returns -1 if that information is not available 😭 so fr fr, check for the -1, don't just assume you got a real number, that's the vibe check you cannot skip 🙈

---

👑 SEE ALSO 👑

go read these next, they're the whole friend group:

• get_font_range_begin(3)
• get_font_range_end(3)
• transpose_font(3)

---

and that's the page, babe 🦋 this was Allegro version 4.4.3, documented on the get_font_ranges(3) page — mwah, go forth and count your ranges 💅✨💖