aboutsummaryrefslogtreecommitdiffstats
path: root/LIBUTF8_ALLOW_LONG_ENCODING.3
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--LIBUTF8_ALLOW_LONG_ENCODING.331
1 files changed, 31 insertions, 0 deletions
diff --git a/LIBUTF8_ALLOW_LONG_ENCODING.3 b/LIBUTF8_ALLOW_LONG_ENCODING.3
new file mode 100644
index 0000000..f17e80c
--- /dev/null
+++ b/LIBUTF8_ALLOW_LONG_ENCODING.3
@@ -0,0 +1,31 @@
+.TH LIBUTF8_ALLOW_LONG_ENCODING 3 LIBUTF8
+.SH NAME
+LIBUTF8_ALLOW_LONG_ENCODING - Accept overlong UTF-8 encodings
+
+.SH SYNOPSIS
+.nf
+#include <libutf8.h>
+
+#define \fBLIBUTF8_ALLOW_LONG_ENCODING\fP /* implementation omitted */
+.fi
+
+.SH DESCRIPTION
+The
+.B LIBUTF8_ALLOW_LONG_ENCODING
+macro is a flag for
+.BR libutf8_decode (3)
+and
+.BR libutf8_decode_mem (3).
+It causes those functions to accept overlong UTF-8 encodings
+of up to six bytes, including the two-byte overlong encoding
+of U+0000.
+.PP
+This flag includes the effect of
+.BR LIBUTF8_ALLOW_2BYTE_NULL (3).
+The two flags need not be combined.
+
+.SH SEE ALSO
+.BR libutf8 (7),
+.BR LIBUTF8_ALLOW_2BYTE_NULL (3),
+.BR libutf8_decode (3),
+.BR libutf8_decode_mem (3)