NAME

Regexp::Ethiopic - Regular Expressions Support for Ethiopic Script.

SYNOPSIS

#
#  Overloading Perl REs:
#
use utf8;
use Regexp::Ethiopic qw(:forms overload setForm);

:

s/([#2#])/setForm($1,$ሳድስ)/eg;
s/([መረበወ]%2)/setForm($1,$ሳድስ)/eg;
s/([መረበወ]%{1,3})/setForm($1,$ሳድስ)/eg;
s/([መረበወ]%{1-3,7})/setForm($1,$ሳድስ)/eg;

if ( /[#ኘ#]/ ) {
  #
  # do something
  #
  :
}

:
:

#
#  Without overloading:
#
use utf8;
require Regexp::Ethiopic;

my $string = "[መረበወ]%{1-3,7}";
my $re = Regexp::Ethiopic::getRe ( $string );

s/abc($re)xyz/"abc".Regexp::Ethipic::setForm($1,6)."xyz"/eg;

DESCRIPTION

The Regexp::Ethiopic module provides POSIX style character class definitions for working with the Ethiopic syllabary. The character classes provided by the Regexp::Ethiopic package correspond to inate properties of the script and are language independent.

The Regexp::Ethiopic package is NOT derived from the Regexp class and may not be instantiated into an object. Regexp::Ethiopic can optionally export the utility functions getForm and setForm to query or set the form of an Ethiopic character. Tags of variables in the form names set to form values may be exported under the :forms pragma.

See the files in the doc/ and examples/ directories that are included with this package.

LIMITATIONS

The overloading mechanism only applies to the constant part of the RE. The following would not be handled by the Regexp::Ethipic package as expected:

use Regexp::Ethiopic 'overload';

my $x = "ከ";
      :
      :
if ( /[#$x#]/ ) {
      :
      :
}

The package never gets to see the variable $x to then perform the RE expansion. The work around is to use the package as per:

use Regexp::Ethiopic 'overload';

my $x = "ከ";
      :
      :
my $re = Regexp::Ethiopic::getRe ( "[#$x#]" );

if ( /$re/ ) {
      :
      :
}

This works as expected at the cost of one extra step. The overloading and functional modes of the Regexp::Ethiopic package may be used together without conflict.

REQUIRES

Works perfectly with Perl 5.8.0, may work with Perl 5.6.x but has not yet been tested.

BUGS

None presently known.

AUTHOR

Daniel Yacob, Yacob@EthiopiaOnline.Net

SEE ALSO

Included with this package:

doc/index.html    examples/overload.pl    examples/asfunction.pl