]>
git.ipfire.org Git - thirdparty/systemd.git/blob - src/basic/utf8.h
1 /* SPDX-License-Identifier: LGPL-2.1+ */
10 #include "missing_type.h"
12 #define UTF8_REPLACEMENT_CHARACTER "\xef\xbf\xbd"
13 #define UTF8_BYTE_ORDER_MARK "\xef\xbb\xbf"
15 bool unichar_is_valid(char32_t c
);
17 char *utf8_is_valid_n(const char *str
, size_t len_bytes
) _pure_
;
18 static inline char *utf8_is_valid(const char *s
) {
19 return utf8_is_valid_n(s
, (size_t) -1);
21 char *ascii_is_valid(const char *s
) _pure_
;
22 char *ascii_is_valid_n(const char *str
, size_t len
);
24 bool utf8_is_printable_newline(const char* str
, size_t length
, bool allow_newline
) _pure_
;
25 #define utf8_is_printable(str, length) utf8_is_printable_newline(str, length, true)
27 char *utf8_escape_invalid(const char *s
);
28 char *utf8_escape_non_printable_full(const char *str
, size_t console_width
);
29 static inline char *utf8_escape_non_printable(const char *str
) {
30 return utf8_escape_non_printable_full(str
, (size_t) -1);
33 size_t utf8_encode_unichar(char *out_utf8
, char32_t g
);
34 size_t utf16_encode_unichar(char16_t
*out
, char32_t c
);
36 char *utf16_to_utf8(const char16_t
*s
, size_t length
/* bytes! */);
37 char16_t
*utf8_to_utf16(const char *s
, size_t length
);
39 size_t char16_strlen(const char16_t
*s
); /* returns the number of 16bit words in the string (not bytes!) */
41 int utf8_encoded_valid_unichar(const char *str
, size_t length
);
42 int utf8_encoded_to_unichar(const char *str
, char32_t
*ret_unichar
);
44 static inline bool utf16_is_surrogate(char16_t c
) {
45 return c
>= 0xd800U
&& c
<= 0xdfffU
;
48 static inline bool utf16_is_trailing_surrogate(char16_t c
) {
49 return c
>= 0xdc00U
&& c
<= 0xdfffU
;
52 static inline char32_t
utf16_surrogate_pair_to_unichar(char16_t lead
, char16_t trail
) {
53 return ((((char32_t
) lead
- 0xd800U
) << 10) + ((char32_t
) trail
- 0xdc00U
) + 0x10000U
);
56 size_t utf8_n_codepoints(const char *str
);
57 size_t utf8_console_width(const char *str
);