view release on metacpan or  search on metacpan

lib/Big5HKSCS.pm  view on Meta::CPAN

  -------------------------------------------

  ------------------------------------------------------------------------------------------------------------------------
  Before                   After
  ------------------------------------------------------------------------------------------------------------------------
  use Perl::Module;        BEGIN { Ebig5hkscs::require 'Perl/Module.pm'; Perl::Module->import() if Perl::Module->can('import'); }
  use Perl::Module @list;  BEGIN { Ebig5hkscs::require 'Perl/Module.pm'; Perl::Module->import(@list) if Perl::Module->can('import'); }
  use Perl::Module ();     BEGIN { Ebig5hkscs::require 'Perl/Module.pm'; }
  no Perl::Module;         BEGIN { Ebig5hkscs::require 'Perl/Module.pm'; Perl::Module->unimport() if Perl::Module->can('unimport'); }
  no Perl::Module @list;   BEGIN { Ebig5hkscs::require 'Perl/Module.pm'; Perl::Module->unimport(@list) if Perl::Module->can('unimport'); }
  no Perl::Module ();      BEGIN { Ebig5hkscs::require 'Perl/Module.pm'; }
  ------------------------------------------------------------------------------------------------------------------------

=head1 Escaping File Test Operators (Big5HKSCS software provides)

Insert 'Ebig5hkscs::' instead of '-' of operator.

  Available in MSWin32, MacOS, and UNIX-like systems
  --------------------------------------------------------------------------
  Before   After      Meaning
  --------------------------------------------------------------------------
  -r       Ebig5hkscs::r   File or directory is readable by this (effective) user or group
  -w       Ebig5hkscs::w   File or directory is writable by this (effective) user or group
  -e       Ebig5hkscs::e   File or directory name exists
  -x       Ebig5hkscs::x   File or directory is executable by this (effective) user or group
  -z       Ebig5hkscs::z   File exists and has zero size (always false for directories)
  -f       Ebig5hkscs::f   Entry is a plain file
  -d       Ebig5hkscs::d   Entry is a directory
  -t       -t         The filehandle is a TTY (as reported by the isatty() system function;
                      filenames can't be tested by this test)
  -T       Ebig5hkscs::T   File looks like a "text" file
  -B       Ebig5hkscs::B   File looks like a "binary" file
  -M       Ebig5hkscs::M   Modification age (measured in days)
  -A       Ebig5hkscs::A   Access age (measured in days)
  -C       Ebig5hkscs::C   Inode-modification age (measured in days)
  -s       Ebig5hkscs::s   File or directory exists and has nonzero size
                      (the value is the size in bytes)
  --------------------------------------------------------------------------
  
  Available in MacOS and UNIX-like systems
  --------------------------------------------------------------------------
  Before   After      Meaning
  --------------------------------------------------------------------------
  -R       Ebig5hkscs::R   File or directory is readable by this real user or group
  -W       Ebig5hkscs::W   File or directory is writable by this real user or group
  -X       Ebig5hkscs::X   File or directory is executable by this real user or group
  -l       Ebig5hkscs::l   Entry is a symbolic link
  -S       Ebig5hkscs::S   Entry is a socket
  --------------------------------------------------------------------------
  
  Not available in MSWin32 and MacOS
  --------------------------------------------------------------------------
  Before   After      Meaning
  --------------------------------------------------------------------------
  -o       Ebig5hkscs::o   File or directory is owned by this (effective) user
  -O       Ebig5hkscs::O   File or directory is owned by this real user
  -p       Ebig5hkscs::p   Entry is a named pipe (a "fifo")
  -b       Ebig5hkscs::b   Entry is a block-special file (like a mountable disk)
  -c       Ebig5hkscs::c   Entry is a character-special file (like an I/O device)
  -u       Ebig5hkscs::u   File or directory is setuid
  -g       Ebig5hkscs::g   File or directory is setgid
  -k       Ebig5hkscs::k   File or directory has the sticky bit set
  --------------------------------------------------------------------------

-w only inspects the read-only file attribute (FILE_ATTRIBUTE_READONLY), which
determines whether the directory can be deleted, not whether it can be written
to. Directories always have read and write access unless denied by
discretionary access control lists (DACLs). (MSWin32)
-R, -W, -X, -O are indistinguishable from -r, -w, -x, -o. (MSWin32)
-g, -k, -l, -u, -A are not particularly meaningful. (MSWin32)
-x (or -X) determine if a file ends in one of the executable suffixes. -S is
meaningless. (MSWin32)

As of Perl 5.00503, as a form of purely syntactic sugar, you can stack file
test operators, in a way that -w -x $file is equivalent to -x $file && -w _ .

  if ( -w -r $file ) {
      print "The file is both readable and writable!\n";
  }

=head1 Escaping Function Name (You do)

You need write 'Big5HKSCS::' at head of function name when you want character-
oriented subroutine. See 'Character-Oriented Subroutines'.

  --------------------------------------------------------
  Function   Character-Oriented   Description
  --------------------------------------------------------
  ord        Big5HKSCS::ord
  reverse    Big5HKSCS::reverse
  getc       Big5HKSCS::getc
  length     Big5HKSCS::length
  substr     Big5HKSCS::substr
  index      Big5HKSCS::index          See 'About Indexes'
  rindex     Big5HKSCS::rindex         See 'About Rindexes'
  eval       Big5HKSCS::eval
  --------------------------------------------------------

  About Indexes
  -------------------------------------------------------------------------
  Function       Works as    Returns as   Description
  -------------------------------------------------------------------------
  index          Character   Byte         JPerl semantics (most useful)
  (same as Ebig5hkscs::index)
  Big5HKSCS::index    Character   Character    Character-oriented semantics
  CORE::index    Byte        Byte         Byte-oriented semantics
  (nothing)      Byte        Character    (most useless)
  -------------------------------------------------------------------------

  About Rindexes
  -------------------------------------------------------------------------
  Function       Works as    Returns as   Description
  -------------------------------------------------------------------------
  rindex         Character   Byte         JPerl semantics (most useful)
  (same as Ebig5hkscs::rindex)
  Big5HKSCS::rindex   Character   Character    Character-oriented semantics
  CORE::rindex   Byte        Byte         Byte-oriented semantics
  (nothing)      Byte        Character    (most useless)
  -------------------------------------------------------------------------

=head1 Character-Oriented Subsroutines