DOKK / manpages / debian 10 / allegro4-doc / do_uconvert.3alleg4.en
do_uconvert(3alleg4) Allegro manual do_uconvert(3alleg4)

do_uconvert - Converts a string to another encoding format. Allegro game programming library.

#include <allegro.h>

void do_uconvert(const char *s, int type, char *buf, int newtype, int size);

Converts the specified string `s' from `type' to `newtype', storing at most `size' bytes into the output `buf'. The type parameters can use the value U_CURRENT as a shortcut to represent the currently selected encoding format. Example:


char temp_string[256];
do_uconvert(input_string, U_CURRENT, temp_string, U_ASCII, 256);
Note that, even for empty strings, your destination string must have at least enough bytes to store the terminating null character of the string, and your parameter `size' must reflect this. Otherwise, the debug version of Allegro will abort at an assertion, and the release version of Allegro will overrun the destination buffer.

uconvert(3alleg4)

version 4.4.2 Allegro