1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright (c) 2014 SGI. 4 * All rights reserved. 5 */ 6 7 #ifndef UTF8NORM_H 8 #define UTF8NORM_H 9 10 #include <linux/types.h> 11 #include <linux/export.h> 12 #include <linux/string.h> 13 #include <linux/module.h> 14 #include <linux/unicode.h> 15 16 int utf8version_is_supported(const struct unicode_map *um, unsigned int version); 17 18 /* 19 * Determine the length of the normalized from of the string, 20 * excluding any terminating NULL byte. 21 * Returns 0 if only ignorable code points are present. 22 * Returns -1 if the input is not valid UTF-8. 23 */ 24 ssize_t utf8nlen(const struct unicode_map *um, enum utf8_normalization n, 25 const char *s, size_t len); 26 27 /* Needed in struct utf8cursor below. */ 28 #define UTF8HANGULLEAF (12) 29 30 /* 31 * Cursor structure used by the normalizer. 32 */ 33 struct utf8cursor { 34 const struct unicode_map *um; 35 enum utf8_normalization n; 36 const char *s; 37 const char *p; 38 const char *ss; 39 const char *sp; 40 unsigned int len; 41 unsigned int slen; 42 short int ccc; 43 short int nccc; 44 unsigned char hangul[UTF8HANGULLEAF]; 45 }; 46 47 /* 48 * Initialize a utf8cursor to normalize a string. 49 * Returns 0 on success. 50 * Returns -1 on failure. 51 */ 52 int utf8ncursor(struct utf8cursor *u8c, const struct unicode_map *um, 53 enum utf8_normalization n, const char *s, size_t len); 54 55 /* 56 * Get the next byte in the normalization. 57 * Returns a value > 0 && < 256 on success. 58 * Returns 0 when the end of the normalization is reached. 59 * Returns -1 if the string being normalized is not valid UTF-8. 60 */ 61 extern int utf8byte(struct utf8cursor *u8c); 62 63 struct utf8data { 64 unsigned int maxage; 65 unsigned int offset; 66 }; 67 68 struct utf8data_table { 69 const unsigned int *utf8agetab; 70 int utf8agetab_size; 71 72 const struct utf8data *utf8nfdicfdata; 73 int utf8nfdicfdata_size; 74 75 const struct utf8data *utf8nfdidata; 76 int utf8nfdidata_size; 77 78 const unsigned char *utf8data; 79 }; 80 81 extern const struct utf8data_table utf8_data_table; 82 83 #endif /* UTF8NORM_H */ 84