al_ustr_insert_chr(3)

💅 al_ustr_insert_chr(3) — the insert-a-code-point girlie 💅

okay so this is al_ustr_insert_chr(3) from the Library Functions Manual, and yes bestie, we’re folding that manual-name energy right in here instead of doing a boring copy-paste header line 🫶✨

---

🌸 NAME 🌸

al_ustr_insert_chr — Allegro 5 API. literally the “put one code point into this string at this byte offset” function, and she’s iconic for it 💖

---

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

size_t al_ustr_insert_chr(ALLEGRO_USTR *us, int pos, int32_t c)

---

🦋 DESCRIPTION 🦋

Soooo here’s the vibe: al_ustr_insert_chr inserts a code point into us, beginning at byte offset pos. and pos cannot be less than 0 — like, that’s the rule, no cap 🚨

If pos is past the end of us, then the space between the end of the string and pos gets padded with NUL ('\0') bytes. yes, NUL bytes, bestie — it’s giving “we’re filling the gap” energy 🌈

Returns the number of bytes inserted, or 0 on error. so if you get 0, that’s the error signal, periodt 💀

---

🎀 SEE ALSO 🎀

• al_ustr_insert(3), al_ustr_insert_cstr(3) — the other insert references, go check ’em out 👀

---

Sign-off 💌: source/version is the Allegro reference manual, and the page didn’t list a date, so there’s no date to report — that’s the footer tea ☕💖