al_ustr_set_chr(3)

✨ NAME ✨

al_ustr_set_chr — Allegro 5 API, coming at you from the Library Functions Manual 💅

🎀 SYNOPSIS 🎀

#include <allegro5/allegro.h>

size_t al_ustr_set_chr(ALLEGRO_USTR *us, int start_pos, int32_t c)

🦋 DESCRIPTION 🦋

okay so bestie, here's the vibe: this function replaces the code point beginning at byte offset start_pos with c. 💖

start_pos cannot be less than 0 — hard no, no cap.

If start_pos is past the end of us, then the space between the end of the string and start_pos gets padded with NUL ('\0') bytes. ✨

If start_pos is not the start of a valid code point, that's an error — and the string will be unmodified. The function does not mess with it, periodt. 💀

On success, it returns the number of bytes written, i.e. the offset to the following code point. On error, it returns 0.

🌈 SEE ALSO 🌈

• al_ustr_replace_range(3)

---

xoxo, source/version: Allegro reference manual 💖 — <al_ustr_set_chr>(3)>; date: not listed in the footer, so we're not inventing one, bestie 😭✨