al_ustr_insert(3)

🎀 al_ustr_insert(3) — Library Functions Manual 🎀

okay so bestie, this is the al_ustr_insert(3) page from the Library Functions Manual, and it's literally about sliding one Allegro string into another at a byte offset. main character string surgery energy, honestly. ✨

💖 NAME 💖

al_ustr_insert — Allegro 5 API

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

bool al_ustr_insert(ALLEGRO_USTR *us1, int pos, const ALLEGRO_USTR *us2)

🦋 DESCRIPTION 🦋

So here's the vibe: al_ustr_insert inserts us2 into us1, starting at the byte offset pos. that's the whole mission. 🫶

Important: pos cannot be less than 0. not allowed, no cap. 🚫

If pos is past the end of us1, then the space between the end of the string and pos gets padded with NUL ('\0') bytes. yes, it will literally fill the gap. 💀

If required, use al_ustr_offset(3) to find the byte offset for a given code point index — that's the helper for this exact situation. iykyk. 🌸

It returns true on success and false on error. simple, iconic, done. 👑

🌈 SEE ALSO 🌈

• al_ustr_insert_cstr(3)
• al_ustr_insert_chr(3)
• al_ustr_append(3)
• al_ustr_offset(3)

---

cute sign-off: source/version is the Allegro reference manual; no version or date was printed on the original footer, so I'm not gonna invent one, bestie 💅💜