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

size_t al_utf8_encode(char s[], int32_t c)
.EE
.SH DESCRIPTION
Encode the specified code point to UTF\-8 into the buffer \f[CR]s\f[R].
The buffer must have enough space to hold the encoding, which takes
between 1 and 4 bytes.
This routine will refuse to encode code points above 0x10FFFF.
.PP
Returns the number of bytes written, which is the same as that returned
by al_utf8_width(3).
.SH SEE ALSO
al_utf16_encode(3)