Perl Diver 2.31
Main Environment Variables Perl Default Values Perl Config - Summary Perl Config - Full Installed Modules List Directory uptime Docs

Module Documentation
Details and documentation about a specific module, including version and documentation (if available). Note that while links to perldoc.com and search.cpan.org are provided, the module may be part of a larger distribution. If you reach a File Not Found page on either site, please try the parent module.

locale

Name locale
Version 1.09
Located at /usr/share/perl5
File /usr/share/perl5/locale.pm
Is Core Yes
Search CPAN for this module locale
Documentation locale
Module Details locale

NAME

locale - Perl pragma to use or avoid POSIX locales for built-in operations


WARNING

DO NOT USE this pragma in scripts that have multiple threads active. The locale is not local to a single thread. Another thread may change the locale at any time, which could cause at a minimum that a given thread is operating in a locale it isn't expecting to be in. On some platforms, segfaults can also occur. The locale change need not be explicit; some operations cause perl to change the locale itself. You are vulnerable simply by having done a "use locale".


SYNOPSIS

    @x = sort @y;      # Native-platform/Unicode code point sort order
    {
        use locale;
        @x = sort @y;  # Locale-defined sort order
    }
    @x = sort @y;      # Native-platform/Unicode code point sort order
                       # again


DESCRIPTION

This pragma tells the compiler to enable (or disable) the use of POSIX locales for built-in operations (for example, LC_CTYPE for regular expressions, LC_COLLATE for string comparison, and LC_NUMERIC for number formatting). Each ``use locale'' or ``no locale'' affects statements to the end of the enclosing BLOCK.

See perllocale for more detailed information on how Perl supports locales.

On systems that don't have locales, this pragma will cause your operations to behave as if in the ``C'' locale; attempts to change the locale will fail.

Perl Diver brought to you by ScriptSolutions.com © 1997- 2024