/ 
ShiftJIS-X0213-MapUTF-0.12
River stage zero No dependents
/ ShiftJIS::X0213::MapUTF

NAME

ShiftJIS::X0213::MapUTF - conversion between Shift_JISX0213 and Unicode

SYNOPSIS

use ShiftJIS::X0213::MapUTF;

$utf16be_string  = sjis0213_to_utf16be($sjis0213_string);
$sjis0213_string = utf16be_to_sjis0213($utf16be_string);

DESCRIPTION

This module provides some functions to map from Shift_JISX0213 to Unicode, and vice versa.

Conversion from Shift_JISX0213 to Unicode

If the first parameter is a reference, that is used for coping with Shift_JISX0213 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, Shift_JISX0213 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 sjis0213_to_utf16be() a callback that returns UTF-8. I.e. you should prepare SJIS_CALLBACK for each UTF.

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 Shift_JISX0213

If the first parameter is a reference, that is used for coping with Unicode characters unmapped to Shift_JISX0213, 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, Shift_JIS 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 Shift_JISX0213 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;
}

$sjis0213 = utf8_to_sjis0213   (\&toHexNCR, $utf8_string);
$sjis0213 = unicode_to_sjis0213(\&toHexNCR, $unicode_string);
$sjis0213 = utf16le_to_sjis0213(\&toHexNCR, $utf16le_string);

The return value of UNICODE_CALLBACK must be legal in Shift_JISX0213.

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_UTF8 is not turned on, STRING is 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:

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:

sjis0213_to_utf32le  utf32le_to_sjis0213
sjis0213_to_utf32be  utf32be_to_sjis0213
                     utf16_to_sjis0213 [*]
                     utf32_to_sjis0213 [*]

[*] Their counterparts 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 Shift_JISX0213 and Unicode used in this module, notice that:

  • If an authentic mapping would have been published, the mapping by this module will be corrected according to that mapping.

  • 0xFC5A in Shift_JISX0213 is mapped to U+9B1D according to JIS X 0213:2000, while Unicode's Unihan.txt maps it to U+9B1C.

  • 0x81D4 and 0x81D5 in Shift_JISX0213 is mapped in the block of Halfwidth and Fullwidth Forms, not in the block of Miscellaneous Mathematical Symbols-B, according to Shibano's JIS KANJI JITEN, published in June, 2002.

  • 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 Shift_JISX0213 character*. Then round-trippedness for a Shift_JISX0213 *string* is broken. (E.g. Shift_JISX0213 <0x8663> and <0x857B, 0x867B> both are mapped to <U+00E6, U+0300>; but <U+00E6, U+0300> is mapped only to SJIS <0x8663>.)

    SJIS0213  Unicode 3.2.0    # Name by JIS X 0213:2000

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(TU)]
0x839E    <U+30C8, U+309A> # [KATAKANA LETTER AINU TO(TU)]
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>

http://homepage1.nifty.com/nomenclator/perl/

Copyright(C) 2002-2003, 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

7-bit and 8-bit double byte coded extended KANJI sets for information interchange (by JIS Committee)

JIS KANJI JITEN, the revised edition.

edited by Shibano, published by Japanese Standards Association (JSA), 2002, Tokyo [ISBN4-542-20129-5]

http://www.jsa.or.jp/

Japanese Standards Association (access to JIS)

http://www.unicode.org/Public/UNIDATA/Unihan.txt

Unihan database (Unicode version: 3.2.0) by Unicode (c).

http://homepage1.nifty.com/nomenclator/unicode/sjis0213.zip

A mapping table between Shift_JISX0213 and Unicode 3.2.0.

(This table is prepared by me, and with no authority; but through the table, you will know what is to be done by this module.)

ShiftJIS::CP932::MapUTF

conversion between Microsoft Windows CP-932 and Unicode

(The CP932-Unicode mapping is different with the Shift_JISX0213-Unicode mapping, but what you desire may be the former.)