~ubuntu-branches/ubuntu/intrepid/perl-doc-html/intrepid

<div id="breadCrumbs"><a href="../index.html">Home</a> > <a href="../index-modules-A.html">Core modules</a> > <a href="../index-modules-L.html">L</a> > Locale::Script</div>

<div id="contentBody"><div class="title_container"><div class="page_title">Locale::Script</div></div><ul><li><a href="#SYNOPSIS">SYNOPSIS</a><li><a href="#DESCRIPTION">DESCRIPTION</a><ul><li><a href="#SPECIAL-CODES">SPECIAL CODES</a></ul><li><a href="#CONVERSION-ROUTINES">CONVERSION ROUTINES</a><li><a href="#QUERY-ROUTINES">QUERY ROUTINES</a><li><a href="#EXAMPLES">EXAMPLES</a><li><a href="#KNOWN-BUGS-AND-LIMITATIONS">KNOWN BUGS AND LIMITATIONS</a><li><a href="#SEE-ALSO">SEE ALSO</a><li><a href="#AUTHOR">AUTHOR</a><li><a href="#COPYRIGHT">COPYRIGHT</a></ul><a name="SYNOPSIS"></a><h1>SYNOPSIS</h1>

<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> <a class="l_w" href="../Locale/Script.html">Locale::Script</a>;

<a class="l_k" href="../functions/use.html">use</a> <a class="l_w" href="../Locale/Constants.html">Locale::Constants</a>;

$script = code2script('ph'); # 'Phoenician'

<pre class="verbatim"> <a class="l_k" href="../functions/use.html">use</a> Locale::Script;

<a class="l_k" href="../functions/use.html">use</a> Locale::Constants;</pre>

<pre class="verbatim"> $script = code2script('ph'); # 'Phoenician'

$code = script2code('Tibetan'); # 'bo'

$code3 = script2code('Tibetan',

LOCALE_CODE_ALPHA_3); # 'bod'

LOCALE_CODE_ALPHA_3); # 'bod'

$codeN = script2code('Tibetan',

LOCALE_CODE_ALPHA_NUMERIC); # 330

@codes = all_script_codes();

@scripts = all_script_names();

</pre>

LOCALE_CODE_ALPHA_NUMERIC); # 330</pre>

<pre class="verbatim"> @codes = all_script_codes();

@scripts = all_script_names();</pre>

<a name="DESCRIPTION"></a><h1>DESCRIPTION</h1>

The <code class="inline"><a class="l_w" href="../Locale/Script.html">Locale::Script</a></code> module provides access to the ISO

The <code class="inline">Locale::Script</code>

100

module provides access to the ISO

100

101

codes for identifying scripts, as defined in ISO 15924.

101

102

For example, Egyptian hieroglyphs are denoted by the two-letter

102

103

code 'eg', the three-letter code 'egy', and the numeric code 050.

108

109

<ul>

109

110

<li><a name="*alpha-2*"></a>alpha-2

110

111

Two letter codes, such as 'bo' for Tibetan.

111

This code set is identified with the symbol <code class="inline">LOCALE_CODE_ALPHA_2</code>

112

This code set is identified with the symbol <code class="inline">LOCALE_CODE_ALPHA_2</code>

112

113

.

113

114

</li>

114

115

<li><a name="*alpha-3*"></a>alpha-3

115

116

Three letter codes, such as 'ell' for Greek.

116

This code set is identified with the symbol <code class="inline">LOCALE_CODE_ALPHA_3</code>

117

This code set is identified with the symbol <code class="inline">LOCALE_CODE_ALPHA_3</code>

117

118

.

118

119

</li>

119

120

<li><a name="*numeric*"></a>numeric

120

121

Numeric codes, such as 410 for Hiragana.

121

This code set is identified with the symbol <code class="inline">LOCALE_CODE_NUMERIC</code>

122

This code set is identified with the symbol <code class="inline">LOCALE_CODE_NUMERIC</code>

122

123

.

123

124

</li>

124

125

</ul>

170

171

script code, if such exists.

171

172

If the argument could not be identified as a script name,

172

173

then <code class="inline"><a class="l_k" href="../functions/undef.html">undef</a></code> will be returned:

173

<pre class="verbatim"> $code = script2code('Gothic', LOCALE_CODE_ALPHA_3);

174

<pre class="verbatim"> $code = script2code('Gothic', LOCALE_CODE_ALPHA_3);

174

175

# $code will now be 'gth'</pre>

175

176

The case of the script name is not important.

176

177

See the section <a href="#KNOWN-BUGS-AND-LIMITATIONS">"KNOWN BUGS AND LIMITATIONS"</a> below.

179

180

This function takes a script code from one code set,

180

181

and returns the corresponding code from another code set.

181

182

<pre class="verbatim"> $alpha2 = script_code2code('jwi',

182

LOCALE_CODE_ALPHA_3 => LOCALE_CODE_ALPHA_2);

183

LOCALE_CODE_ALPHA_3 => LOCALE_CODE_ALPHA_2);

183

184

# $alpha2 will now be 'jw' (Javanese)</pre>

184

185

If the code passed is not a valid script code in

185

186

the first code set, or if there isn't a code for the

191

192

There are two function which can be used to obtain a list of all codes,

192

193

or all script names:

193

194

<ul>

194

<li><a name="'all_script_codes-(-%5b-CODESET-%5d-)'"></a><code class="inline">all_script_codes ( [ CODESET ] )</code>

195

<li><a name="'all_script_codes-(-%5b-CODESET-%5d-)'"></a><code class="inline">all_script_codes ( [ CODESET ] )</code>

195

196

196

197

Returns a list of all two-letter script codes.

197

198

The codes are guaranteed to be all lower-case,

198

199

and not in any particular order.

199

200

</li>

200

<li><a name="'all_script_names-(-%5b-CODESET-%5d-)'"></a><code class="inline">all_script_names ( [ CODESET ] )</code>

201

<li><a name="'all_script_names-(-%5b-CODESET-%5d-)'"></a><code class="inline">all_script_names ( [ CODESET ] )</code>

201

202

202

203

Returns a list of all script names for which there is a corresponding

203

204

script code in the specified code set.

209

210

function.

210

211

The user is prompted for a script code, and then told the corresponding

211

212

script name:

212

<pre class="verbatim"> $| = 1; # turn off buffering

213

214

<a class="l_k" href="../functions/print.html">print</a> "Enter script code: ";

213

<pre class="verbatim"> $| = 1; # turn off buffering</pre>

214

<pre class="verbatim"> <a class="l_k" href="../functions/print.html">print</a> "Enter script code: ";

215

<a class="l_k" href="../functions/chop.html">chop</a>($code = <STDIN>);

216

$script = code2script($code, LOCALE_CODE_ALPHA_2);

216

$script = code2script($code, LOCALE_CODE_ALPHA_2);

217

if (<a class="l_k" href="../functions/defined.html">defined</a> $script)

218

{

219

<a class="l_k" href="../functions/print.html">print</a> "$code = $script\n";

282

283

</form>

284

285

285

286

<h2>Labels:</h2>

286

287

287

288

Older »