UCHAR.H(3HEAD) Headers UCHAR.H(3HEAD)

NAME

uchar.h - unicode utilities header

SYNOPSIS

#include <uchar.h>

DESCRIPTION

The <uchar.h> header provides support for the C11 Unicode utilities.
The types and functions provide means for working with data encoded as
UTF-16 and UTF-32. When working in non-Unicode locales, these types
may not represent Unicode code points.

The <uchar.h> header defines the following types:

char16_t An unsigned integer that can represent 16-bit characters,
generally a single single UTF-16 code unit. A Unicode
code point may be one or two UTF-16 code units due to
surrogate pairs.

char32_t An unsigned integer that can represent 32-bit characters,
generally a single UTF-32 code unit.

size_t An unsigned integer that represents the size of various
objects. This can hold the result of the sizeof
operator. See also stddef.h(3HEAD).

mbstate_t An object that holds the state for converting between
character sequences and wide characters (wchar_t,
char16_t, char32_t). See also, wchar.h(3HEAD).
The <uchar.h> header also defines the following functions which are
used to convert between char16_t and char32_t sequences and other
character sequences:

c16rtomb(3C)
Convert char16_t sequences to multi-byte character
sequences.

c32rtomb(3C)
Convert char32_t sequences to multi-byte character
sequences.

mbrtoc16(3C)
Convert multi-byte character sequences to char16_t
sequences.

mbrtoc32(3C)
Convert multi-byte character sequences to char32_t
sequences.

INTERFACE STABILITY

Committed

SEE ALSO

c16rtomb(3C), c32rtomb(3C), mbrtoc16(3C), mbrtoc32(3C),
stddef.h(3HEAD), wchar.h(3HEAD)

illumos April 22, 2020 illumos