NAME

Encode::Arabic - Perl extension for encodings of Arabic

REVISION

$Revision: 1.10 $        $Date: 2004/01/12 22:10:28 $

SYNOPSIS

use Encode::Arabic;                 # imports just like 'use Encode' even with options would

while ($line = <>) {                # renders the ArabTeX notation for Arabic both in the ..

    print encode 'utf8', decode 'arabtex', $line;          # .. Arabic script proper and the
    print encode 'utf8', decode 'arabtex-zdmg', $line;     # .. Latin phonetic transcription
}

# Arabic in lower ASCII transliterations <--> Arabic script in Perl's internal encoding

$string = decode 'ArabTeX', $octets;
$octets = encode 'Buckwalter', $string;

$string = decode 'Buckwalter', $octets;
$octets = encode 'ArabTeX', $string;

# Arabic in lower ASCII transliterations <--> Latin phonetic transcription, Perl's utf8

$string = decode 'Buckwalter', $octets;
$octets = encode 'ArabTeX', $string;

$string = decode 'ArabTeX-ZDMG', $octets;
$octets = encode 'utf8', $string;

DESCRIPTION

This module is a wrapper for different implementations of encoding systems used for the Arabic language, rather than the Arabic script. The included modules fit in the philosophy of Encode::Encoding and can be used directly with the Encode module.

ENCODING LIST

ArabTeX

ArabTeX multi-character notation for Arabic / Perl's internal format for the Arabic script

Encode::Arabic::ArabTeX, uses Encode::Mapper

ArabTeX-RE

Deprecated method using sequential regular-expression substitutions. Limited in scope over the ArabTeX notation and non-efficient in data processing, still, not requiring the Encode::Mapper module.

Encode::Arabic::ArabTeX::RE

ArabTeX-ZDMG

ArabTeX multi-character notation for Arabic / Perl's internal format for the Latin phonetic trascription in the ZDMG style

Encode::Arabic::ArabTeX::ZDMG, uses Encode::Mapper

ArabTeX-ZDMG-RE

Deprecated method using sequential regular-expression substitutions. Limited in scope over the ArabTeX notation and non-efficient in data processing, still, not requiring the Encode::Mapper module.

Encode::Arabic::ArabTeX::ZDMG::RE

Buckwalter

Buckwalter one-to-one notation for Arabic / Perl's internal format for the Arabic script

Encode::Arabic::Buckwalter

There are generic aliases to these provided by Encode. Case does not matter and all characters of the class [ _-] are interchangable.

Note that the standard Encode module already deals with several other single-byte encoding schemes for Arabic popular with whichever operating system, be it *n*x, Windows, DOS or Macintosh. See Encode::Supported and Encode::Byte for their identification names and aliases.

EXPORT POLICY

The module exports as if use Encode also appeared in the package. The import options are just delegated to Encode and imports performed properly.

SEE ALSO

Encode::Arabic Online Interface http://ckl.mff.cuni.cz/smrz/Encode/Arabic

Klaus Lagally's ArabTeX ftp://ftp.informatik.uni-stuttgart.de/pub/arabtex/arabtex.htm

Tim Buckwalter's Qamus http://www.qamus.org

Arabeyes Arabic Unix Project http://www.arabeyes.org

Encode, Encode::Encoding, Encode::Mapper, Encode::Supported, Encode::Byte

Locale::Recode, Locale::RecodeData

MARC::Charset, MARC::Charset::ArabicBasic, MARC::Charset::ArabicExtended

Lingua::AR::MacArabic

Text::TransMetaphone::ar

AUTHOR

Otakar Smrz, http://ckl.mff.cuni.cz/smrz/

eval { 'E<lt>' . 'smrz' . "\x40" . ( join '.', qw 'ckl mff cuni cz' ) . 'E<gt>' }

Perl is also designed to make the easy jobs not that easy ;)

COPYRIGHT AND LICENSE

Copyright 2003, 2004 by Otakar Smrz

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.