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

int32_t al_ustr_prev_get(const ALLEGRO_USTR *us, int *pos)
.EE
.SH DESCRIPTION
Find the beginning of a code point before byte offset \f[CR]*pos\f[R],
then return it.
Note this performs a \f[I]pre\-increment\f[R].
.PP
On success returns 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_prev(3), invalid byte sequences may be skipped while
advancing.
.SH SEE ALSO
al_ustr_get_next(3)