NAME

 Char - Character Oriented Perl by Magic Comment

SYNOPSIS

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

 # "no Char;" not supported

DESCRIPTION

 The Char software provides character oriented Perl scripting
 environment by easy installation and easy usage.

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

   +--------------------------------------------+
   |  Basically,                                |
   |       Text strings as Binary strings       |
   |       Binary strings as Text strings       |
   +--------------------------------------------+
   |        Not UTF8 Flagged, UNIX/C-ism        |
   +--------------------------------------------+

 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 on Operating Systems
 - same as Content of a file
 - same as Filename on the filesystem
 - same as Command line
 - same as Environment variable
 - same as Parameter of API

INSTALLATION

 Just copy Char.pm to your @INC directory.
 For example, to C:\Perl\site\lib

SUBROUTINES

 Old Days -- memories are always beautiful.

     Functions of
     Byte and SBCS
     -------------
     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
     Functions            Subroutines
     -------------        ------------------
     eval                 Char::eval
     length               Char::length
     substr               Char::substr
     ord                  Char::ord
     reverse              Char::reverse
     getc                 Char::getc
     index                Char::index
     rindex               Char::rindex
     pos                  (nothing)
     m//b                 m//
     s///b                s///
     split //b            split //
     tr///b               tr///
     qr//b                qr//
     -------------        ------------------

 - Data typing by switching operators, as Perl style
 - Text data by Character Oriented Subroutines
 - Binary data by Byte Oriented Functions
 - /b modifier was introduced via JPerl

SEE ALSO

 http://search.cpan.org/~ina/