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 rep-
       resented	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+14.3.quarterly>

home | help