1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
package locale;
our $VERSION = '1.02';
use Config;
$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.
=head1 NOTE
If your system does not support locales, then loading this module will
cause the program to die with a message:
"Your vendor does not support locales, you cannot use the locale
module."
=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
if(!$Config{d_setlocale}) {
## No locale support found on this Perl, giving up:
die('Your vendor does not support locales, you cannot use the locale module.');
}
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);
}
1;
|
