al_get_font_ranges(3)

✨ al_get_font_ranges ✨

okay bestie, so this one's from the Allegro 5 API — yes, the whole library, and this page is literally just about one lil function. it's giving "small but mighty" energy. 🎀

---

🌸 SYNOPSIS 🌸

like, here's the whole vibe of what you're calling:

#include <allegro5/allegro_font.h>

int al_get_font_ranges(ALLEGRO_FONT *f, int ranges_count, int *ranges)

no cap, that's it. that's the whole signature. 🫶

---

💖 DESCRIPTION 💖

so this function is basically the font's receipt — it tells you every single glyph that's actually in the font, and it hands them to you as a list of ranges. not one by one, no ma'am, as ranges. and those ranges? they have the exact same format as al_grab_font_from_bitmap(3) uses, so iykyk. 🦋

here's the tea on the args:

• ranges_count — this is the maximum number of ranges that will be returned. it's your ceiling, your limit, your "bestie i can only take so much" threshold. 💅
• ranges — this should be an array with room for ranges_count * 2 elements. yeah, times two. because each range takes up a pair of spots: the even integers are the first unicode point in a range, and the odd integers are the last unicode point in a range. literally alternating, it's a whole pattern. ✨

and the return value? the number of ranges contained in the font — even if it is bigger than ranges_count. 😭 so yes, it will absolutely tell you the truth about how many ranges there are even when your array is too small to hold them all. it's honest like that. not me being told i need 40 ranges when i only brought room for 10. 💀

---

⭐ SINCE ⭐

5.1.4 — a vintage queen, an icon, been here a minute. 👑

---

🔥 SEE ALSO 🔥

• al_grab_font_from_bitmap(3) — the sibling, the one with the matching range format. go say hi. 🌈

---

that's the page, bestie! 🧚 this lil write-up came from the Allegro reference manual, covering version 5.1.4 of the Allegro 5 API — and yes, check the header date up top if you need the timestamp, 'cause it's right there waiting for you. mwah! 💜💅