.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "al_ustr_set_chr" "3alleg5" "" "Allegro reference manual" ""
.hy
.SH NAME
.PP
al_ustr_set_chr - Allegro 5 API
.SH SYNOPSIS
.IP
.nf
\f[C]
#include <allegro5/allegro.h>

size_t al_ustr_set_chr(ALLEGRO_USTR *us, int start_pos, int32_t c)
\f[R]
.fi
.SH DESCRIPTION
.PP
Replace the code point beginning at byte offset \f[V]start_pos\f[R] with
\f[V]c\f[R].
\f[V]start_pos\f[R] cannot be less than 0.
If \f[V]start_pos\f[R] is past the end of \f[V]us\f[R] then the space
between the end of the string and \f[V]start_pos\f[R] will be padded
with NUL (\f[V]\[aq]\[rs]0\[aq]\f[R]) bytes.
If \f[V]start_pos\f[R] is not the start of a valid code point, that is
an error and the string will be unmodified.
.PP
On success, returns the number of bytes written, i.e.\ the offset to the
following code point.
On error, returns 0.
.SH SEE ALSO
.PP
al_ustr_replace_range(3alleg5)