NAME

cyrillic - Library for fast and easy cyrillic text manipulation

SYNOPSIS

use cyrillic qw/866 win2dos convert locase upcase detect/;

print convert( 866, 1251, $str );
print convert( 'dos','win', \$str );
print win2dos $str;

DESCRIPTION

If first import parameter is number of codepage then locale switched to they codepage. Specialisation (like 'win2dos') call faster then 'convert'. Easy adding new codepage. For they need only add codepage string.

FUNCTIONS

Library includes converting and helper functions: convert, upcase, locase, upfirst, lofirst; detect, charset.

At importing list might be listed named convertors. For Ex.:

use cyrillic qw/dos2win win2koi mac2dos ibm2dos/;

The following rules are correct for converting functions:

VAR may be SCALAR or REF to SCALAR.
If VAR is REF to SCALAR then SCALAR will be converted.
If VAR is ommited then $_ operated.
If function called to void context and VAR is not REF
then result placed to $_.

convert SRC_CP, DST_CP, [VAR]

Convert VAR from SRC_CP codepage to DST_CP codepage and returns converted string.

upcase CODEPAGE, [VAR]

Convert VAR to uppercase using CODEPAGE table and returns converted string.

locase CODEPAGE, [VAR]

Convert VAR to lowercase using CODEPAGE table and returns converted string.

upfirst CODEPAGE, [VAR]

Convert first char of VAR to uppercase using CODEPAGE table and returns converted string.

lofirst CODEPAGE, [VAR]

Convert first char of VAR to lowercase using CODEPAGE table and returns converted string.

charset CODEPAGE

Returns charset name for CODEPAGE.

detect ARRAY

Detect codepage of data in ARRAY and returns codepage number. If codepage not detected then returns undefined value;

EXAMPLES

use cyrillic qw/convert locase upcase detect dos2win win2dos/;

$\ = "\n";
$_ = "\x8F\xE0\xA8\xA2\xA5\xE2 \xF0\xA6\x88\xAA\x88!";

print; upcase 866;
print; dos2win;
print; win2dos;
print; locase 866;
print;
print detect $_;


# EQVIVALENT CALLS:

dos2win( $str );        # called to void context -> result placed to $_
$_ = dos2win( $str );

dos2win( \$str );       # called with REF to string -> direct converting
$str = dos2win( $str );

dos2win();              # with ommited param called -> $_ converted
dos2win( \$_ );
$_ = dos2win( $_ );


# FOR EASY SWITCH LOCALE CODEPAGE

use cyrillic qw/866/;   # locale switched to 866 codepage

use locale;
print $str =~ /(\w+)/;

no locale;
print $str =~ /(\w+)/;

AUTHOR

Albert MICHEEV <Albert@f80.n5049.z2.fidonet.org>

COPYRIGHT

Copyright (C) 2000, Albert MICHEEV

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

AVAILABILITY

The latest version of this library is likely to be available from:

http://www.perl.com/CPAN