Gecko [ armaneco.co.uk ]

Name	Size	Permission	Date
App	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Archive	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
Attribute	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
B	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
CPAN	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Class	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Compress	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
Config	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
DBM_Filter	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Devel	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Encode	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
ExtUtils	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
File	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Filter	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Getopt	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
HTTP	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
I18N	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
IO	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
IPC	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
JSON	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
LWP	[ DIR ]	drwxr-xr-x	2021-08-24 17:00
Locale	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
Log	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
Math	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Memoize	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Module	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Net	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Object	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Package	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Perl	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
PerlIO	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
Pod	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Search	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Term	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Test	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
Text	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Thread	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Tie	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Time	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
URI	[ DIR ]	drwxr-xr-x	2021-08-24 17:00
Unicode	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
User	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
Version	[ DIR ]	drwxr-xr-x	2026-01-13 18:27
encoding	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
overload	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
pod	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
unicore	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
vendor_perl	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
warnings	[ DIR ]	drwxr-xr-x	2026-02-03 06:51
AnyDBM_File.pm	2.56 KB	-rw-r--r--	2026-01-13 18:27
AutoLoader.pm	14.66 KB	-rw-r--r--	2026-01-13 18:27
AutoSplit.pm	19.18 KB	-rw-r--r--	2026-01-13 18:27
Benchmark.pm	27.87 KB	-rw-r--r--	2026-01-13 18:27
CORE.pod	2.7 KB	-rw-r--r--	2026-01-13 18:27
CPAN.pm	132.91 KB	-rw-r--r--	2026-01-13 18:14
DB.pm	18.43 KB	-rw-r--r--	2026-01-13 18:27
DBM_Filter.pm	14.06 KB	-rw-r--r--	2026-01-13 18:27
DirHandle.pm	1.52 KB	-rw-r--r--	2026-01-13 18:27
Dumpvalue.pm	16.5 KB	-rw-r--r--	2026-01-13 18:27
English.pm	4.34 KB	-rw-r--r--	2026-01-13 18:27
FileCache.pm	5.44 KB	-rw-r--r--	2026-01-13 18:27
FileHandle.pm	6.62 KB	-rw-r--r--	2026-01-13 18:27
FindBin.pm	4.45 KB	-rw-r--r--	2026-01-13 18:27
LWP.pm	21.15 KB	-rw-r--r--	2013-03-12 01:03
Memoize.pm	34.4 KB	-rw-r--r--	2026-01-13 18:27
NEXT.pm	18.05 KB	-rw-r--r--	2026-01-13 18:27
PerlIO.pm	10.19 KB	-rw-r--r--	2026-01-13 18:27
Safe.pm	24.03 KB	-rw-r--r--	2026-01-13 18:27
SelectSaver.pm	1.05 KB	-rw-r--r--	2026-01-13 18:27
SelfLoader.pm	16.97 KB	-rw-r--r--	2026-01-13 18:27
Symbol.pm	4.68 KB	-rw-r--r--	2026-01-13 18:27
Test.pm	28.13 KB	-rw-r--r--	2026-01-13 18:27
Thread.pm	8.09 KB	-rw-r--r--	2026-01-13 18:27
UNIVERSAL.pm	6.97 KB	-rw-r--r--	2026-01-13 18:27
URI.pm	33.01 KB	-rw-r--r--	2012-03-26 01:17
XSLoader.pm	9.99 KB	-rw-r--r--	2026-01-13 18:27
_charnames.pm	29.8 KB	-rw-r--r--	2026-01-13 18:27
autouse.pm	4.14 KB	-rw-r--r--	2026-01-13 18:27
base.pm	6.37 KB	-rw-r--r--	2026-01-13 18:27
bigint.pm	17.44 KB	-rw-r--r--	2026-01-13 18:27
bignum.pm	18.23 KB	-rw-r--r--	2026-01-13 18:27
bigrat.pm	14.11 KB	-rw-r--r--	2026-01-13 18:27
blib.pm	2.04 KB	-rw-r--r--	2026-01-13 18:27
bytes.pm	2.96 KB	-rw-r--r--	2026-01-13 18:27
bytes_heavy.pl	758 B	-rw-r--r--	2026-01-13 18:27
charnames.pm	19.22 KB	-rw-r--r--	2026-01-13 18:27
deprecate.pm	3.01 KB	-rw-r--r--	2026-01-13 18:27
diagnostics.pm	17.96 KB	-rw-r--r--	2026-01-13 18:27
dumpvar.pl	14.96 KB	-rw-r--r--	2026-01-13 18:27
feature.pm	11.06 KB	-rw-r--r--	2026-01-13 18:27
fields.pm	9.28 KB	-rw-r--r--	2026-01-13 18:27
filetest.pm	3.91 KB	-rw-r--r--	2026-01-13 18:27
if.pm	1.13 KB	-rw-r--r--	2026-01-13 18:27
integer.pm	3.19 KB	-rw-r--r--	2026-01-13 18:27
less.pm	3.13 KB	-rw-r--r--	2026-01-13 18:27
locale.pm	2.72 KB	-rw-r--r--	2026-01-13 18:27
lwpcook.pod	9.05 KB	-rw-r--r--	2012-02-11 18:32
lwptut.pod	24.89 KB	-rw-r--r--	2012-02-11 18:32
open.pm	7.83 KB	-rw-r--r--	2026-01-13 18:27
overload.pm	52.66 KB	-rw-r--r--	2026-01-13 18:27
overloading.pm	1.77 KB	-rw-r--r--	2026-01-13 18:27
perl5db.pl	302.79 KB	-rw-r--r--	2026-01-13 18:27
perlfaq.pm	94 B	-rw-r--r--	2026-01-13 18:27
sigtrap.pm	7.46 KB	-rw-r--r--	2026-01-13 18:27
sort.pm	5.95 KB	-rw-r--r--	2026-01-13 18:27
strict.pm	3.84 KB	-rw-r--r--	2026-01-13 18:27
subs.pm	845 B	-rw-r--r--	2026-01-13 18:27
utf8.pm	7.6 KB	-rw-r--r--	2026-01-13 18:27
utf8_heavy.pl	30.1 KB	-rw-r--r--	2026-01-13 18:27
vars.pm	2.3 KB	-rw-r--r--	2026-01-13 18:27
vmsish.pm	4.22 KB	-rw-r--r--	2026-01-13 18:27
warnings.pm	18.34 KB	-rw-r--r--	2026-01-13 18:27

Rename

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);
}