NAME

    Jacode4e::RoundTrip - Converts JIS X 0213 Encodings with Round-Trip

CAUTION

    TO ROUND-TRIP CONVERTION, MUST USE SAME VERSION OF THIS SOFTWARE WHEN "A to B"
    AND "B to A".

SYNOPSIS

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

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

    $char_count
      Count of characters in $line

    $line
    $OUTPUT_encoding
    $INPUT_encoding
      Converts encoding of $line from $INPUT_encoding to $OUTPUT_encoding then
      overwrites $line.
      $OUTPUT_encoding and $INPUT_encoding cannot omit.
      You can use mnemonic as encoding name of $INPUT_encoding and $OUTPUT_encoding:

      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 (conversion based on Shift_JIS-Unicode mapping, not CP932)
      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 }
      Hash reference "{ %option }" can omit.
      You can following mnemonics as keys of hash reference "{ %option }":

      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)
      -----------------------------------------------------------------------

DEPENDENCIES

    perl version 5.005_03 to newest perl

