uinsert(3alleg4)

💖 uinsert — bestie edition 💖

okay so real talk, this is uinsert from the Allegro manual, section 3alleg4, and it's a function from the Allegro game programming library. she's a little string-surgery icon and honestly? she eats. 🦋

✨ NAME ✨

uinsert — inserts a character in a string. Allegro game programming library. no cap, that's the whole job description. 💅

🌸 SYNOPSIS 🌸

#include <allegro.h>

int uinsert(char *s, int index, int c);

three args, one int coming back at you. slay. 🎀

👑 DESCRIPTION 👑

so here's the vibe: uinsert takes your character c and slides her into the string s at the specified index. and because she's polite, she shoves the rest of the data along to make room. like scooting over on the couch so everyone fits. 💖

and if index is negative? not a problem, she counts backward from the end of the string. negative index energy, we love to see it. 🙈

example time, bestie:

uinsert(text_string, 0, prefix_letter);

that's her putting prefix_letter at the very front, index zero, main character position. ✨

🔥 RETURN VALUE 🔥

she hands you back the number of bytes by which the trailing part of the string was moved. so like, how far everything had to scooch. useful for knowing how much got shuffled. 💀

🫶 SEE ALSO 🫶

• uoffset(3alleg4)
• ugetat(3alleg4)
• usetat(3alleg4)
• uremove(3alleg4)

the whole string-girlie friend group. go say hi. 🌈

okay that's the whole page, mwah 💋 this was Allegro version 4.4.3, uinsert(3alleg4), and yes she's iconic, periodt. 🎀💖✨