.\" Automatically generated by Pandoc 3.6.1
.\"
.TH "al_ustr_get_next" "3" "" "Allegro reference manual"
.SH NAME
al_ustr_get_next \- Allegro 5 API
.SH SYNOPSIS
.IP
.EX
#include \f[B]<allegro5/allegro.h>\f[R]

int32_t al_ustr_get_next(const ALLEGRO_USTR *us, int *pos)
.EE
.SH DESCRIPTION
Find the code point in \f[CR]us\f[R] beginning at byte offset
\f[CR]*pos\f[R], then advance to the next code point.
.PP
On success return the code point value.
If \f[CR]pos\f[R] was out of bounds (e.g.\ past the end of the string),
return \-1.
On an error, such as an invalid byte sequence, return \-2.
As with al_ustr_next(3), invalid byte sequences may be skipped while
advancing.
.SH SEE ALSO
al_ustr_get(3), al_ustr_prev_get(3)