---
name: "do_uconvert"
section: "3alleg4"
platform: "linux"
package: "allegro4-doc"
version: "2:4.4.3.1-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/do_uconvert/3alleg4"
---

# do\_uconvert(3alleg4)

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

## 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)