Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
fmt_utf8(3)		    Library Functions Manual		     fmt_utf8(3)

NAME
     fmt_utf8 - encode 31-bit unsigned integer using UTF-8 rules

SYNTAX
     #include <libowfat/fmt.h>

     size_t fmt_utf8(char *dest,uint32_t source);

DESCRIPTION
     fmt_utf8 encodes a 31-bit unsigned integer using the UTF-8 rules.	This can
     take  from  1  byte  (0-0x7f) up to 5 bytes (0x4000000-0x7fffffff).  Values
     larger than 0x7fffffff cannot be represented in this encoding.

     If dest equals FMT_LEN (i.e. is NULL), fmt_utf8 returns the number of bytes
     it would have written.

     For convenience, fmt.h defines the integer FMT_UTF8 to  be  big  enough  to
     contain every possible fmt_utf8 output.

NOTE
     fmt_utf8  and scan_utf8 implement the encoding from UTF-8, but are meant to
     be able to store integers, not just Unicode  code	points.   Values  larger
     than  0x10ffff are not valid UTF-8 (see RFC 3629) but can be represented in
     the encoding, so fmt_utf8 will allow them.

SEE ALSO
     scan_utf8(3)

								     fmt_utf8(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libowfat_fmt_utf8&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help