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/