get_font_range_begin(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

✨ get_font_range_begin ✨

okay so bestie, we're diving into the Allegro manual today, and this one is get_font_range_begin(3) — yes, that's the manual page name, and yes, it's a real one, it's not me being dramatic. 💅

🌸 NAME 🌸

get_font_range_begin — returns the start of a character range in a font. And like, it lives in the Allegro game programming library</>, which is the whole vibe here. 🎀

🦋 SYNOPSIS 🦋

#include <allegro.h>

int get_font_range_begin(FONT *f, int range)

💖 DESCRIPTION 💖

okay so here's the tea: this function lets you find out the start of a specific character range for a font. that's literally it, that's the whole job. 🫶

you've got options for what you pass as the range parameter, and the way this works is:

  • pass -1 if you wanna know the start of the whole font range — the entire thing, the full picture, main character energy
  • or pass a number from 0 to (but not including) get_font_ranges(f) if you want the start of one specific character range in the font

like, the upper bound is exclusive, bestie, don't come for me, that's just how it is. 🙈

and here's an example so you can see it in the wild:

printf("The font has a character range of %d - %d\n",
       get_font_range_begin(font, -1),
       get_font_range_end(font, -1));

look at that, get_font_range_begin and get_font_range_end holding hands, iconic duo fr fr. 👑

⭐ RETURN VALUE ⭐

it returns the first character in the font range, or -1 if that information is not available. that's the whole deal. no cap. 💀

🌈 SEE ALSO 🌈

go read those too, they're all part of the same little font family. 🍓

and that's the page, bestie!! this was Allegro version 4.4.3, brought to you by the Allegro manual, dated way back when but still serving looks. mwah, go forth and range responsibly. 💜✨🧚

📦 where this page comes from