1 #ifndef _WIMLIB_ENCODING_H
2 #define _WIMLIB_ENCODING_H
4 #include "wimlib/error.h"
5 #include "wimlib/util.h"
6 #include "wimlib/types.h"
11 iconv_global_init(void);
14 iconv_global_cleanup(void);
19 extern bool wimlib_mbs_is_utf8;
21 #define DECLARE_CHAR_CONVERSION_FUNCTIONS(varname1, varname2, \
22 chartype1, chartype2) \
25 varname1##_to_##varname2(const chartype1 *in, size_t in_nbytes, \
26 chartype2 **out_ret, \
27 size_t *out_nbytes_ret); \
30 varname1##_to_##varname2##_nbytes(const chartype1 *in, size_t in_nbytes,\
31 size_t *out_nbytes_ret); \
34 varname1##_to_##varname2##_buf(const chartype1 *in, size_t in_nbytes, \
38 utf16le_dupz(const void *ustr, size_t usize);
41 DECLARE_CHAR_CONVERSION_FUNCTIONS(utf16le, tstr, utf16lechar, tchar);
42 DECLARE_CHAR_CONVERSION_FUNCTIONS(tstr, utf16le, tchar, utf16lechar);
46 tstr_to_utf16le(const tchar *tstr, size_t tsize,
47 utf16lechar **ustr_ret, size_t *usize_ret)
49 utf16lechar *ustr = utf16le_dupz(tstr, tsize);
51 return WIMLIB_ERR_NOMEM;
57 #define utf16le_to_tstr tstr_to_utf16le
61 DECLARE_CHAR_CONVERSION_FUNCTIONS(utf8, tstr, char, tchar);
62 DECLARE_CHAR_CONVERSION_FUNCTIONS(tstr, utf8, tchar, char);
65 utf8_to_tstr_simple(const char *utf8str, tchar **out);
68 tstr_to_utf8_simple(const tchar *tstr, char **out);
71 cmp_utf16le_strings(const utf16lechar *s1, size_t n1,
72 const utf16lechar *s2, size_t n2,
75 /* Convert a string in the platform-dependent encoding to UTF-16LE, but if both
76 * encodings are UTF-16LE, simply re-use the string. Release with
77 * tstr_put_utf16le() when done. */
79 tstr_get_utf16le_and_len(const tchar *tstr,
80 const utf16lechar **ustr_ret, size_t *usize_ret)
82 size_t tsize = tstrlen(tstr) * sizeof(tchar);
84 /* No conversion or copy needed */
89 return tstr_to_utf16le(tstr, tsize, (utf16lechar **)ustr_ret, usize_ret);
93 /* Convert a string in the platform-dependent encoding to UTF-16LE, but if both
94 * encodings are UTF-16LE, simply re-use the string. Release with
95 * tstr_put_utf16le() when done. */
97 tstr_get_utf16le(const tchar *tstr, const utf16lechar **ustr_ret)
100 /* No conversion or copy needed */
104 size_t tsize = tstrlen(tstr) * sizeof(tchar);
106 return tstr_to_utf16le(tstr, tsize, (utf16lechar **)ustr_ret, &dummy);
110 /* Release a string acquired with tstr_get_utf16le() or
111 * tstr_get_utf16le_and_len(). */
113 tstr_put_utf16le(const utf16lechar *ustr)
115 #if !TCHAR_IS_UTF16LE
120 /* Convert a UTF16-LE string to the platform-dependent encoding, but if both
121 * encodings are UTF-16LE, simply re-use the string. Release with
122 * utf16le_put_tstr() when done. */
124 utf16le_get_tstr(const utf16lechar *ustr, size_t usize,
125 const tchar **tstr_ret, size_t *tsize_ret)
128 /* No conversion or copy needed */
133 return utf16le_to_tstr(ustr, usize, (tchar **)tstr_ret, tsize_ret);
137 /* Release a string acquired with utf16le_get_tstr(). */
139 utf16le_put_tstr(const tchar *tstr)
141 #if !TCHAR_IS_UTF16LE
146 #endif /* _WIMLIB_ENCODING_H */