lib/Locale/Script.pm

   1 #
   2 # Locale::Script - ISO codes for script identification (ISO 15924)
   3 #
   4 # $Id: Script.pm,v 2.1 2002/02/06 04:07:10 neilb Exp $
   5 #
   6
   7 package Locale::Script;
   8 use strict;
   9 require 5.002;
  10
  11 require Exporter;
  12 use Carp;
  13 use Locale::Constants;
  14
  15
  16 #-----------------------------------------------------------------------
  17 #       Public Global Variables
  18 #-----------------------------------------------------------------------
  19 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK);
  20 $VERSION   = sprintf("%d.%02d", q$Revision: 2.1 $ =~ /(\d+)\.(\d+)/);
  21 @ISA       = qw(Exporter);
  22 @EXPORT    = qw(code2script script2code
  23                 all_script_codes all_script_names
  24                 script_code2code
  25                 LOCALE_CODE_ALPHA_2 LOCALE_CODE_ALPHA_3 LOCALE_CODE_NUMERIC);
  26
  27 #-----------------------------------------------------------------------
  28 #       Private Global Variables
  29 #-----------------------------------------------------------------------
  30 my $CODES     = [];
  31 my $COUNTRIES = [];
  32
  33
  34 #=======================================================================
  35 #
  36 # code2script ( CODE [, CODESET ] )
  37 #
  38 #=======================================================================
  39 sub code2script
  40 {
  41     my $code = shift;
  42     my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
  43
  44
  45     return undef unless defined $code;
  46
  47     #-------------------------------------------------------------------
  48     # Make sure the code is in the right form before we use it
  49     # to look up the corresponding script.
  50     # We have to sprintf because the codes are given as 3-digits,
  51     # with leading 0's. Eg 070 for Egyptian demotic.
  52     #-------------------------------------------------------------------
  53     if ($codeset == LOCALE_CODE_NUMERIC)
  54     {
  55         return undef if ($code =~ /\D/);
  56         $code = sprintf("%.3d", $code);
  57     }
  58     else
  59     {
  60         $code = lc($code);
  61     }
  62
  63     if (exists $CODES->[$codeset]->{$code})
  64     {
  65         return $CODES->[$codeset]->{$code};
  66     }
  67     else
  68     {
  69         #---------------------------------------------------------------
  70         # no such script code!
  71         #---------------------------------------------------------------
  72         return undef;
  73     }
  74 }
  75
  76
  77 #=======================================================================
  78 #
  79 # script2code ( SCRIPT [, CODESET ] )
  80 #
  81 #=======================================================================
  82 sub script2code
  83 {
  84     my $script = shift;
  85     my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
  86
  87
  88     return undef unless defined $script;
  89     $script = lc($script);
  90     if (exists $COUNTRIES->[$codeset]->{$script})
  91     {
  92         return $COUNTRIES->[$codeset]->{$script};
  93     }
  94     else
  95     {
  96         #---------------------------------------------------------------
  97         # no such script!
  98         #---------------------------------------------------------------
  99         return undef;
 100     }
 101 }
 102
 103
 104 #=======================================================================
 105 #
 106 # script_code2code ( CODE, IN-CODESET, OUT-CODESET )
 107 #
 108 #=======================================================================
 109 sub script_code2code
 110 {
 111     (@_ == 3) or croak "script_code2code() takes 3 arguments!";
 112
 113     my $code = shift;
 114     my $inset = shift;
 115     my $outset = shift;
 116     my $outcode;
 117     my $script;
 118
 119
 120     return undef if $inset == $outset;
 121     $script = code2script($code, $inset);
 122     return undef if not defined $script;
 123     $outcode = script2code($script, $outset);
 124     return $outcode;
 125 }
 126
 127
 128 #=======================================================================
 129 #
 130 # all_script_codes()
 131 #
 132 #=======================================================================
 133 sub all_script_codes
 134 {
 135     my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
 136
 137     return keys %{ $CODES->[$codeset] };
 138 }
 139
 140
 141 #=======================================================================
 142 #
 143 # all_script_names()
 144 #
 145 #=======================================================================
 146 sub all_script_names
 147 {
 148     my $codeset = @_ > 0 ? shift : LOCALE_CODE_DEFAULT;
 149
 150     return values %{ $CODES->[$codeset] };
 151 }
 152
 153
 154 #=======================================================================
 155 #
 156 # initialisation code - stuff the DATA into the ALPHA2 hash
 157 #
 158 #=======================================================================
 159 {
 160     my ($alpha2, $alpha3, $numeric);
 161     my $script;
 162
 163
 164     while (<DATA>)
 165     {
 166         next unless /\S/;
 167         chop;
 168         ($alpha2, $alpha3, $numeric, $script) = split(/:/, $_, 4);
 169
 170         $CODES->[LOCALE_CODE_ALPHA_2]->{$alpha2} = $script;
 171         $COUNTRIES->[LOCALE_CODE_ALPHA_2]->{"\L$script"} = $alpha2;
 172
 173         if ($alpha3)
 174         {
 175             $CODES->[LOCALE_CODE_ALPHA_3]->{$alpha3} = $script;
 176             $COUNTRIES->[LOCALE_CODE_ALPHA_3]->{"\L$script"} = $alpha3;
 177         }
 178
 179         if ($numeric)
 180         {
 181             $CODES->[LOCALE_CODE_NUMERIC]->{$numeric} = $script;
 182             $COUNTRIES->[LOCALE_CODE_NUMERIC]->{"\L$script"} = $numeric;
 183         }
 184
 185     }
 186 }
 187
 188 1;
 189
 190 __DATA__
 191 am:ama:130:Aramaic
 192 ar:ara:160:Arabic
 193 av:ave:151:Avestan
 194 bh:bhm:300:Brahmi (Ashoka)
 195 bi:bid:372:Buhid
 196 bn:ben:325:Bengali
 197 bo:bod:330:Tibetan
 198 bp:bpm:285:Bopomofo
 199 br:brl:570:Braille
 200 bt:btk:365:Batak
 201 bu:bug:367:Buginese (Makassar)
 202 by:bys:550:Blissymbols
 203 ca:cam:358:Cham
 204 ch:chu:221:Old Church Slavonic
 205 ci:cir:291:Cirth
 206 cm:cmn:402:Cypro-Minoan
 207 co:cop:205:Coptic
 208 cp:cpr:403:Cypriote syllabary
 209 cy:cyr:220:Cyrillic
 210 ds:dsr:250:Deserel (Mormon)
 211 dv:dvn:315:Devanagari (Nagari)
 212 ed:egd:070:Egyptian demotic
 213 eg:egy:050:Egyptian hieroglyphs
 214 eh:egh:060:Egyptian hieratic
 215 el:ell:200:Greek
 216 eo:eos:210:Etruscan and Oscan
 217 et:eth:430:Ethiopic
 218 gl:glg:225:Glagolitic
 219 gm:gmu:310:Gurmukhi
 220 gt:gth:206:Gothic
 221 gu:guj:320:Gujarati
 222 ha:han:500:Han ideographs
 223 he:heb:125:Hebrew
 224 hg:hgl:420:Hangul
 225 hm:hmo:450:Pahawh Hmong
 226 ho:hoo:371:Hanunoo
 227 hr:hrg:410:Hiragana
 228 hu:hun:176:Old Hungarian runic
 229 hv:hvn:175:Kok Turki runic
 230 hy:hye:230:Armenian
 231 iv:ivl:610:Indus Valley
 232 ja:jap:930:(alias for Han + Hiragana + Katakana)
 233 jl:jlg:445:Cherokee syllabary
 234 jw:jwi:360:Javanese
 235 ka:kam:241:Georgian (Mxedruli)
 236 kh:khn:931:(alias for Hangul + Han)
 237 kk:kkn:411:Katakana
 238 km:khm:354:Khmer
 239 kn:kan:345:Kannada
 240 kr:krn:357:Karenni (Kayah Li)
 241 ks:kst:305:Kharoshthi
 242 kx:kax:240:Georgian (Xucuri)
 243 la:lat:217:Latin
 244 lf:laf:215:Latin (Fraktur variant)
 245 lg:lag:216:Latin (Gaelic variant)
 246 lo:lao:356:Lao
 247 lp:lpc:335:Lepcha (Rong)
 248 md:mda:140:Mandaean
 249 me:mer:100:Meroitic
 250 mh:may:090:Mayan hieroglyphs
 251 ml:mlm:347:Malayalam
 252 mn:mon:145:Mongolian
 253 my:mya:350:Burmese
 254 na:naa:400:Linear A
 255 nb:nbb:401:Linear B
 256 og:ogm:212:Ogham
 257 or:ory:327:Oriya
 258 os:osm:260:Osmanya
 259 ph:phx:115:Phoenician
 260 ph:pah:150:Pahlavi
 261 pl:pld:282:Pollard Phonetic
 262 pq:pqd:295:Klingon plQaD
 263 pr:prm:227:Old Permic
 264 ps:pst:600:Phaistos Disk
 265 rn:rnr:211:Runic (Germanic)
 266 rr:rro:620:Rongo-rongo
 267 sa:sar:110:South Arabian
 268 si:sin:348:Sinhala
 269 sj:syj:137:Syriac (Jacobite variant)
 270 sl:slb:440:Unified Canadian Aboriginal Syllabics
 271 sn:syn:136:Syriac (Nestorian variant)
 272 sw:sww:281:Shavian (Shaw)
 273 sy:syr:135:Syriac (Estrangelo)
 274 ta:tam:346:Tamil
 275 tb:tbw:373:Tagbanwa
 276 te:tel:340:Telugu
 277 tf:tfn:120:Tifnagh
 278 tg:tag:370:Tagalog
 279 th:tha:352:Thai
 280 tn:tna:170:Thaana
 281 tw:twr:290:Tengwar
 282 va:vai:470:Vai
 283 vs:vsp:280:Visible Speech
 284 xa:xas:000:Cuneiform, Sumero-Akkadian
 285 xf:xfa:105:Cuneiform, Old Persian
 286 xk:xkn:412:(alias for Hiragana + Katakana)
 287 xu:xug:106:Cuneiform, Ugaritic
 288 yi:yii:460:Yi
 289 zx:zxx:997:Unwritten language
 290 zy:zyy:998:Undetermined script
 291 zz:zzz:999:Uncoded script