NAME

Unicode::Lite - Library for easy charset convertion

SYNOPSIS

 use Unicode::Lite qw/convert convertor/;

 print convert( 'ibm866', 'unicode', "hello world!" );

 local *ibm2uni = convertor( 'ibm866', 'unicode' );
 print ibm2uni( "hello world!" );

 my $ibm2uni = convertor( 'ibm866', 'unicode' );
 print &$ibm2uni( "hello world!" );

DESCRIPTION

This module includes string converting function from one and to another charset. Requires installed Unicode::String and Unicode::Map packages.

Supported unicode charsets: unicode, utf16, ucs2, utf8, utf7, ucs4, latin1, uchr, uhex.

Supported single-byte charsets: all installed maps in Unicode::Map package.

FUNCTIONS

convert SRC_CP, DST_CP, [VAR]

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

convertor SRC_CP, DST_CP

Creates convertor function and returns reference to her, for further fast direct call.

 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 omitted, uses $_.
 If function called to void context and VAR is not REF
 then result placed to $_.

EXAMPLES

 local *ibm2uni = convertor( 'ibm866', 'unicode' );


 # EQVIVALENT CALLS:

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

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

 ibm2uni();              # with omitted param called -> $_ converted
 ibm2uni( \$_ );
 $_ = ibm2uni( $_ );

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

SEE ALSO

Unicode::String, Unicode::Map.