ShiftJIS::X0213::MapUTF - conversion between Shift_JIS-2004/Shift_JISX0213 and Unicode
use ShiftJIS::X0213::MapUTF; # for Shift_JIS-2004 $utf16be_string = sjis2004_to_utf16be($sjis2004_string); $sjis2004_string = utf16be_to_sjis2004($utf16be_string); # for Shift_JISX0213 $utf16be_string = sjis0213_to_utf16be($sjis0213_string); $sjis0213_string = utf16be_to_sjis0213($utf16be_string);
This module provides functions to convert from Shift_JIS-2004 (specified by JIS X 0213:2004) to Unicode, and vice versa.
For backward compatibility, this module also provides functions to convert from Shift_JISX0213 (specified by JIS X 0213:2000) to Unicode, and vice versa.
For convenience, "SJIS-X" is used to refer to both Shift_JIS-2004 and Shift_JISX0213 hereafter.
The following 10 JIS Kanji characters are added in JIS X 0213:2004. These mappings are used only for Shift_JIS-2004, and not for Shift_JISX0213.
sjis2004 unicode 3.2.0 0x879F U+4FF1 0x889E U+525D 0x9873 U+20B9F 0x989E U+541E 0xEAA5 U+5653 0xEFF8 U+59F8 0xEFF9 U+5C5B 0xEFFA U+5E77 0xEFFB U+7626 0xEFFC U+7E6B
If the first parameter is a reference, that is used for coping with SJIS-X characters unmapped to Unicode, SJIS_CALLBACK. (any reference will not allowed as STRING.)
SJIS_CALLBACK
STRING
If SJIS_CALLBACK is given, STRING is the second parameter; otherwise the first.
If SJIS_CALLBACK is not specified, SJIS-X characters unmapped to Unicode are silently deleted and illegal bytes are skipped by one byte. (as if a coderef constantly returning null string, sub {''}, is passed as SJIS_CALLBACK.)
sub {''}
Currently, only coderefs are allowed as SJIS_CALLBACK. A string returned from SJIS_CALLBACK is inserted in place of the unmapped character or the illegal byte.
A coderef as SJIS_CALLBACK is called with one or more arguments.
If illegal byte appears (i.e. a leading byte [0x81..0x9F, 0xE0..0xFC] without trailing byte ([0x40..0x7E, 0x80..0xFC]), or a reserved byte ([0x80, 0xA0, 0xF0..0xFF]), the first argument is undef and the second argument is an unsigned integer representing the byte.
[0x81..0x9F, 0xE0..0xFC]
[0x40..0x7E, 0x80..0xFC]
[0x80, 0xA0, 0xF0..0xFF]
undef
If an unmapped character appears, the first argument is a defined string representing a character.
Example
my $sjis_callback = sub { my ($char, $byte) = @_; return function($char) if defined $char; die sprintf "illegal byte 0x%02x", $byte; };
In the example above, $char may be "\xfc\xfc", etc.
$char
"\xfc\xfc"
The return value of SJIS_CALLBACK must be legal in the target format. E.g. never use with sjis2004_to_utf16be() a callback that returns UTF-8. I.e. you should prepare SJIS_CALLBACK for each UTF.
sjis2004_to_utf16be()
sjis2004_to_utf8([SJIS_CALLBACK,] STRING)
Converts Shift_JIS-2004 to UTF-8
sjis2004_to_unicode([SJIS_CALLBACK,] STRING)
Converts Shift_JIS-2004 to Unicode (Perl's internal format, flagged with SVf_UTF8, see perlunicode)
SVf_UTF8
sjis2004_to_utf16le([SJIS_CALLBACK,] STRING)
Converts Shift_JIS-2004 to UTF-16LE.
sjis2004_to_utf16be([SJIS_CALLBACK,] STRING)
Converts Shift_JIS-2004 to UTF-16BE.
sjis2004_to_utf32le([SJIS_CALLBACK,] STRING)
Converts Shift_JIS-2004 to UTF-32LE.
sjis2004_to_utf32be([SJIS_CALLBACK,] STRING)
Converts Shift_JIS-2004 to UTF-32BE.
sjis0213_to_utf8([SJIS_CALLBACK,] STRING)
Converts Shift_JISX0213 to UTF-8
sjis0213_to_unicode([SJIS_CALLBACK,] STRING)
Converts Shift_JISX0213 to Unicode (Perl's internal format, flagged with SVf_UTF8, see perlunicode)
sjis0213_to_utf16le([SJIS_CALLBACK,] STRING)
Converts Shift_JISX0213 to UTF-16LE.
sjis0213_to_utf16be([SJIS_CALLBACK,] STRING)
Converts Shift_JISX0213 to UTF-16BE.
sjis0213_to_utf32le([SJIS_CALLBACK,] STRING)
Converts Shift_JISX0213 to UTF-32LE.
sjis0213_to_utf32be([SJIS_CALLBACK,] STRING)
Converts Shift_JISX0213 to UTF-32BE.
If the first parameter is a reference, that is used for coping with Unicode characters unmapped to SJIS-X, UNICODE_CALLBACK. (any reference will not allowed as STRING.)
UNICODE_CALLBACK
If UNICODE_CALLBACK is given, STRING is the second parameter; otherwise the first.
If UNICODE_CALLBACK is not specified, SJIS-X characters unmapped to Unicode are silently deleted and partial bytes are skipped by one byte. (as if a coderef constantly returning null string, sub {''} is passed as UNICODE_CALLBACK.)
Currently, only coderefs are allowed as UNICODE_CALLBACK. A string returned from the coderef is inserted in place of the unmapped character.
A coderef as UNICODE_CALLBACK is called with one or more arguments. If the unmapped character is a partial character (an illegal byte), the first argument is undef and the second argument is an unsigned integer representing the byte. If not partial, the first argument is an unsigned interger representing a Unicode code point.
For example, characters unmapped to SJIS-X are converted to numerical character references for HTML 4.01.
sub toHexNCR { my ($char, $byte) = @_; return sprintf("&#x%x;", $char) if defined $char; die sprintf "illegal byte 0x%02x", $byte; } $sjis2004 = utf8_to_sjis2004 (\&toHexNCR, $utf8_string); $sjis2004 = unicode_to_sjis2004(\&toHexNCR, $unicode_string); $sjis2004 = utf16le_to_sjis2004(\&toHexNCR, $utf16le_string);
The return value of UNICODE_CALLBACK must be legal in Shift_JIS-2004.
utf8_to_sjis2004([UNICODE_CALLBACK,] STRING)
Converts UTF-8 to Shift_JIS-2004.
unicode_to_sjis2004([UNICODE_CALLBACK,] STRING)
Converts Unicode to Shift_JIS-2004.
This Unicode is in the Perl's internal format (see perlunicode). If SVf_UTF8 is not turned on, STRING is upgraded as an ISO 8859-1 (latin1) string.
utf16_to_sjis2004([UNICODE_CALLBACK,] STRING)
Converts UTF-16 (with or w/o BOM) to Shift_JIS-2004.
BOM
utf16le_to_sjis2004([UNICODE_CALLBACK,] STRING)
Converts UTF-16LE to Shift_JIS-2004.
utf16be_to_sjis2004([UNICODE_CALLBACK,] STRING)
Converts UTF-16BE to Shift_JIS-2004.
utf32_to_sjis2004([UNICODE_CALLBACK,] STRING)
Converts UTF-32 (with or w/o BOM) to Shift_JIS-2004.
utf32le_to_sjis2004([UNICODE_CALLBACK,] STRING)
Converts UTF-32LE to Shift_JIS-2004.
utf32be_to_sjis2004([UNICODE_CALLBACK,] STRING)
Converts UTF-32BE to Shift_JIS-2004.
utf8_to_sjis0213([UNICODE_CALLBACK,] STRING)
Converts UTF-8 to Shift_JISX0213.
unicode_to_sjis0213([UNICODE_CALLBACK,] STRING)
Converts Unicode to Shift_JISX0213.
utf16_to_sjis0213([UNICODE_CALLBACK,] STRING)
Converts UTF-16 (with or w/o BOM) to Shift_JISX0213.
utf16le_to_sjis0213([UNICODE_CALLBACK,] STRING)
Converts UTF-16LE to Shift_JISX0213.
utf16be_to_sjis0213([UNICODE_CALLBACK,] STRING)
Converts UTF-16BE to Shift_JISX0213.
utf32_to_sjis0213([UNICODE_CALLBACK,] STRING)
Converts UTF-32 (with or w/o BOM) to Shift_JISX0213.
utf32le_to_sjis0213([UNICODE_CALLBACK,] STRING)
Converts UTF-32LE to Shift_JISX0213.
utf32be_to_sjis0213([UNICODE_CALLBACK,] STRING)
Converts UTF-32BE to Shift_JISX0213.
By default:
sjis2004_to_utf8 utf8_to_sjis2004 sjis2004_to_utf16le utf16le_to_sjis2004 sjis2004_to_utf16be utf16be_to_sjis2004 sjis2004_to_unicode unicode_to_sjis2004 sjis0213_to_utf8 utf8_to_sjis0213 sjis0213_to_utf16le utf16le_to_sjis0213 sjis0213_to_utf16be utf16be_to_sjis0213 sjis0213_to_unicode unicode_to_sjis0213
On request:
sjis2004_to_utf32le utf32le_to_sjis2004 sjis2004_to_utf32be utf32be_to_sjis2004 utf16_to_sjis2004 [*] utf32_to_sjis2004 [*] sjis0213_to_utf32le utf32le_to_sjis0213 sjis0213_to_utf32be utf32be_to_sjis0213 utf16_to_sjis0213 [*] utf32_to_sjis0213 [*]
[*] Their counterparts sjis2004_to_utf16(), sjis2004_to_utf32(), sjis0213_to_utf16() and sjis0213_to_utf32() are not implemented yet. They need more investigation on return values from SJIS_CALLBACK... (concatenation needs recognition of and coping with BOM)
sjis2004_to_utf16()
sjis2004_to_utf32()
sjis0213_to_utf16()
sjis0213_to_utf32()
On mapping between SJIS-X and Unicode used in this module, notice that:
0xFC5A in both Shift_JIS-2004 and Shift_JISX0213 is mapped to U+9B1C according to JIS X 0213:2004, although JIS X 0213:2000 mapped it to U+9B1D.
The following 25 JIS Non-Kanji characters are not included in Unicode 3.2.0. So they are mapped to each 2 characters in Unicode. These mappings are done round-trippedly for *one SJIS-X character*. Then round-trippedness for a SJIS-X *string* is broken. (E.g. SJIS-X <0x8663> and <0x857B, 0x867B> both are mapped to <U+00E6, U+0300>; but <U+00E6, U+0300> is mapped only to SJIS-X <0x8663>.)
SJIS-X Unicode 3.2.0 # Name by JIS X 0213:2004 0x82F5 <U+304B, U+309A> # [HIRAGANA LETTER BIDAKUON NGA] 0x82F6 <U+304D, U+309A> # [HIRAGANA LETTER BIDAKUON NGI] 0x82F7 <U+304F, U+309A> # [HIRAGANA LETTER BIDAKUON NGU] 0x82F8 <U+3051, U+309A> # [HIRAGANA LETTER BIDAKUON NGE] 0x82F9 <U+3053, U+309A> # [HIRAGANA LETTER BIDAKUON NGO] 0x8397 <U+30AB, U+309A> # [KATAKANA LETTER BIDAKUON NGA] 0x8398 <U+30AD, U+309A> # [KATAKANA LETTER BIDAKUON NGI] 0x8399 <U+30AF, U+309A> # [KATAKANA LETTER BIDAKUON NGU] 0x839A <U+30B1, U+309A> # [KATAKANA LETTER BIDAKUON NGE] 0x839B <U+30B3, U+309A> # [KATAKANA LETTER BIDAKUON NGO] 0x839C <U+30BB, U+309A> # [KATAKANA LETTER AINU CE] 0x839D <U+30C4, U+309A> # [KATAKANA LETTER AINU TU] 0x839E <U+30C8, U+309A> # [KATAKANA LETTER AINU TO] 0x83F6 <U+31F7, U+309A> # [KATAKANA LETTER AINU P] 0x8663 <U+00E6, U+0300> # [LATIN SMALL LETTER AE WITH GRAVE] 0x8667 <U+0254, U+0300> # [LATIN SMALL LETTER OPEN O WITH GRAVE] 0x8668 <U+0254, U+0301> # [LATIN SMALL LETTER OPEN O WITH ACUTE] 0x8669 <U+028C, U+0300> # [LATIN SMALL LETTER TURNED V WITH GRAVE] 0x866A <U+028C, U+0301> # [LATIN SMALL LETTER TURNED V WITH ACUTE] 0x866B <U+0259, U+0300> # [LATIN SMALL LETTER SCHWA WITH GRAVE] 0x866C <U+0259, U+0301> # [LATIN SMALL LETTER SCHWA WITH ACUTE] 0x866D <U+025A, U+0300> # [LATIN SMALL LETTER HOOKED SCHWA WITH GRAVE] 0x866E <U+025A, U+0301> # [LATIN SMALL LETTER HOOKED SCHWA WITH ACUTE] 0x8685 <U+02E9, U+02E5> # [RISING SYMBOL] 0x8686 <U+02E5, U+02E9> # [FALLING SYMBOL]
SADAHIRO Tomoyuki <SADAHIRO@cpan.org>
Copyright(C) 2002-2007, SADAHIRO Tomoyuki. Japan. All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
7-bit and 8-bit double byte coded extended KANJI sets for information interchange
http://www.jisc.go.jp/
http://www.jsa.or.jp/
http://www.unicode.org/Public/UNIDATA/Unihan.txt
edited by Shibano, published by Japanese Standards Association, 2002, Tokyo [ISBN4-542-20129-5]
conversion between Microsoft Windows CP-932 and Unicode
(CP932-Unicode mapping is different with Shift_JIS-2004-Unicode mapping, but what you desire may be the former.)
To install ShiftJIS::X0213::MapUTF, copy and paste the appropriate command in to your terminal.
cpanm
cpanm ShiftJIS::X0213::MapUTF
CPAN shell
perl -MCPAN -e shell install ShiftJIS::X0213::MapUTF
For more information on module installation, please visit the detailed CPAN module installation guide.