NAME

  Char - Multibyte Character Support by Traditional Scripting

SYNOPSIS

  # encoding: sjis
  use Char;
  print "Hello, world wide market!\n";

  # "no Char;" not supported

DESCRIPTION

  The Char software provides multibyte character-oriented Perl environment
  by traditional Perl scripting.

  - Character oriented regular expression
  - Character oriented runtime routines
  - Character oriented subroutines
      and
  - Byte oriented CORE::* functions
  - Byte oriented regular expression on /b modifier

  Information processing model beginning with Perl3 or this software.

    +--------------------------------------------+
    |    Text string as Digital octet string     |
    |    Digital octet string as Text string     |
    +--------------------------------------------+
    |       Not UTF8 Flagged, No Mojibake        |
    +--------------------------------------------+

  In UNIX Everything is a File
  - In UNIX everything is a stream of bytes
  - In UNIX the filesystem is used as a universal name space

  Native Encoding Scripting
  - native encoding of file contents
  - native encoding of file name on filesystem
  - native encoding of command line
  - native encoding of environment variable
  - native encoding of API
  - native encoding of network packet
  - native encoding of database

INSTALLATION

  Just copy Char.pm to your @INC directory.
  For example, to C:\Perl\site\lib on Microsoft Windows or other DOS-like
  systems.

SUBROUTINES

  Old Days -- memories are always beautiful.

    Functions of
    Byte and SBCS -- Traditional Perl Script
    -------------
    eval
    length
    substr
    ord
    reverse
    getc
    index
    rindex
    pos
    m//
    s///
    split //
    tr///
    qr//
    -------------

  Today -- some memories are beautiful, others are not.
           (I don't say what are not;)
                                           ***************                   
    Byte Oriented     Character Oriented   * Casual      *        Traditional
    Functions     vs  Subroutines      --> * Char Script * nearly Perl Script
    -------------     ----------------     ***************        -----------
    eval          vs  Char::eval       --> * Char::eval  * is not eval       
    length        vs  Char::length     --> * length      *   is   length     
    substr        vs  Char::substr     --> * substr      *   is   substr     
    ord           vs  Char::ord        --> * ord         *   is   ord        
    reverse       vs  Char::reverse    --> * reverse     *   is   reverse    
    getc          vs  Char::getc       --> * getc        *   is   getc       
    index         vs  Char::index      --> * index       *   is   index      
    rindex        vs  Char::rindex     --> * rindex      *   is   rindex     
    pos           vs  (nothing)        --> * pos         *   is   pos        
    m//b          vs  m//              --> * m//         *   is   m//        
    s///b         vs  s///             --> * s///        *   is   s///       
    split //b     vs  split //         --> * split //    *   is   split //   
    tr///b        vs  tr///            --> * tr///       *   is   tr///      
    qr//b         vs  qr//             --> * qr//        *   is   qr//       
    -------------     ----------------     ***************        -----------

  - Data typing by switching operators, as traditional Perl style
  - Text data by Character Oriented Subroutines
  - Binary data by Byte Oriented Functions
  - /b modifier was introduced via JPerl
  - Multibyte Character Support by Traditional Scripting, in almost all cases

ENCODING FAMILY

  Arabic, Big5HKSCS, Big5Plus, Cyrillic, EUCJP, EUCTW, GB18030, GBK, Greek,
  HP15, Hebrew, INFORMIXV6ALS, JIS8, KOI8R, KOI8U, KPS9566, Latin1, Latin10,
  Latin2, Latin3, Latin4, Latin5, Latin6, Latin7, Latin8, Latin9, OldUTF8,
  Sjis, TIS620, UHC, USASCII, UTF2, Windows1252, and Windows1258

SUPPORTED OPERATING SYSTEMS

  Apple Mac OS X, HP HP-UX, IBM AIX, Microsoft Windows, Oracle Solaris,
  and Other Systems

SUPPORTED PERL VERSIONS

  perl version 5.005_03 to newest perl

SEE ALSO

  http://search.cpan.org/~ina/
  http://backpan.perl.org/authors/id/I/IN/INA/

