uconvert_size(3alleg4)

✨ NAME ✨

okay bestie, welcome to the uconvert_size(3alleg4) page from the Allegro manual 💖

uconvert_size — Number of bytes needed to store a string after conversion. Part of the Allegro game programming library. No cap, that's literally what she does. 🎀

🦋 SYNOPSIS 🦋

you pull her in like this, periodt:

#include <allegro.h>

int uconvert_size(const char *s, int type, int newtype);

💖 DESCRIPTION 💖

Okay so picture this: you have the specified string s, and you need to find out how many bytes are required to store it after a conversion from type to newtype. That's the vibe. She counts the mandatory zero terminator of the string too — yes, the null terminator is included, she's not being skipped, bestie. 😌

You can use U_CURRENT for either type or newtype as a shortcut to represent whatever text encoding format is currently selected. It's giving "I don't have the exact encoding name rn, just use the current one." 💅

Example, because seeing it is believing:

length = uconvert_size(old_string, U_CURRENT, U_UNICODE);
new_string = malloc(length);
ustrcpy(new_string, old_string);

🌈 RETURN VALUE 🌈

Returns the number of bytes required to store the string after conversion. That's the whole return value, and she ate. 💅✨

👑 SEE ALSO 👑

• need_uconvert(3alleg4) — bestie, this one is right there waiting for you 🫶
• do_uconvert(3alleg4) — and this one too, go read, iykyk 💜

mwah 💋 signing off from Allegro, version 4.4.3. stay iconic, bestie 🦋✨