NAME

    Jacode4e::RoundTrip - Jacode4e for round-trip conversion in JIS X 0213

SYNOPSIS

    use FindBin;
    use lib "$FindBin::Bin/lib";
    use Jacode4e::RoundTrip;
    $return =
    Jacode4e::RoundTrip::convert(\$line, $OUTPUT_encoding, $INPUT_encoding [, { %option }]);

RAISON D'ETRE

    This software has been developed for use promotion of JIS X 0213.

    Jacode4e::RoundTrip module can round-trip convert JIS X 0213 characters
    in Japanese main-frames or enterprise servers each other, using its
    user-defined area.

    The encodings that can be round-trip converted are cp932x, cp00930,
    keis78, keis83, keis90, jef, jef9p, jipsj, jipse, letsj, utf8, utf8.1,
    and utf8jp.

    This table shows shortage to support JIS X 0213 in each encoding
    ---------------------------------------------------------------------
                           Jacode4e  short-  user-def.  unused    free
    mnemonic              supported     age       area    area    area
    ---------------------------------------------------------------------
    cp932x                   11,285       0         --      --      --
    cp00930                  11,257      28      1,880      --   1,880
    keis78, keis83, keis90    8,268   3,017      2,914     188   3,102
    jef, jef9p                8,814   2,471      3,102      --   3,102
    jipsj, jipse              8,637   2,648      3,948      --   3,948
    letsj                     9,876   1,409      2,632      --   2,632
    utf8, utf8.1             11,220      65      6,400      --   6,400
    utf8jp                   11,285       0         --      --      --
    ---------------------------------------------------------------------

    cp00930 use 28 code points from its user-defined area. Similarly, keis78,
    keis83, and keis90 use 3,017, jef and jef9p use 2,471, jipsj and jipse
    use 2,648, letsj use 1,409, utf8 and utf8.1 use 65. In case of KEIS, user-
    defined area is not enough to support JIS X 0213. So I decided to use
    unused area.

    Yes, you cannot use your gaiji on Jacode4e::RoundTrip module, you see.

    Jacode4e::RoundTrip module doesn't work as Jacode4e. And Jacode4e module
    doesn't work as Jacode4e::RoundTrip, too.

    This software is useful for processing your JIS X 0213 data by other
    system, and importing it again into your system.

WHAT IS "CP932X"?

    * "cp932x" as mnemonic
    * CP932X is CP932
    * Pronounce [si: pi: nain thri: tu: kai] in English
    * Pronounce [shi: pi: kju: san' ni kai] in Japanese
    * [si: pi: nain thri: tu: iks] is reserved for Microsoft Corporation ;-P
    * CP932 upper compatible
    * Supports JIS X 0213 character set
    * Used ghost character "\x9C\x5A" as single shift code
    * Used "\x9C\x5A\x9C\x5A" for single "\x9C\x5A"
    * You can use private use characters you made
    * You can use your operating system, network, and database.
    * In most cases, application programs can be used as it is.

INSTALLATION

   To test this software, type the following:

   make test

   To install this software, copy 'Jacode4e/RoundTrip.pm' to any directory of @INC.

DEPENDENCIES

    This software requires perl 5.00503 or later.

SEE ALSO

    jcode.pl: Perl library for Japanese character code conversion, Kazumasa Utashiro
    ftp://ftp.iij.ad.jp/pub/IIJ/dist/utashiro/perl/
    http://web.archive.org/web/20090608090304/http://srekcah.org/jcode/
    ftp://ftp.oreilly.co.jp/pcjp98/utashiro/
    http://mail.pm.org/pipermail/tokyo-pm/2002-March/001319.html
    https://twitter.com/uta46/status/11578906320

    jacode - Perl program for Japanese character code conversion
    https://metacpan.org/search?q=jacode.pl

    Jacode4e - jacode.pl-like program for enterprise
    https://metacpan.org/pod/Jacode4e

    Jacode4e::RoundTrip - Jacode4e for round-trip conversion in JIS X 0213
    https://metacpan.org/pod/Jacode4e::RoundTrip

    Modern::Open - Autovivification, Autodie, and 3-args open support
    https://metacpan.org/pod/Modern::Open