MAN page from Old RedHat 5.X perl-5.004-4.i386.rpm

I18N::Collate

Section: Perl Programmers Reference Guide (3)
Updated: perl 5.004, patch 04
Index

NAME

I18N::Collate - compare 8-bit scalar data according to the current locale

***

  WARNING: starting from the Perl version 5.003_06  the I18N::Collate interface for comparing 8-bit scalar data  according to the current locale

        HAS BEEN DEPRECATED

  That is, please do not use it anymore for any new applications  and please migrate the old applications away from it because its  functionality was integrated into the Perl core language in the  release 5.003_06.

  See the perllocale manual page for further information.

***

SYNOPSIS

    use I18N::Collate;    setlocale(LC_COLLATE, 'locale-of-your-choice');     $s1 = new I18N::Collate "scalar_data_1";    $s2 = new I18N::Collate "scalar_data_2";

DESCRIPTION

This module provides you with objects that will collate according to your national character set, provided that the POSIX setlocale() function is supported on your system.

You can compare $s1 and $s2 above with

    $s1 le $s2

to extract the data itself, you'll need a dereference: $$s1

This module uses POSIX::setlocale(). The basic collation conversion isdone by strxfrm() which terminates at NUL characters being a decent Croutine. collate_xfrm() handles embedded NUL characters gracefully.

The available locales depend on your operating system; try whetherlocale -a shows them or man pages for ``locale'' or ``nlsinfo'' or thedirect approach ls /usr/lib/nls/loc or ls /usr/lib/nls orls /usr/lib/locale. Not all the locales that your vendor supportsare necessarily installed: please consult your operating system'sdocumentation and possibly your local system administration. Thelocale names are probably something like xx_XX.(ISO)?8859-N orxx_XX.(ISO)?8859N, for example fr_CH.ISO8859-1 is the Swiss (CH)variant of French (fr), ISO Latin (8859) 1 (-1) which is the WesternEuropean character set.

This document was created byman2html,using the manual pages.