NAME

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

SYNOPSIS

    *** CAUTION ********************************
      MUST USE SAME VERSION OF THIS SOFTWARE
      BOTH CONVERTING "A to B" AND "B to A"
      TO HAVE ROUND-TRIP CONVERSION.
    ********************************************

    use FindBin;
    use lib "$FindBin::Bin/lib";
    use Jacode4e::RoundTrip;

    $return =
    Jacode4e::RoundTrip::convert(\$line, $OUTPUT_encoding, $INPUT_encoding [, { %option }]);

    $return
      Number of characters in $line
 
    $line
      String variable to convert
      After conversion, this variable is overwritten
 
    $OUTPUT_encoding, and $INPUT_encoding
      To convert, you must specify both $OUTPUT_encoding and $INPUT_encoding.
      The encodings you can specify are as follows:
 
      mnemonic      means
      -----------------------------------------------------------------------
      cp932x        CP932X, Extended CP932 to JIS X 0213 using 0x9C5A as single shift
      cp00930       IBM CP00930(CP00290+CP00300), CCSID 5026 katakana
      keis78        HITACHI KEIS78
      keis83        HITACHI KEIS83
      keis90        HITACHI KEIS90
      jef           FUJITSU JEF (12 point size for printing with option OUTPUT_SHIFTING)
      jef9p         FUJITSU JEF ( 9 point size for printing with option OUTPUT_SHIFTING)
      jipsj         NEC JIPS(J)
      jipse         NEC JIPS(E)
      letsj         UNISYS LetsJ
      utf8          UTF-8.0 (aka UTF-8)
      utf8.1        UTF-8.1
      utf8jp        UTF-8-SPUA-JP, JIS X 0213 on SPUA ordered by JIS level, plane, row, cell
      -----------------------------------------------------------------------
 
      Round-trip conversion impossible, only for reference
 
      mnemonic      means
      -----------------------------------------------------------------------
      cp932         Microsoft CP932, IANA Windows-31J
      cp932ibm      IBM CP932
      cp932nec      NEC CP932
      sjis2004      JISC Shift_JIS-2004
      -----------------------------------------------------------------------
 
    %option
      The options you can specify are as follows:
 
      key mnemonic      value means
      -----------------------------------------------------------------------
      INPUT_LAYOUT      input record layout by 'S' and 'D' sequence
                        'S' means one char as SBCS, 'D' means one char as DBCS
                        each letter may optionally be followed by a number
                        indicating the repeat count, see samples
      OUTPUT_SHIFTING   true means use output shift code, false means not use
                        default is false
      SPACE             output space code in DBCS/MBCS
      GETA              output geta code in DBCS/MBCS
      OVERRIDE_MAPPING  hash reference of FROM => TO override mapping
                        { "\x12\x34"=>"\x56\x78", "\x9A\xBC"=>"\xDE\xFE", }
                        (CAUTION! override also SPACE option)
      -----------------------------------------------------------------------

    *** CAUTION ********************************
      MUST USE SAME VERSION OF THIS SOFTWARE
      BOTH CONVERTING "A to B" AND "B to A"
      TO HAVE ROUND-TRIP CONVERSION.
    ********************************************

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.

SUPPORTED PERL VERSIONS

    perl version 5.005_03 to newest perl