blib/lib/Locale/Country/Multilingual.pm

filter: Statementstmt 93.3% 113 / 121 Branchbran 66.6% 32 / 48 Conditioncond 76.3% 29 / 38 MC/DCmcdc 47.0% 8 / 17 Subroutinesub 95.6% 22 / 23 Podpod 100% 7 / 7 totaltotal 83.0% 211 / 254 CC 43 SCAR 18.6
CC
43
Cov
84%
_load_data
12.5
assert_lang
12.0
code2country
8.3
CRAP 6.4
↑ Summary
1 package Locale::Country::Multilingual;
2 6 $Locale::Country::Multilingual::VERSION = '0.25';
3 6 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 6 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
5  
6 6 ▶use base 'Class::Data::Inheritable';
Subroutine BEGIN: called CC=1 SCAR=0.0
7  
8 6 ▶use 5.008;
Subroutine BEGIN: called CC=1 SCAR=0.0
9  
10 6 ▶use Symbol;
Subroutine BEGIN: called CC=1 SCAR=0.0
11 6 ▶use File::Spec;
Subroutine BEGIN: called CC=1 SCAR=0.0
12 6 ▶use Carp;
Subroutine BEGIN: called CC=1 SCAR=0.0
13  
14 6 __PACKAGE__->mk_classdata(dir => (__FILE__ =~ /(.+)\.pm/)[0]);
15 6 __PACKAGE__->mk_classdata(languages => {});
16 6 __PACKAGE__->mk_classdata('use_io_layer');
17  
18 6 ▶use constant CODE => 0;
Subroutine BEGIN: called CC=1 SCAR=0.0
19 6 ▶use constant COUNTRY => 1;
Subroutine BEGIN: called CC=1 SCAR=0.0
20 6 ▶use constant LOCALE_CODE_ALPHA_2 => 0;
Subroutine BEGIN: called CC=1 SCAR=0.0
21 6 ▶use constant LOCALE_CODE_ALPHA_3 => 1;
Subroutine BEGIN: called CC=1 SCAR=0.0
22 6 ▶use constant LOCALE_CODE_NUMERIC => 2;
Subroutine BEGIN: called CC=1 SCAR=0.0
23 6 ▶use constant MAP_LOCALE_CODE_STR_TO_IDX => {
Subroutine BEGIN: called CC=1 SCAR=0.0
24 LOCALE_CODE_ALPHA_2 => 0,
25 LOCALE_CODE_ALPHA_3 => 1,
26 LOCALE_CODE_NUMERIC => 2,
27 6 };
28  
29  
30 6 ▶croak __PACKAGE__->dir, ": $!"
Branch: 1 branch
BranchTrueFalseTotal
unless -d __PACKAGE__->dir 0 6 6
31 unless -d __PACKAGE__->dir;
32  
33 6 ▶sub import {
Subroutine import: called CC=4 SCAR=13.9
34 6 my $class = shift;
35  
36 6 ▶ return unless @_;
Branch: 1 branch
BranchTrueFalseTotal
unless @_ 4 2 6
37  
38 2 ▶ my $opts = ref($_[-1]) eq 'HASH' ? pop : {};
Branch: 1 branch
BranchTrueFalseTotal
ref $_[-1] eq 'HASH' ? : 1 1 2
39  
40 2 $class->use_io_layer($opts->{use_io_layer});
41  
42 2 $class->_load_data($_) for @_;
43 }
44  
45 8 ▶sub new {
Subroutine new: called CC=2 SCAR=6.9
Pod documented
46 8 my $class = shift;
47 8 my %args;
48  
49 8 ▶ %args = @_ if @_;
Branch: 1 branch
BranchTrueFalseTotal
if @_ 5 3 8
50 8 return bless {
51 use_io_layer => 0,
52 %args,
53 }, $class;
54 }
55  
56 3 ▶sub set_lang {
Subroutine set_lang: called CC=2 SCAR=7.2
Pod documented
57 3 my $self = shift;
58  
59 3 ▶ $self->{'lang'} = shift if @_;
Branch: 1 branch
BranchTrueFalseTotal
if @_ 3 0 3
60 }
61  
62 0 ▶sub assert_lang {
Subroutine assert_lang: not called CC=3 SCAR=24.8
Pod documented
63 0 my $self = shift;
64  
65 0 foreach (@_) {
66 0 ▶ eval { $self->_load_data($_) }
Branch: 1 branch
BranchTrueFalseTotal
eval { do { $self->_load_data($_) } } and return $_ 0 0 0
67 and return $_;
68 }
69 0 return undef;
70 }
71  
72  
73 9 ▶sub code2country {
Subroutine code2country: called CC=8 SCAR=21.1
Pod documented
74 9 my $self = shift;
75 9 ▶ my $code = shift
Branch: 1 branch
BranchTrueFalseTotal
my $code = shift() or return 9 0 9
76 or return;
77  
78 9 ▶ return if $code =~ /\W/;
Branch: 1 branch
BranchTrueFalseTotal
if $code =~ /\W/ 0 9 9
79  
80 9 ▶ my $lang = shift || $self->{lang} || 'en';
Condition100%5/5
shift() || $self->{'lang'} || 'en'
l!l
63
shift() or $self->{"lang"}
l!l&&r!l&&!r
333
MC/DC100%2/2
shift() || $self->{'lang'} || 'en'
shift() $self->{"lang"}
Truth table100%3/3
A or B
A= shift()B= $self->{"lang"}
ABresult
1X1
011
000
81 9 my $language = $self->_load_data($lang);
82  
83 9 ▶ if ($code =~ /^\d+$/) {
Branch: 3 branches
BranchTrueFalseTotal
if ($code =~ /^\d+$/) { } 1 8 9
elsif (length $code == 2) { } 7 1 8
elsif (length $code == 3) { } 1 0 1
84 1 return $language->[CODE]->[LOCALE_CODE_NUMERIC]->{$code + 0};
85 } elsif (length($code) == 2) {
86 7 return $language->[CODE]->[LOCALE_CODE_ALPHA_2]->{uc($code)};
87 } elsif (length($code) == 3) {
88 1 return $language->[CODE]->[LOCALE_CODE_ALPHA_3]->{uc($code)};
89 }
90 0 return;
91 }
92  
93 5 ▶sub country2code {
Subroutine country2code: called CC=6 SCAR=18.2
Pod documented
94 5 my ($self, $country, $codeset, $lang) = @_;
95  
96 5 ▶ return undef unless defined $country;
Branch: 1 branch
BranchTrueFalseTotal
unless defined $country 0 5 5
97 5 $country = lc($country);
98  
99 5 ▶ $lang ||= $self->{lang} || 'en';
Condition60%3/5
$lang ||= $self->{"lang"} || "en"
l!l&&r!l&&!r
140
$self->{'lang'} || 'en'
l!l
40
MC/DC0%0/2
$lang ||= $self->{"lang"} || "en"
$lang $self->{'lang'}
Truth table66%2/3
A ||= B
A= $langB= $self->{'lang'}
ABresult
1X1
011
000
100 5 my $language = $self->_load_data($lang);
101  
102 return $language->[COUNTRY]
103 ->[MAP_LOCALE_CODE_STR_TO_IDX->{$codeset || 'LOCALE_CODE_ALPHA_2'} || 0]
104 5 ▶ ->{$country};
Condition100%4/4
{LOCALE_CODE_ALPHA_2 => 0, LOCALE_CODE_ALPHA_3 => 1, LOCALE_CODE_NUMERIC => 2}->{$codeset or 'LOCALE_CODE_ALPHA_2'} || 0
l!l
32
$codeset || 'LOCALE_CODE_ALPHA_2'
l!l
41
MC/DC100%1/1
{LOCALE_CODE_ALPHA_2 => 0, LOCALE_CODE_ALPHA_3 => 1, LOCALE_CODE_NUMERIC => 2}->{$codeset or 'LOCALE_CODE_ALPHA_2'} || 0
{LOCALE_CODE_ALPHA_2 => 0, LOCALE_CODE_ALPHA_3 => 1, LOCALE_CODE_NUMERIC => 2}->{$codeset or 'LOCALE_CODE_ALPHA_2'}
MC/DC100%1/1
$codeset || 'LOCALE_CODE_ALPHA_2'
$codeset
Truth table100%2/2
A
A= {LOCALE_CODE_ALPHA_2 => 0, LOCALE_CODE_ALPHA_3 => 1, LOCALE_CODE_NUMERIC => 2}->{$codeset or 'LOCALE_CODE_ALPHA_2'}
Aresult
11
00
Truth table100%2/2
A
A= $codeset
Aresult
11
00
105 }
106  
107 6 ▶sub all_country_codes {
Subroutine all_country_codes: called CC=5 SCAR=16.2
Pod documented
108 6 my ($self, $codeset) = @_;
109  
110 6 ▶ my $lang ||= $self->{lang} || 'en';
Condition60%3/5
my $lang ||= $self->{"lang"} || "en"
l!l&&r!l&&!r
060
$self->{'lang'} || 'en'
l!l
42
MC/DC0%0/2
my $lang ||= $self->{"lang"} || "en"
my $lang $self->{'lang'}
Truth table33%1/3
A ||= B
A= my $langB= $self->{'lang'}
ABresult
1X1
011
000
111 6 my $language = $self->_load_data($lang);
112  
113 return keys %{
114 6 $language->[CODE]
115 6 ▶ ->[MAP_LOCALE_CODE_STR_TO_IDX->{$codeset || 'LOCALE_CODE_ALPHA_2'} || 0]
Condition100%4/4
{LOCALE_CODE_ALPHA_2 => 0, LOCALE_CODE_ALPHA_3 => 1, LOCALE_CODE_NUMERIC => 2}->{$codeset or 'LOCALE_CODE_ALPHA_2'} || 0
l!l
15
$codeset || 'LOCALE_CODE_ALPHA_2'
l!l
15
MC/DC100%1/1
{LOCALE_CODE_ALPHA_2 => 0, LOCALE_CODE_ALPHA_3 => 1, LOCALE_CODE_NUMERIC => 2}->{$codeset or 'LOCALE_CODE_ALPHA_2'} || 0
{LOCALE_CODE_ALPHA_2 => 0, LOCALE_CODE_ALPHA_3 => 1, LOCALE_CODE_NUMERIC => 2}->{$codeset or 'LOCALE_CODE_ALPHA_2'}
MC/DC100%1/1
$codeset || 'LOCALE_CODE_ALPHA_2'
$codeset
Truth table100%2/2
A
A= {LOCALE_CODE_ALPHA_2 => 0, LOCALE_CODE_ALPHA_3 => 1, LOCALE_CODE_NUMERIC => 2}->{$codeset or 'LOCALE_CODE_ALPHA_2'}
Aresult
11
00
Truth table100%2/2
A
A= $codeset
Aresult
11
00
116 };
117 }
118  
119 2 ▶sub all_country_names {
Subroutine all_country_names: called CC=3 SCAR=11.2
Pod documented
120 2 my ($self, $lang) = @_;
121  
122 2 ▶ $lang ||= $self->{lang} || 'en';
Condition60%3/5
$lang ||= $self->{"lang"} || "en"
l!l&&r!l&&!r
110
$self->{'lang'} || 'en'
l!l
01
MC/DC0%0/2
$lang ||= $self->{"lang"} || "en"
$lang $self->{'lang'}
Truth table33%1/3
A ||= B
A= $langB= $self->{'lang'}
ABresult
1X1
011
000
123 2 my $language = $self->_load_data($lang);
124  
125 2 return values %{ $language->[CODE]->[LOCALE_CODE_ALPHA_2] };
126 }
127  
128 26 ▶sub _load_data {
Subroutine _load_data: called CC=12 SCAR=25.3
129 26 my $self = shift;
130 26 my $lang = lc shift;
131  
132 26 my $languages = $self->languages;
133 26 my $language = $languages->{$lang};
134  
135 26 ▶ return $language if ref $language; # already set
Branch: 1 branch
BranchTrueFalseTotal
if ref $language 10 16 26
136  
137 16 ($lang, my $fh) = $self->_open_dat($lang);
138 binmode $fh, ':utf8'
139 16 ▶ if $self->use_io_layer or ref($self) and $self->{use_io_layer};
Branch: 1 branch
BranchTrueFalseTotal
if $self->use_io_layer or ref $self and $self->{"use_io_layer"} 1 15 16
Condition66%4/6
$self->use_io_layer or ref $self and $self->{"use_io_layer"}
l!l&&r!l&&!r
1015
ref $self and $self->{"use_io_layer"}
!ll&&!rl&&r
4110
MC/DC33%1/3
$self->use_io_layer or ref $self and $self->{"use_io_layer"}
$self->use_io_layer ref $self $self->{"use_io_layer"}
Truth table75%3/4
A or B and C
A= $self->use_io_layerB= ref $selfC= $self->{"use_io_layer"}
ABCresult
1XX1
0111
00X0
0100
140  
141 16 $language = $languages->{$lang} = [[], []];
142  
143 16 my $codes = $language->[CODE];
144 16 my $countries = $language->[COUNTRY];
145 16 ▶ while (my $line = <$fh>) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined(my $line = readline $fh)) 3978 16 3994
146 3978 chomp $line;
147 3978 my ($alpha2, $alpha3, $numeric, @countries) = split(/:/, $line);
148 3978 ▶ next unless ($alpha2);
Branch: 1 branch
BranchTrueFalseTotal
unless $alpha2 0 3978 3978
149 3978 $codes->[LOCALE_CODE_ALPHA_2]->{$alpha2} = $countries[0];
150 3978 ▶ $codes->[LOCALE_CODE_ALPHA_3]->{$alpha3} = $countries[0] if ($alpha3);
Branch: 1 branch
BranchTrueFalseTotal
if $alpha3 3978 0 3978
151 3978 ▶ $codes->[LOCALE_CODE_NUMERIC]->{$numeric + 0} = $countries[0] if ($numeric);
Branch: 1 branch
BranchTrueFalseTotal
if $numeric 3978 0 3978
152 3978 foreach my $country (@countries) {
153 4141 $countries->[LOCALE_CODE_ALPHA_2]->{"\L$country"} = $alpha2;
154 4141 ▶ $countries->[LOCALE_CODE_ALPHA_3]->{"\L$country"} = $alpha3 if ($alpha3);
Branch: 1 branch
BranchTrueFalseTotal
if $alpha3 4141 0 4141
155 4141 ▶ $countries->[LOCALE_CODE_NUMERIC]->{"\L$country"} = $numeric if ($numeric);
Branch: 1 branch
BranchTrueFalseTotal
if $numeric 4141 0 4141
156 }
157 }
158 16 close $fh; # be a nice kid
159  
160 16 return $language;
161 }
162  
163 16 ▶sub _open_dat {
Subroutine _open_dat: called CC=7 SCAR=20.5
164 16 my $self = shift;
165 16 ▶ my $filename = shift || '';
Condition50%1/2
shift() || ''
l!l
160
MC/DC0%0/1
shift() || ''
shift()
Truth table50%1/2
A
A= shift()
Aresult
11
00
166 16 my $fh = gensym; # required before Perl 5.6
167 16 my @errors;
168 my $lang; # stores the actual name used for loading
169  
170 # backwards compatibility
171 16 ▶ if ($filename eq 'cn') {
Branch: 2 branches
BranchTrueFalseTotal
if ($filename eq 'cn') { } 1 15 16
elsif ($filename eq 'tw') { } 0 15 15
172 1 $filename = 'zh'; # zh is simplified Han Chinese (hans)
173 }
174 elsif ($filename eq 'tw') {
175 0 $filename = 'zh-tw'; # zh-tw is traditional Han Chinese (hant)
176 }
177  
178 # be tolerant on language identifier format as long as language comes
179 # first, optionally followed by region:
180 # "en_GB", "en-gb", "EN -> GB" is all the same.
181 16 ▶ for (my @lang = split /[^A-Za-z]+/, $filename; @lang; pop @lang) {
Branch: 1 branch
BranchTrueFalseTotal
if (@lang) 18 0 18
182 18 $lang = join('-', @lang);
183 18 $filename = File::Spec->catfile($self->dir, "$lang.dat");
184 18 ▶ open $fh, $filename
Branch: 1 branch
BranchTrueFalseTotal
open $fh, $filename and return $lang, $fh or push @errors, "${filename}: $!" 0 2 2
Condition100%2/2
open $fh, $filename and return $lang, $fh
!ll
216
MC/DC100%1/1
open $fh, $filename and return $lang, $fh
open $fh, $filename
Truth table100%2/2
A
A= open $fh, $filename
Aresult
00
11
185 and return $lang => $fh
186 or push @errors, "$filename: $!";
187 }
188 # succeed or die
189 0 croak join(', ', @errors);
190 }
191  
192 6 1;
193  
194 =pod
195  
196 =encoding utf-8
197  
198 =head1 NAME
199  
200 Locale::Country::Multilingual - Map ISO codes to localized country names
201  
202 =head1 VERSION
203  
204 version 0.25
205  
206 =head1 SYNOPSIS
207  
208 use Locale::Country::Multilingual {use_io_layer => 1};
209  
210 my $lcm = Locale::Country::Multilingual->new();
211 my $country = $lcm->code2country('JP'); # $country gets 'Japan'
212 $country = $lcm->code2country('CHN'); # $country gets 'China'
213 $country = $lcm->code2country('250'); # $country gets 'France'
214 my $code = $lcm->country2code('Norway'); # $code gets 'NO'
215  
216 $lcm->set_lang('zh'); # set default language to Chinese
217 $country = $lcm->code2country('CN'); # $country gets '中国'
218 $code = $lcm->country2code('日本'); # $code gets 'JP'
219  
220 my @codes = $lcm->all_country_codes();
221 my @names = $lcm->all_country_names();
222  
223 # more heavy call
224 my $lang = 'en';
225 $country = $lcm->code2country('CN', $lang); # $country gets 'China'
226 $lang = 'zh';
227 $country = $lcm->code2country('CN', $lang); # $country gets '中国'
228  
229 my $CODE = 'LOCALE_CODE_ALPHA_2'; # by default
230 $code = $lcm->country2code('Norway', $CODE); # $code gets 'NO'
231 $CODE = 'LOCALE_CODE_ALPHA_3';
232 $code = $lcm->country2code('Norway', $CODE); # $code gets 'NOR'
233 $CODE = 'LOCALE_CODE_NUMERIC';
234 $code = $lcm->country2code('Norway', $CODE); # $code gets '578'
235 $code = $lcm->country2code('挪威', $CODE, 'zh'); # with lang=zh
236  
237 $CODE = 'LOCALE_CODE_ALPHA_3';
238 $lang = 'zh';
239 @codes = $lcm->all_country_codes($CODE); # return codes with 3alpha
240 @names = $lcm->all_country_names($lang); # get all Chinese Countries Names
241  
242 =head1 DESCRIPTION
243  
244 C<Locale::Country::Multilingual> is an OO replacement for
245 L<Locale::Country|Locale::Country>, and supports country names in several
246 languages.
247  
248 =head2 Language Codes
249  
250 A language is selected by a two-letter language code as described by
251 ISO 639-1 L<http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes>.
252 This code can be amended by a two-letter region code, that is described by
253 ISO 3166-1 L<http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2>.
254 This combination of language and region is also described in RFC 4646
255 L<http://www.ietf.org/rfc/rfc4646.txt> and RFC 4647
256 L<http://www.ietf.org/rfc/rfc4647.txt>, and is commonly used for
257 HTTP 1.1 L<http://www.ietf.org/rfc/rfc2616.txt> and the POSIX
258 L<setlocale(3)> function. Codes can be given in small or capital letters
259 and be divided by an arbitrary string of none-letter ASCII bytes (but
260 C<"-"> or C<"_"> is recommended).
261  
262 =head2 Language Selection Fallback
263  
264 In case a language code contains a region, language selection falls back to
265 the two-letter language code if no specific language file for the region
266 exists. Example: For C<"zh_CN"> selection will fall back to C<"zh"> since
267 there is no file F<"zh-cn.dat"> - actually C<"zh.dat"> happens to contain
268 the country names in Simplified (Han) Chinese.
269  
270 =head1 INCOMPATIBILITY NOTICE
271  
272 =head2 ISO Compliance
273  
274 C<ISO-3166> defines I<country> codes in upper case letters. C<ISO-639>
275 defines I<language> codes in lower case letters. This facilitates
276 differentiation between language and country codes.
277  
278 Beginning with release version 0.20 method L</country2code> returns country
279 codes in capital letters. On the input side all methods accept country and
280 language codes in any case for maximum convenience.
281  
282 This document uses upper case letters for country codes and lower case
283 letters for language codes.
284  
285 =head2 Unicode Support
286  
287 Unicode implementation before release 0.07 was broken. In fact it still is
288 for the benefit of downwards compatibility, but can be fixed by using the
289 C<use_io_layer> option. If you use this module without C<use_io_layer>,
290 then your code is broken.
291  
292 Beginning with release 0.30 C<use_io_layer> will be enabled by default.
293  
294 Beginning with release 0.40 C<use_io_layer> will be removed.
295  
296 =head2 Deprecated Languages
297  
298 Releases before 0.09 of this module offered languages C<"cn"> and C<"tw">.
299 Those were replaced by C<"zh"> and C<"zh-tw"> to comply with the ISO 639
300 standard and RFC 2616. C<"cn"> and C<"tw"> are still supported, but will be
301 removed in a near future - probably in release 0.30.
302  
303 =head1 METHODS
304  
305 =head2 import
306  
307 use Locale::Country::Multilingual 'en', 'fr', {use_io_layer => 1};
308  
309 The C<import> class method is called when a module is C<use>'d.
310 Language files can be pre-loaded at compile time, by specifying their
311 language codes. This can be useful when several processes are forked
312 from the main application, e.g. in an Apache C<mod_perl> environment -
313 language data that is loaded before forking is shared by all processes and
314 thus saving memory.
315  
316 The last argument can be a reference to a hash of options.
317  
318 The only option ATM is C<use_io_layer> and works for Perl 5.8 and higher. See
319 L<Locale::Country::Multilingual::Unicode|Locale::Country::Multilingual::Unicode>
320 for more information.
321  
322 =head2 new
323  
324 $lcm = Locale::Country::Multilingual->new;
325 $lcm = Locale::Country::Multilingual->new(
326 lang => 'es',
327 use_io_layer => 1,
328 );
329  
330 Constructor method. Accepts optional list of named arguments:
331  
332 =over 4
333  
334 =item lang
335  
336 The language to use. See L</AVAILABLE LANGAUGES> for what codes are
337 accepted.
338  
339 =item use_io_layer
340  
341 Set this C<true> if you need correct encoding behavior. See
342 L<Locale::Country::Multilingual::Unicode|Locale::Country::Multilingual::Unicode>
343 for more information.
344  
345 =back
346  
347 =head2 set_lang
348  
349 $lcm->set_lang('de');
350  
351 Set the current language. Only argument is a language code as described in
352 the L</DESCRIPTION> above.
353  
354 See L</AVAILABLE LANGAUGES> for what codes are accepted.
355  
356 This method does not actually load the language data. Use L</assert_lang>
357 if you really need to know for sure if a language is supported.
358  
359 =head2 assert_lang
360  
361 $lang = $lcm->assert_lang('es', 'it', 'fr');
362  
363 Tries to load any of the given languages. Returns the language code for
364 the first language that was successfully loaded. Returns C<undef> if none
365 of the given languages could be loaded. Actually loads the language data,
366 but does not L<set the language|/set_lang>, so you probably want to use it
367 this way:
368  
369 $lang = $lcm->assert_lang(qw/es it fr en/)
370 and $lcm->set_lang($lang)
371 or die "unable to load any language\n";
372  
373 =head2 code2country
374  
375 $country = $lcm->code2country('GB');
376 $country = $lcm->code2country('GB', 'zh');
377  
378 Turns an ISO 3166-1 code into a country name in the current language.
379 The default language is C<"en">.
380  
381 Accepts either two-letter or a three-letter code or a 3 digit numerical code.
382  
383 A language might be given as second argument to set the output language only
384 for this call - it does not change the current language, that was set with
385 L</set_lang>.
386  
387 Returns the country name.
388  
389 This method L<croaks|Carp> if the language is not available.
390  
391 =head2 country2code
392  
393 $code = $lcm->country2code(
394 'République tchèque', 'LOCALE_CODE_ALPHA_2', 'fr'
395 );
396  
397 Take a country name and return the two-letter code when available.
398 Aside from being case-insensitive the country must be written exactly the
399 way how L</code2country> returns it.
400  
401 The second argument is optional and can be one of C<"LOCALE_CODE_ALPHA_2">,
402 C<"LOCALE_CODE_ALPHA_3"> and C<"LOCALE_CODE_NUMERIC">. The default is
403 C<"LOCALE_CODE_ALPHA2">.
404  
405 The third argument is the language to use for the country name and is
406 optional too.
407  
408 Returns an ISO-3166 code or C<undef> if search fails.
409  
410 This method L<croaks|Carp> if the language is not available.
411  
412 =head2 all_country_codes
413  
414 @countrycodes = $lcm->all_country_codes;
415 @countrycodes = $lcm->all_country_codes($codeset);
416  
417 Returns an unsorted list of all ISO-3166 codes.
418  
419 The argument is optional and can be one of C<"LOCALE_CODE_ALPHA_2">,
420 C<"LOCALE_CODE_ALPHA_3"> and C<"LOCALE_CODE_NUMERIC">. The default is
421 C<"LOCALE_CODE_ALPHA2">.
422  
423 =head2 all_country_names
424  
425 @countrynames = $lcm->all_country_names;
426 @countrynames = $lcm->all_country_names('fr');
427  
428 Returns an unsorted list of country names in the current or given locale.
429  
430 =head1 AVAILABLE LANGAUGES
431  
432 =over 4
433  
434 =item en English
435  
436 =item bg Bulgarian
437  
438 =item bn Bengali
439  
440 =item ca Catalan
441  
442 =item cs Czech
443  
444 =item cy Welsh
445  
446 =item da Danish
447  
448 =item de German
449  
450 =item dz Dzongkha
451  
452 =item el Greek
453  
454 =item eo Esperanto
455  
456 =item es Spanish
457  
458 =item et Estonian
459  
460 =item eu Basque
461  
462 =item fa Persian
463  
464 =item fi Finnish
465  
466 =item fo Faroese
467  
468 =item fr French
469  
470 =item ga Irish
471  
472 =item gl Galician
473  
474 =item gu Gujarati
475  
476 =item he Hebrew
477  
478 =item hi Hindi
479  
480 =item hr Croatian
481  
482 =item hu Hungarian
483  
484 =item hy Armenian
485  
486 =item id Indonesian
487  
488 =item ii Sichuan Yi
489  
490 =item is Icelandic
491  
492 =item it Italian
493  
494 =item ja Japanese
495  
496 =item ka Georgian
497  
498 =item km Central Khmer
499  
500 =item kn Kannada
501  
502 =item ko Korean
503  
504 =item ln Lingala
505  
506 =item lo Lao
507  
508 =item lt Lithuanian
509  
510 =item lv Latvian
511  
512 =item mk Macedonian
513  
514 =item ml Malayalam
515  
516 =item mn Mongolian
517  
518 =item ms Malay
519  
520 =item mt Maltese
521  
522 =item my Burmese
523  
524 =item nb Norwegian Bokmål
525  
526 =item ne Nepali
527  
528 =item nl Dutch
529  
530 =item nn Norwegian Nynorsk
531  
532 =item no Norwegian
533  
534 =item pl Polish
535  
536 =item ps Pushto
537  
538 =item pt Portuguese
539  
540 =item ro Romanian
541  
542 =item ru Russian
543  
544 =item se Northern Sami
545  
546 =item sk Slovak
547  
548 =item sl Slovenian
549  
550 =item so Somali
551  
552 =item sq Albanian
553  
554 =item sr Serbian
555  
556 =item sv Swedish
557  
558 =item sw Swahili
559  
560 =item ta Tamil
561  
562 =item te Telugu
563  
564 =item th Thai
565  
566 =item to Tonga
567  
568 =item tr Turkish
569  
570 =item uk Ukrainian
571  
572 =item ur Urdu
573  
574 =item uz Uzbek
575  
576 =item vi Vietnamese
577  
578 =item zh (zh-cn) Chinese Simp.
579  
580 =item zh-tw Chinese Trad.
581  
582 =back
583  
584 Language files are more or less (in-)complete and fall back to English.
585 Corrections, additions and more languages are highly appreciated.
586  
587 =head1 SUPPORTS
588  
589 =over 4
590  
591 =item GitHub
592  
593 L<https://github.com/maxmind/Locale-Country-Multilingual>
594  
595 =back
596  
597 =head1 SEE ALSO
598  
599 L<Locale::Country|Locale::Country>,
600 ISO 639 L<http://en.wikipedia.org/wiki/ISO_639>,
601 ISO 3166 L<http://en.wikipedia.org/wiki/ISO_3166>,
602 RFC 2616 L<http://www.ietf.org/rfc/rfc2616.txt>
603 RFC 4646 L<http://www.ietf.org/rfc/rfc4646.txt>,
604 RFC 4647 L<http://www.ietf.org/rfc/rfc4647.txt>,
605 Unicode CLDR Project L<http://unicode.org/cldr/>
606  
607 =head1 ACKNOWLEDGEMENTS
608  
609 Thanks to michele ongaro for Italian/Spanish/Portuguese/German/French/Japanese dat files.
610  
611 Thanks to Andreas Marienborg for Norwegian dat file.
612  
613 Thanks to all contributors of the Unicode CLDR Project.
614  
615 =head1 CLDR LICENSE
616  
617 Part of the data used for this module is generated from data provided by
618 the CLDR project. See the LICENSE.cldr in this distribution for details
619 on the CLDR data's license.
620  
621 =head1 AUTHORS
622  
623 =over 4
624  
625 =item *
626  
627 Bernhard Graf <graf@cpan.org>
628  
629 =item *
630  
631 Fayland Lam <fayland@gmail.com>
632  
633 =item *
634  
635 Greg Oschwald <oschwald@cpan.org>
636  
637 =back
638  
639 =head1 COPYRIGHT AND LICENSE
640  
641 This software is copyright (c) 2014 by Fayland Lam.
642  
643 This is free software; you can redistribute it and/or modify it under
644 the same terms as the Perl 5 programming language system itself.
645  
646 =cut
647  
648 __END__
↑ Summary