]> git.lizzy.rs Git - linenoise.git/blobdiff - utf8.h
Extend utf-8 support to 4 byte characters
[linenoise.git] / utf8.h
diff --git a/utf8.h b/utf8.h
index 9537939876ae091451500330b488485f740361f7..5aee96b2a296d4be8bf80a638448a87e95d0d438 100644 (file)
--- a/utf8.h
+++ b/utf8.h
@@ -1,9 +1,14 @@
 #ifndef UTF8_UTIL_H
 #define UTF8_UTIL_H
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
 /**
  * UTF-8 utility functions
  *
- * (c) 2010 Steve Bennett <steveb@workware.net.au>
+ * (c) 2010-2016 Steve Bennett <steveb@workware.net.au>
  *
  * See LICENCE for licence details.
  */
 
 #else
 /**
- * Converts the given unicode codepoint (0 - 0xffff) to utf-8
+ * Converts the given unicode codepoint (0 - 0x1fffff) to utf-8
  * and stores the result at 'p'.
- * 
- * Returns the number of utf-8 characters (1-3).
+ *
+ * Returns the number of utf-8 characters
  */
-int utf8_fromunicode(char *p, unsigned short uc);
+int utf8_fromunicode(char *p, unsigned uc);
 
 /**
  * Returns the length of the utf-8 sequence starting with 'c'.
- * 
+ *
  * Returns 1-4, or -1 if this is not a valid start byte.
  *
  * Note that charlen=4 is not supported by the rest of the API.
@@ -36,7 +41,7 @@ int utf8_fromunicode(char *p, unsigned short uc);
 int utf8_charlen(int c);
 
 /**
- * Returns the number of characters in the utf-8 
+ * Returns the number of characters in the utf-8
  * string of the given byte length.
  *
  * Any bytes which are not part of an valid utf-8
@@ -44,13 +49,13 @@ int utf8_charlen(int c);
  *
  * The string *must* be null terminated.
  *
- * Does not support unicode code points > \uffff
+ * Does not support unicode code points > \u1fffff
  */
 int utf8_strlen(const char *str, int bytelen);
 
 /**
  * Returns the byte index of the given character in the utf-8 string.
- * 
+ *
  * The string *must* be null terminated.
  *
  * This will return the byte length of a utf-8 string
@@ -61,7 +66,7 @@ int utf8_index(const char *str, int charindex);
 /**
  * Returns the unicode codepoint corresponding to the
  * utf-8 sequence 'str'.
- * 
+ *
  * Stores the result in *uc and returns the number of bytes
  * consumed.
  *
@@ -70,10 +75,14 @@ int utf8_index(const char *str, int charindex);
  *
  * If it is not null terminated, the length *must* be checked first.
  *
- * Does not support unicode code points > \uffff
+ * Does not support unicode code points > \u1fffff
  */
 int utf8_tounicode(const char *str, int *uc);
 
 #endif
 
+#ifdef __cplusplus
+}
+#endif
+
 #endif