DragonFly On-Line Manual Pages
scan_utf8(3) DragonFly Library Functions Manual scan_utf8(3)
NAME
scan_utf8 - decode an unsigned integer from UTF-8 encoding
SYNTAX
#include <scan.h>
size_t scan_utf8(const char *src,size_t len,uint32_t *dest);
DESCRIPTION
scan_utf8 decodes an unsigned integer in UTF-8 encoding from a memory
area holding binary data. It writes the decode value in dest and
returns the number of bytes it read from src.
scan_utf8 never reads more than len bytes from src. If the sequence is
longer than that, or the memory area contains an invalid sequence,
scan_utf8 returns 0 and does not touch dest.
The length of the longest UTF-8 sequence is 5. If the buffer is longer
than that, and scan_utf8 fails, then the data was not a valid UTF-8
encoded sequence.
SEE ALSO
fmt_utf8(3)
scan_utf8(3)