diff options
Diffstat (limited to '')
| -rw-r--r-- | LIBUTF8_RETURN_INVALID.3 | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/LIBUTF8_RETURN_INVALID.3 b/LIBUTF8_RETURN_INVALID.3 new file mode 100644 index 0000000..61d8c0a --- /dev/null +++ b/LIBUTF8_RETURN_INVALID.3 @@ -0,0 +1,31 @@ +.TH LIBUTF8_RETURN_INVALID 3 LIBUTF8 +.SH NAME +LIBUTF8_RETURN_INVALID - Return decoded invalid Unicode codepoints as is + +.SH SYNOPSIS +.nf +#include <libutf8.h> + +#define \fBLIBUTF8_RETURN_INVALID\fP /* implementation omitted */ +.fi + +.SH DESCRIPTION +The +.B LIBUTF8_RETURN_INVALID +macro is a flag for +.BR libutf8_decode (3) +and +.BR libutf8_decode_mem (3). +It causes those functions to accept decoded non-character +codepoints and UTF-16 surrogates and store them unchanged. +.PP +The flag does not make illegal byte sequences, overlong +encodings, or codepoints above +.B LIBUTF8_ULTIMATE_CODEPOINT +valid. + +.SH SEE ALSO +.BR libutf8 (7), +.BR LIBUTF8_REPLACE_INVALID (3), +.BR libutf8_decode (3), +.BR libutf8_decode_mem (3) |