plucky (3) do_uconvert.3alleg4.gz

NAME

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

SYNOPSIS

       #include <allegro.h>

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

DESCRIPTION

       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.

SEE ALSO

       uconvert(3alleg4)