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.)
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)sjis2004_to_unicode([SJIS_CALLBACK,] STRING)SVf_UTF8,
see perlunicode)
sjis2004_to_utf16le([SJIS_CALLBACK,] STRING)sjis2004_to_utf16be([SJIS_CALLBACK,] STRING)sjis2004_to_utf32le([SJIS_CALLBACK,] STRING)sjis2004_to_utf32be([SJIS_CALLBACK,] STRING)sjis0213_to_utf8([SJIS_CALLBACK,] STRING)sjis0213_to_unicode([SJIS_CALLBACK,] STRING)SVf_UTF8,
see perlunicode)
sjis0213_to_utf16le([SJIS_CALLBACK,] STRING)sjis0213_to_utf16be([SJIS_CALLBACK,] STRING)sjis0213_to_utf32le([SJIS_CALLBACK,] STRING)sjis0213_to_utf32be([SJIS_CALLBACK,] STRING)
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)unicode_to_sjis2004([UNICODE_CALLBACK,] STRING)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)BOM) to Shift_JIS-2004.
utf16le_to_sjis2004([UNICODE_CALLBACK,] STRING)utf16be_to_sjis2004([UNICODE_CALLBACK,] STRING)utf32_to_sjis2004([UNICODE_CALLBACK,] STRING)BOM) to Shift_JIS-2004.
utf32le_to_sjis2004([UNICODE_CALLBACK,] STRING)utf32be_to_sjis2004([UNICODE_CALLBACK,] STRING)utf8_to_sjis0213([UNICODE_CALLBACK,] STRING)unicode_to_sjis0213([UNICODE_CALLBACK,] STRING)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_sjis0213([UNICODE_CALLBACK,] STRING)BOM) to Shift_JISX0213.
utf16le_to_sjis0213([UNICODE_CALLBACK,] STRING)utf16be_to_sjis0213([UNICODE_CALLBACK,] STRING)utf32_to_sjis0213([UNICODE_CALLBACK,] STRING)BOM) to Shift_JISX0213.
utf32le_to_sjis0213([UNICODE_CALLBACK,] STRING)utf32be_to_sjis0213([UNICODE_CALLBACK,] STRING)
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)
On mapping between SJIS-X and Unicode used in this module, notice that:
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.
(CP932-Unicode mapping is different with Shift_JIS-2004-Unicode mapping, but what you desire may be the former.)