aboutsummaryrefslogtreecommitdiffstats
path: root/LIBUTF8_ALLOW_31_BITS.3
blob: f86b59b9344afbeb61f1e4cc7f2ee5d8ea22ccd2 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
.TH LIBUTF8_ALLOW_31_BITS 3 LIBUTF8
.SH NAME
LIBUTF8_ALLOW_31_BITS - Accept decoded codepoints up to 31 bits

.SH SYNOPSIS
.nf
#include <libutf8.h>

#define \fBLIBUTF8_ALLOW_31_BITS\fP /* implementation omitted */
.fi

.SH DESCRIPTION
The
.B LIBUTF8_ALLOW_31_BITS
macro is a flag for
.BR libutf8_decode (3)
and
.BR libutf8_decode_mem (3).
It causes those functions to accept codepoints greater than
.B LIBUTF8_ULTIMATE_CODEPOINT
when they fit in an unsigned 31-bit integer.
.PP
Such values are encoded with historical UTF-8 sequences of up to six bytes and
are not Unicode codepoints.

.SH SEE ALSO
.BR libutf8 (7),
.BR LIBUTF8_ULTIMATE_CODEPOINT (3),
.BR libutf8_decode (3),
.BR libutf8_decode_mem (3),
.BR libutf8_encode (3)