---
name: "ugetx"
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/ugetx"
---

# ugetx(3alleg)

Low level helper function for reading Unicode text data. Allegro game programming library.

## NAME

ugetx, ugetxc - Low level helper function for reading Unicode text data. Allegro game programming library.

## SYNOPSIS

**#include \<allegro.h\>**

**int ugetx(char \*\*s);**

**int ugetxc(const char \*\*s);**

## DESCRIPTION

Low level helper function for reading Unicode text data. ugetxc is provided for working with pointer-to-pointer-to-const char data. Example:

```
   char *p = string;
   int first_letter, second_letter, third_letter;
   first_letter = ugetx(&p);
   second_letter = ugetx(&p);
   third_letter = ugetx(&p);
```

## RETURN VALUE

Returns the character pointed to by \`s' in the current encoding format, and advances the pointer to the next character after the one just returned.

## SEE ALSO

[**ugetc**(3alleg)](/ugetc/3alleg.md), [**usetc**(3alleg)](/usetc/3alleg.md), [**uwidth**(3alleg)](/uwidth/3alleg.md), [**ucwidth**(3alleg)](/ucwidth/3alleg.md), [**uisok**(3alleg)](/uisok/3alleg.md)