NAME
ShiftJIS::X0213::MapUTF - conversion between Shift_JIS-2004/Shift_JISX0213 and Unicode
SYNOPSIS
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);DESCRIPTION
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+7E6BConversion from SJIS-X to Unicode
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.)
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.)
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.
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.
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_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) 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.
Conversion from Unicode to SJIS-X
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.)
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_UTF8is not turned on,STRINGis 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. 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.
This Unicode is in the Perl's internal format (see perlunicode). If
SVf_UTF8is not turned on,STRINGis upgraded as an ISO 8859-1 (latin1) string. 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.
Export
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_sjis0213On 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)
BUGS
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]
AUTHOR
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.
SEE ALSO
- JIS X 0213:2000/Amd1:2004
-
7-bit and 8-bit double byte coded extended KANJI sets for information interchange
- Japanese Industrial Standards Committee (JISC)
- Japanese Standards Association (JSA)
- Unihan database (Unicode version: 3.2.0) by Unicode (c)
- JIS KANJI JITEN, the revised edition
-
edited by Shibano, published by Japanese Standards Association, 2002, Tokyo [ISBN4-542-20129-5]
- ShiftJIS::CP932::MapUTF
-
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.)