1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27
|
.TH al_ustr_get_next 3 "" "Allegro reference manual"
.SH NAME
.PP
al_ustr_get_next \- Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include\ <allegro5/allegro.h>
int32_t\ al_ustr_get_next(const\ ALLEGRO_USTR\ *us,\ int\ *pos)
\f[]
.fi
.SH DESCRIPTION
.PP
Find the code point in \f[C]us\f[] beginning at byte offset
\f[C]*pos\f[], then advance to the next code point.
.PP
On success return the code point value.
If \f[C]pos\f[] 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
.PP
al_ustr_get(3), al_ustr_prev_get(3)
|