ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / share / perl5

package locale;

our $VERSION = '1.01';

$Carp::Internal{ (__PACKAGE__) } = 1;

=head1 NAME

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

=head1 SYNOPSIS

@x = sort @y;	# Unicode sorting order
    {
        use locale;
        @x = sort @y;   # Locale-defined sorting order
    }
    @x = sort @y;	# Unicode sorting order again

=head1 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.

Starting in Perl 5.16, a hybrid mode for this pragma is available,

use locale ':not_characters';

which enables only the portions of locales that don't affect the character
set (that is, all except LC_COLLATE and LC_CTYPE).  This is useful when mixing
Unicode and locales, including UTF-8 locales.

use locale ':not_characters';
    use open ":locale";           # Convert I/O to/from Unicode
    use POSIX qw(locale_h);       # Import the LC_ALL constant
    setlocale(LC_ALL, "");        # Required for the next statement
                                  # to take effect
    printf "%.2f\n", 12345.67'    # Locale-defined formatting
    @x = sort @y;                 # Unicode-defined sorting order.
                                  # (Note that you will get better
                                  # results using Unicode::Collate.)

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

=cut

# A separate bit is used for each of the two forms of the pragma, as they are
# mostly independent, and interact with each other and the unicode_strings
# feature.  This allows for fast determination of which one(s) of the three
# are to be used at any given point, and no code has to be written to deal
# with coming in and out of scopes--it falls automatically out from the hint
# handling

$locale::hint_bits = 0x4;
$locale::not_chars_hint_bits = 0x10;

sub import {
    shift;  # should be 'locale'; not checked
    my $found_not_chars = 0;
    while (defined (my $arg = shift)) {
        if ($arg eq ":not_characters") {
            $^H |= $locale::not_chars_hint_bits;

# This form of the pragma overrides the other
            $^H &= ~$locale::hint_bits;
            $found_not_chars = 1;
        }
        else {
            require Carp;
            Carp::croak("Unknown parameter '$arg' to 'use locale'");
        }
    }

# Use the plain form if not doing the :not_characters one.
    $^H |= $locale::hint_bits unless $found_not_chars;
}

sub unimport {
    $^H &= ~($locale::hint_bits|$locale::not_chars_hint_bits);
}

[-] AutoLoader.pm [edit]
[+] warnings
[+] Perl
[-] CORE.pod [edit]
[+] Compress
[-] fields.pm [edit]
[-] SelectSaver.pm [edit]
[+] vendor_perl
[-] DirHandle.pm [edit]
[-] Safe.pm [edit]
[+] HTTP
[+] B
[-] vmsish.pm [edit]
[+] Memoize
[-] SelfLoader.pm [edit]
[-] overloading.pm [edit]
[-] bigrat.pm [edit]
[+] Config
[-] bytes_heavy.pl [edit]
[+] ..
[+] IPC
[-] lwptut.pod [edit]
[+] File
[-] blib.pm [edit]
[-] strict.pm [edit]
[+] IO
[+] Net
[-] Memoize.pm [edit]
[+] DBM_Filter
[+] Version
[-] utf8_heavy.pl [edit]
[-] lwpcook.pod [edit]
[-] less.pm [edit]
[+] Pod
[+] Archive
[-] Symbol.pm [edit]
[+] Object
[-] utf8.pm [edit]
[-] XSLoader.pm [edit]
[-] CPAN.pm [edit]
[+] Tie
[-] deprecate.pm [edit]
[+] PerlIO
[-] if.pm [edit]
[+] pod
[-] diagnostics.pm [edit]
[-] subs.pm [edit]
[+] Encode
[+] Filter
[+] CPAN
[+] unicore
[+] Devel
[-] filetest.pm [edit]
[-] LWP.pm [edit]
[+] Unicode
[+] Test
[-] NEXT.pm [edit]
[-] sort.pm [edit]
[-] Test.pm [edit]
[+] Term
[+] overload
[-] FindBin.pm [edit]
[+] Attribute
[-] open.pm [edit]
[-] sigtrap.pm [edit]
[-] bignum.pm [edit]
[-] vars.pm [edit]
[-] AutoSplit.pm [edit]
[-] FileHandle.pm [edit]
[-] base.pm [edit]
[-] PerlIO.pm [edit]
[+] Time
[+] Text
[-] English.pm [edit]
[+] Getopt
[+] ExtUtils
[+] URI
[-] Benchmark.pm [edit]
[+] Package
[+] Thread
[-] DBM_Filter.pm [edit]
[-] _charnames.pm [edit]
[-] warnings.pm [edit]
[-] feature.pm [edit]
[+] LWP
[-] integer.pm [edit]
[+] Module
[+] encoding
[-] Thread.pm [edit]
[-] AnyDBM_File.pm [edit]
[+] User
[-] dumpvar.pl [edit]
[+] Log
[-] Dumpvalue.pm [edit]
[-] bigint.pm [edit]
[+] Search
[+] I18N
[+] Class
[-] URI.pm [edit]
[-] autouse.pm [edit]
[-] perlfaq.pm [edit]
[-] locale.pm [edit]
[-] bytes.pm [edit]
[+] Math
[-] DB.pm [edit]
[-] FileCache.pm [edit]
[+] JSON
[-] overload.pm [edit]
[-] charnames.pm [edit]
[+] App
[-] perl5db.pl [edit]
[+] Locale
[-] UNIVERSAL.pm [edit]