al_ustr_offset(3)

💖 NAME 💖

Okay bestie, this is al_ustr_offset(3) from the Library Functions Manual, and it’s giving Allegro 5 API energy ✨

al_ustr_offset — Allegro 5 API 💅

---

🌸 SYNOPSIS 🌸

#include <allegro5/allegro.h>

int al_ustr_offset(const ALLEGRO_USTR *us, int index)

🦋 DESCRIPTION 🦋

So this function returns the byte offset — from the start of the string — of the code point at the index you pass in. It’s literally answering “where does this character live in the bytes?” and honestly? iconic 🎀

Pass in index as zero and you get the first character of the string. Zero means first, no cap 💯

If index is negative, it counts backward from the end of the string, so an index of -1 returns an offset to the last code point. Backwards counting? She ate 💅

If index is past the end of the string, it returns the offset of the end of the string. Chill, lowkey, no drama 🦋

⭐ SEE ALSO ⭐

• al_ustr_length(3) — go read that one too, bestie 🫶

---

Signed off by the Allegro reference manual — that’s the source/version chilling at the bottom of this page. Date? Not on this footer, bestie, so I’m not making one up 😭💖