---
name: "do_uconvert"
section: "3alleg"
platform: "linux"
package: "liballegro-doc"
version: "2:4.2.2-2.2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/do_uconvert"
---

# do\_uconvert(3alleg)

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**(3alleg)](/uconvert/3alleg.md)