2 * This file and its contents are supplied under the terms of the
3 * Common Development and Distribution License ("CDDL"), version 1.0.
4 * You may only use this file in accordance with the terms of version
7 * A full copy of the text of the CDDL should have accompanied this
8 * source. A copy of the CDDL is also available via the Internet at
9 * http://www.illumos.org/license/CDDL.
13 * Copyright 2011 Nexenta Systems, Inc. All rights reserved.
14 * Copyright 2012 Garrett D'Amore <garrett@damore.org> All rights reserved.
18 * The functions in this file convert from the standard multibyte forms
19 * to the wide character forms used internally by libc. Unfortunately,
20 * this approach means that we need a method for each and every encoding.
27 #include <sys/types.h>
28 #include "localedef.h"
30 static int towide_none(wchar_t *, const char *, unsigned);
31 static int towide_utf8(wchar_t *, const char *, unsigned);
32 static int towide_big5(wchar_t *, const char *, unsigned);
33 static int towide_gbk(wchar_t *, const char *, unsigned);
34 static int towide_gb2312(wchar_t *, const char *, unsigned);
35 static int towide_gb18030(wchar_t *, const char *, unsigned);
36 static int towide_mskanji(wchar_t *, const char *, unsigned);
37 static int towide_euccn(wchar_t *, const char *, unsigned);
38 static int towide_eucjp(wchar_t *, const char *, unsigned);
39 static int towide_euckr(wchar_t *, const char *, unsigned);
40 static int towide_euctw(wchar_t *, const char *, unsigned);
42 static int tomb_none(char *, wchar_t);
43 static int tomb_utf8(char *, wchar_t);
44 static int tomb_mbs(char *, wchar_t);
46 static int (*_towide
)(wchar_t *, const char *, unsigned) = towide_none
;
47 static int (*_tomb
)(char *, wchar_t) = tomb_none
;
48 static char _encoding_buffer
[20] = "NONE";
49 static const char *_encoding
= _encoding_buffer
;
50 static int _nbits
= 7;
53 * Table of supported encodings. We only bother to list the multibyte
54 * encodings here, because single byte locales are handed by "NONE".
58 /* the name that the underlying libc implemenation uses */
60 /* the maximum number of bits required for priorities */
62 int (*towide
)(wchar_t *, const char *, unsigned);
63 int (*tomb
)(char *, wchar_t);
66 * UTF8 values max out at 0x1fffff (although in theory there could
67 * be later extensions, but it won't happen.) This means we only need
68 * 21 bits to be able to encode the entire range of priorities.
70 { "UTF-8", "UTF-8", 21, towide_utf8
, tomb_utf8
},
71 { "UTF8", "UTF-8", 21, towide_utf8
, tomb_utf8
},
72 { "utf8", "UTF-8", 21, towide_utf8
, tomb_utf8
},
73 { "utf-8", "UTF-8", 21, towide_utf8
, tomb_utf8
},
75 { "EUC-CN", "EUC-CN", 16, towide_euccn
, tomb_mbs
},
76 { "eucCN", "EUC-CN", 16, towide_euccn
, tomb_mbs
},
78 * Becuase the 3-byte form of EUC-JP use the same leading byte,
79 * only 17 bits required to provide unique priorities. (The low
80 * bit of that first byte is set.) By setting this value low,
81 * we can get by with only 3 bytes in the strxfrm expansion.
83 { "EUC-JP", "EUC-JP", 17, towide_eucjp
, tomb_mbs
},
84 { "eucJP", "EUC-JP", 17, towide_eucjp
, tomb_mbs
},
86 { "EUC-KR", "EUC-KR", 16, towide_euckr
, tomb_mbs
},
87 { "eucKR", "EUC-KR", 16, towide_euckr
, tomb_mbs
},
89 * EUC-TW uses 2 bytes most of the time, but 4 bytes if the
90 * high order byte is 0x8E. However, with 4 byte encodings,
91 * the third byte will be A0-B0. So we only need to consider
92 * the lower order 24 bits for collation.
94 { "EUC-TW", "EUC-TW", 24, towide_euctw
, tomb_mbs
},
95 { "eucTW", "EUC-TW", 24, towide_euctw
, tomb_mbs
},
97 { "MS_Kanji", "MSKanji", 16, towide_mskanji
, tomb_mbs
},
98 { "MSKanji", "MSKanji", 16, towide_mskanji
, tomb_mbs
},
99 { "PCK", "MSKanji", 16, towide_mskanji
, tomb_mbs
},
100 { "SJIS", "MSKanji", 16, towide_mskanji
, tomb_mbs
},
101 { "Shift_JIS", "MSKanji", 16, towide_mskanji
, tomb_mbs
},
103 { "BIG5", "BIG5", 16, towide_big5
, tomb_mbs
},
104 { "big5", "BIG5", 16, towide_big5
, tomb_mbs
},
105 { "Big5", "BIG5", 16, towide_big5
, tomb_mbs
},
107 { "GBK", "GBK", 16, towide_gbk
, tomb_mbs
},
110 * GB18030 can get away with just 31 bits. This is because the
111 * high order bit is always set for 4 byte values, and the
112 * at least one of the other bits in that 4 byte value will
115 { "GB18030", "GB18030", 31, towide_gb18030
, tomb_mbs
},
118 * This should probably be an aliase for euc-cn, or vice versa.
120 { "GB2312", "GB2312", 16, towide_gb2312
, tomb_mbs
},
126 show_mb(const char *mb
)
130 /* ASCII stuff we just print */
131 if (isascii(*mb
) && isgraph(*mb
)) {
139 (void) snprintf(scr
, sizeof (scr
), "\\x%02x", *mb
);
140 (void) strlcat(buf
, scr
, sizeof (buf
));
146 static char *widemsg
;
149 werr(const char *fmt
, ...)
155 (void) vasprintf(&msg
, fmt
, va
);
163 * This is used for 8-bit encodings.
166 towide_none(wchar_t *c
, const char *mb
, unsigned n
)
170 if (mb_cur_max
!= 1) {
171 werr("invalid or unsupported multibyte locale");
179 tomb_none(char *mb
, wchar_t wc
)
181 if (mb_cur_max
!= 1) {
182 werr("invalid or unsupported multibyte locale");
185 *(uint8_t *)mb
= (wc
& 0xff);
191 * UTF-8 stores wide characters in UTF-32 form.
194 towide_utf8(wchar_t *wc
, const char *mb
, unsigned n
)
198 int lv
; /* lowest legal value */
200 const uint8_t *s
= (const uint8_t *)mb
;
204 if ((c
& 0x80) == 0) {
208 } else if ((c
& 0xe0) == 0xc0) {
209 /* u80-u7ff - two bytes encoded */
213 } else if ((c
& 0xf0) == 0xe0) {
214 /* u800-uffff - three bytes encoded */
218 } else if ((c
& 0xf8) == 0xf0) {
219 /* u1000-u1fffff - four bytes encoded */
224 /* 5 and 6 byte encodings are not legal unicode */
225 werr("utf8 encoding too large (%s)", show_mb(mb
));
229 werr("incomplete utf8 sequence (%s)", show_mb(mb
));
233 for (i
= 1; i
< nb
; i
++) {
234 if (((s
[i
]) & 0xc0) != 0x80) {
235 werr("illegal utf8 byte (%x)", s
[i
]);
243 werr("illegal redundant utf8 encoding (%s)", show_mb(mb
));
251 tomb_utf8(char *mb
, wchar_t wc
)
253 uint8_t *s
= (uint8_t *)mb
;
266 } else if (wc
<= 0xffff) {
269 } else if (wc
<= 0x1fffff) {
273 werr("illegal uf8 char (%x)", wc
);
276 for (i
= cnt
- 1; i
; i
--) {
277 s
[i
] = (wc
& 0x3f) | 0x80;
286 * Several encodings share a simplistic dual byte encoding. In these
287 * forms, they all indicate that a two byte sequence is to be used if
288 * the first byte has its high bit set. They all store this simple
289 * encoding as a 16-bit value, although a great many of the possible
290 * code points are not used in most character sets. This gives a possible
291 * set of just over 32,000 valid code points.
293 * 0x00 - 0x7f - 1 byte encoding
294 * 0x80 - 0x7fff - illegal
295 * 0x8000 - 0xffff - 2 byte encoding
298 towide_dbcs(wchar_t *wc
, const char *mb
, unsigned n
)
304 if ((c
& 0x80) == 0) {
310 werr("incomplete character sequence (%s)", show_mb(mb
));
314 /* Store both bytes as a single 16-bit wide. */
316 c
|= (uint8_t)(mb
[1]);
322 * Most multibyte locales just convert the wide character to the multibyte
323 * form by stripping leading null bytes, and writing the 32-bit quantity
324 * in big-endian order.
327 tomb_mbs(char *mb
, wchar_t wc
)
329 uint8_t *s
= (uint8_t *)mb
;
332 if ((wc
& 0xff000000U
) != 0) {
334 } else if ((wc
& 0x00ff0000U
) != 0) {
336 } else if ((wc
& 0x0000ff00U
) != 0) {
347 /* ensure null termination */
354 * big5 is a simple dual byte character set.
357 towide_big5(wchar_t *wc
, const char *mb
, unsigned n
)
359 return (towide_dbcs(wc
, mb
, n
));
363 * GBK encodes wides in the same way that big5 does, the high order
364 * bit of the first byte indicates a double byte character.
367 towide_gbk(wchar_t *wc
, const char *mb
, unsigned n
)
369 return (towide_dbcs(wc
, mb
, n
));
373 * GB2312 is another DBCS. Its cleaner than others in that the second
374 * byte does not encode ASCII, but it supports characters.
377 towide_gb2312(wchar_t *wc
, const char *mb
, unsigned n
)
379 return (towide_dbcs(wc
, mb
, n
));
383 * GB18030. This encodes as 8, 16, or 32-bits.
384 * 7-bit values are in 1 byte, 4 byte sequences are used when
385 * the second byte encodes 0x30-39 and all other sequences are 2 bytes.
388 towide_gb18030(wchar_t *wc
, const char *mb
, unsigned n
)
394 if ((c
& 0x80) == 0) {
400 werr("incomplete character sequence (%s)", show_mb(mb
));
404 /* pull in the second byte */
406 c
|= (uint8_t)(mb
[1]);
408 if (((c
& 0xff) >= 0x30) && ((c
& 0xff) <= 0x39)) {
410 werr("incomplete 4-byte character sequence (%s)",
415 c
|= (uint8_t)(mb
[2]);
417 c
|= (uint8_t)(mb
[3]);
427 * MS-Kanji (aka SJIS) is almost a clean DBCS like the others, but it
428 * also has a range of single byte characters above 0x80. (0xa1-0xdf).
431 towide_mskanji(wchar_t *wc
, const char *mb
, unsigned n
)
437 if ((c
< 0x80) || ((c
> 0xa0) && (c
< 0xe0))) {
444 werr("incomplete character sequence (%s)", show_mb(mb
));
448 /* Store both bytes as a single 16-bit wide. */
450 c
|= (uint8_t)(mb
[1]);
456 * EUC forms. EUC encodings are "variable". FreeBSD carries some additional
457 * variable data to encode these, but we're going to treat each as independent
458 * instead. Its the only way we can sensibly move forward.
460 * Note that the way in which the different EUC forms vary is how wide
461 * CS2 and CS3 are and what the first byte of them is.
464 towide_euc_impl(wchar_t *wc
, const char *mb
, unsigned n
,
465 uint8_t cs2
, uint8_t cs2width
, uint8_t cs3
, uint8_t cs3width
)
474 * All variations of EUC encode 7-bit ASCII as one byte, and use
475 * additional bytes for more than that.
477 if ((c
& 0x80) == 0) {
484 * All EUC variants reserve 0xa1-0xff to identify CS1, which
485 * is always two bytes wide. Note that unused CS will be zero,
486 * and that cannot be true because we know that the high order
491 } else if (c
== cs2
) {
493 } else if (c
== cs3
) {
498 werr("incomplete character sequence (%s)", show_mb(mb
));
502 for (i
= 1; i
< width
; i
++) {
503 /* pull in the next byte */
505 c
|= (uint8_t)(mb
[i
]);
513 * EUC-CN encodes as follows:
515 * Code set 0 (ASCII): 0x21-0x7E
516 * Code set 1 (CNS 11643-1992 Plane 1): 0xA1A1-0xFEFE
521 towide_euccn(wchar_t *wc
, const char *mb
, unsigned n
)
523 return (towide_euc_impl(wc
, mb
, n
, 0x8e, 4, 0, 0));
527 * EUC-JP encodes as follows:
529 * Code set 0 (ASCII or JIS X 0201-1976 Roman): 0x21-0x7E
530 * Code set 1 (JIS X 0208): 0xA1A1-0xFEFE
531 * Code set 2 (half-width katakana): 0x8EA1-0x8EDF
532 * Code set 3 (JIS X 0212-1990): 0x8FA1A1-0x8FFEFE
535 towide_eucjp(wchar_t *wc
, const char *mb
, unsigned n
)
537 return (towide_euc_impl(wc
, mb
, n
, 0x8e, 2, 0x8f, 3));
541 * EUC-KR encodes as follows:
543 * Code set 0 (ASCII or KS C 5636-1993): 0x21-0x7E
544 * Code set 1 (KS C 5601-1992): 0xA1A1-0xFEFE
549 towide_euckr(wchar_t *wc
, const char *mb
, unsigned n
)
551 return (towide_euc_impl(wc
, mb
, n
, 0, 0, 0, 0));
555 * EUC-TW encodes as follows:
557 * Code set 0 (ASCII): 0x21-0x7E
558 * Code set 1 (CNS 11643-1992 Plane 1): 0xA1A1-0xFEFE
559 * Code set 2 (CNS 11643-1992 Planes 1-16): 0x8EA1A1A1-0x8EB0FEFE
563 towide_euctw(wchar_t *wc
, const char *mb
, unsigned n
)
565 return (towide_euc_impl(wc
, mb
, n
, 0x8e, 4, 0, 0));
569 * Public entry points.
573 to_wide(wchar_t *wc
, const char *mb
)
575 /* this won't fail hard */
576 return (_towide(wc
, mb
, strlen(mb
)));
580 to_mb(char *mb
, wchar_t wc
)
584 if ((rv
= _tomb(mb
, wc
)) < 0) {
593 to_mb_string(const wchar_t *wcs
)
599 mbs
= malloc((wcslen(wcs
) * mb_cur_max
) + 1);
601 errf("out of memory");
606 if ((len
= to_mb(ptr
, *wcs
)) < 0) {
619 set_wide_encoding(const char *encoding
)
623 _towide
= towide_none
;
627 (void) snprintf(_encoding_buffer
, sizeof (_encoding_buffer
), "NONE:%s",
629 for (i
= 0; mb_encodings
[i
].name
; i
++) {
630 if (strcasecmp(encoding
, mb_encodings
[i
].name
) == 0) {
631 _towide
= mb_encodings
[i
].towide
;
632 _tomb
= mb_encodings
[i
].tomb
;
633 _encoding
= mb_encodings
[i
].cname
;
634 _nbits
= mb_encodings
[i
].nbits
;
641 get_wide_encoding(void)
649 return ((int)((1U << _nbits
) - 1));