1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>Language Utilities</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
<link rel="home" href="index.html" title="GNOME Desktop Library Reference Manual">
8
<link rel="up" href="languages.html" title="Part VIII. Language Utilities">
9
<link rel="prev" href="languages.html" title="Part VIII. Language Utilities">
10
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
11
<link rel="stylesheet" href="style.css" type="text/css">
13
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
14
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
<td><a accesskey="p" href="languages.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
17
<td><a accesskey="u" href="languages.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
18
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
19
<th width="100%" align="center">GNOME Desktop Library Reference Manual</th>
22
<tr><td colspan="5" class="shortcuts">
23
<a href="#gnome-desktop3-Language-Utilities.synopsis" class="shortcut">Top</a>
25
<a href="#gnome-desktop3-Language-Utilities.description" class="shortcut">Description</a>
28
<div class="refentry">
29
<a name="gnome-desktop3-Language-Utilities"></a><div class="titlepage"></div>
30
<div class="refnamediv"><table width="100%"><tr>
32
<h2><span class="refentrytitle"><a name="gnome-desktop3-Language-Utilities.top_of_page"></a>Language Utilities</span></h2>
33
<p>Language Utilities</p>
35
<td valign="top" align="right"></td>
37
<div class="refsynopsisdiv">
38
<a name="gnome-desktop3-Language-Utilities.synopsis"></a><h2>Synopsis</h2>
39
<pre class="synopsis"><span class="returnvalue">char</span> ** <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-get-all-locales" title="gnome_get_all_locales ()">gnome_get_all_locales</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
40
<span class="returnvalue">char</span> * <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-get-country-from-code" title="gnome_get_country_from_code ()">gnome_get_country_from_code</a> (<em class="parameter"><code>const <span class="type">char</span> *code</code></em>,
41
<em class="parameter"><code>const <span class="type">char</span> *translation</code></em>);
42
<span class="returnvalue">char</span> * <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-get-country-from-locale" title="gnome_get_country_from_locale ()">gnome_get_country_from_locale</a> (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>,
43
<em class="parameter"><code>const <span class="type">char</span> *translation</code></em>);
44
<span class="returnvalue">gboolean</span> <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-get-input-source-from-locale" title="gnome_get_input_source_from_locale ()">gnome_get_input_source_from_locale</a> (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>,
45
<em class="parameter"><code>const <span class="type">char</span> **type</code></em>,
46
<em class="parameter"><code>const <span class="type">char</span> **id</code></em>);
47
<span class="returnvalue">char</span> * <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-get-language-from-code" title="gnome_get_language_from_code ()">gnome_get_language_from_code</a> (<em class="parameter"><code>const <span class="type">char</span> *code</code></em>,
48
<em class="parameter"><code>const <span class="type">char</span> *translation</code></em>);
49
<span class="returnvalue">char</span> * <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-get-language-from-locale" title="gnome_get_language_from_locale ()">gnome_get_language_from_locale</a> (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>,
50
<em class="parameter"><code>const <span class="type">char</span> *translation</code></em>);
51
<span class="returnvalue">char</span> * <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-normalize-locale" title="gnome_normalize_locale ()">gnome_normalize_locale</a> (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>);
52
<span class="returnvalue">gboolean</span> <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-parse-locale" title="gnome_parse_locale ()">gnome_parse_locale</a> (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>,
53
<em class="parameter"><code><span class="type">char</span> **language_codep</code></em>,
54
<em class="parameter"><code><span class="type">char</span> **country_codep</code></em>,
55
<em class="parameter"><code><span class="type">char</span> **codesetp</code></em>,
56
<em class="parameter"><code><span class="type">char</span> **modifierp</code></em>);
57
<span class="returnvalue">gboolean</span> <a class="link" href="gnome-desktop3-Language-Utilities.html#gnome-language-has-translations" title="gnome_language_has_translations ()">gnome_language_has_translations</a> (<em class="parameter"><code>const <span class="type">char</span> *code</code></em>);
60
<div class="refsect1">
61
<a name="gnome-desktop3-Language-Utilities.description"></a><h2>Description</h2>
65
<div class="refsect1">
66
<a name="gnome-desktop3-Language-Utilities.details"></a><h2>Details</h2>
67
<div class="refsect2">
68
<a name="gnome-get-all-locales"></a><h3>gnome_get_all_locales ()</h3>
69
<pre class="programlisting"><span class="returnvalue">char</span> ** gnome_get_all_locales (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
73
<div class="variablelist"><table border="0" class="variablelist">
75
<col align="left" valign="top">
79
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
80
<td>a newly allocated <code class="literal">NULL</code>-terminated string array containing the
81
all locales. Free with <code class="function">g_strfreev()</code>. <span class="annotation">[<a href="http://foldoc.org/array"><span class="acronym">array</span></a> zero-terminated=1][<a href="http://foldoc.org/element-type"><span class="acronym">element-type</span></a> utf8][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
85
<p class="since">Since 3.8</p>
88
<div class="refsect2">
89
<a name="gnome-get-country-from-code"></a><h3>gnome_get_country_from_code ()</h3>
90
<pre class="programlisting"><span class="returnvalue">char</span> * gnome_get_country_from_code (<em class="parameter"><code>const <span class="type">char</span> *code</code></em>,
91
<em class="parameter"><code>const <span class="type">char</span> *translation</code></em>);</pre>
93
Gets the country name for <em class="parameter"><code>code</code></em>. If <em class="parameter"><code>locale</code></em> is provided the
94
returned string is translated accordingly.
96
<div class="variablelist"><table border="0" class="variablelist">
98
<col align="left" valign="top">
103
<td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
104
<td>an ISO 3166 code string</td>
107
<td><p><span class="term"><em class="parameter"><code>translation</code></em> :</span></p></td>
108
<td>a locale string. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
112
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
113
<td>the country name. Caller takes
114
ownership. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
119
<p class="since">Since 3.8</p>
122
<div class="refsect2">
123
<a name="gnome-get-country-from-locale"></a><h3>gnome_get_country_from_locale ()</h3>
124
<pre class="programlisting"><span class="returnvalue">char</span> * gnome_get_country_from_locale (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>,
125
<em class="parameter"><code>const <span class="type">char</span> *translation</code></em>);</pre>
127
Gets the country description for <em class="parameter"><code>locale</code></em>. If <em class="parameter"><code>translation</code></em> is
128
provided the returned string is translated accordingly.
130
<div class="variablelist"><table border="0" class="variablelist">
132
<col align="left" valign="top">
137
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
138
<td>a locale string</td>
141
<td><p><span class="term"><em class="parameter"><code>translation</code></em> :</span></p></td>
142
<td>a locale string. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
146
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
147
<td>the country description. Caller
148
takes ownership. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
153
<p class="since">Since 3.8</p>
156
<div class="refsect2">
157
<a name="gnome-get-input-source-from-locale"></a><h3>gnome_get_input_source_from_locale ()</h3>
158
<pre class="programlisting"><span class="returnvalue">gboolean</span> gnome_get_input_source_from_locale (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>,
159
<em class="parameter"><code>const <span class="type">char</span> **type</code></em>,
160
<em class="parameter"><code>const <span class="type">char</span> **id</code></em>);</pre>
162
Gets the default input source's type and identifier for a given
165
<div class="variablelist"><table border="0" class="variablelist">
167
<col align="left" valign="top">
172
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
173
<td>a locale string</td>
176
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
177
<td>location to store the input source
178
type. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>][<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span>
182
<td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
183
<td>location to store the input source
184
identifier. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>][<a href="http://foldoc.org/transfer%20none"><span class="acronym">transfer none</span></a>]</span>
188
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
190
<code class="literal">TRUE</code> if a input source exists or <code class="literal">FALSE</code> otherwise.</td>
194
<p class="since">Since 3.8</p>
197
<div class="refsect2">
198
<a name="gnome-get-language-from-code"></a><h3>gnome_get_language_from_code ()</h3>
199
<pre class="programlisting"><span class="returnvalue">char</span> * gnome_get_language_from_code (<em class="parameter"><code>const <span class="type">char</span> *code</code></em>,
200
<em class="parameter"><code>const <span class="type">char</span> *translation</code></em>);</pre>
202
Gets the language name for <em class="parameter"><code>code</code></em>. If <em class="parameter"><code>locale</code></em> is provided the
203
returned string is translated accordingly.
205
<div class="variablelist"><table border="0" class="variablelist">
207
<col align="left" valign="top">
212
<td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
213
<td>an ISO 639 code string</td>
216
<td><p><span class="term"><em class="parameter"><code>translation</code></em> :</span></p></td>
217
<td>a locale string. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
221
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
222
<td>the language name. Caller takes
223
ownership. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
228
<p class="since">Since 3.8</p>
231
<div class="refsect2">
232
<a name="gnome-get-language-from-locale"></a><h3>gnome_get_language_from_locale ()</h3>
233
<pre class="programlisting"><span class="returnvalue">char</span> * gnome_get_language_from_locale (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>,
234
<em class="parameter"><code>const <span class="type">char</span> *translation</code></em>);</pre>
236
Gets the language description for <em class="parameter"><code>locale</code></em>. If <em class="parameter"><code>translation</code></em> is
237
provided the returned string is translated accordingly.
239
<div class="variablelist"><table border="0" class="variablelist">
241
<col align="left" valign="top">
246
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
247
<td>a locale string</td>
250
<td><p><span class="term"><em class="parameter"><code>translation</code></em> :</span></p></td>
251
<td>a locale string. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
255
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
256
<td>the language description. Caller
257
takes ownership. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
262
<p class="since">Since 3.8</p>
265
<div class="refsect2">
266
<a name="gnome-normalize-locale"></a><h3>gnome_normalize_locale ()</h3>
267
<pre class="programlisting"><span class="returnvalue">char</span> * gnome_normalize_locale (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>);</pre>
269
Gets the normalized locale string in the form
270
[language[_country][.codeset][<em class="parameter"><code>modifier</code></em>]] for <em class="parameter"><code>name</code></em>.
272
<div class="variablelist"><table border="0" class="variablelist">
274
<col align="left" valign="top">
279
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
280
<td>a locale string</td>
283
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
284
<td>normalized locale string. Caller
285
takes ownership. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
290
<p class="since">Since 3.8</p>
293
<div class="refsect2">
294
<a name="gnome-parse-locale"></a><h3>gnome_parse_locale ()</h3>
295
<pre class="programlisting"><span class="returnvalue">gboolean</span> gnome_parse_locale (<em class="parameter"><code>const <span class="type">char</span> *locale</code></em>,
296
<em class="parameter"><code><span class="type">char</span> **language_codep</code></em>,
297
<em class="parameter"><code><span class="type">char</span> **country_codep</code></em>,
298
<em class="parameter"><code><span class="type">char</span> **codesetp</code></em>,
299
<em class="parameter"><code><span class="type">char</span> **modifierp</code></em>);</pre>
301
Extracts the various components of a locale string of the form
302
[language[_country][.codeset][<em class="parameter"><code>modifier</code></em>]]. See
303
http://en.wikipedia.org/wiki/Locale.
305
<div class="variablelist"><table border="0" class="variablelist">
307
<col align="left" valign="top">
312
<td><p><span class="term"><em class="parameter"><code>locale</code></em> :</span></p></td>
313
<td>a locale string</td>
316
<td><p><span class="term"><em class="parameter"><code>language_codep</code></em> :</span></p></td>
318
store the language code, or <code class="literal">NULL</code>. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>][<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
322
<td><p><span class="term"><em class="parameter"><code>country_codep</code></em> :</span></p></td>
324
store the country code, or <code class="literal">NULL</code>. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>][<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
328
<td><p><span class="term"><em class="parameter"><code>codesetp</code></em> :</span></p></td>
330
store the codeset, or <code class="literal">NULL</code>. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>][<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
334
<td><p><span class="term"><em class="parameter"><code>modifierp</code></em> :</span></p></td>
336
store the modifier, or <code class="literal">NULL</code>. <span class="annotation">[<a href="http://foldoc.org/out"><span class="acronym">out</span></a>][<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>][<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
340
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
342
<code class="literal">TRUE</code> if parsing was successful.</td>
346
<p class="since">Since 3.8</p>
349
<div class="refsect2">
350
<a name="gnome-language-has-translations"></a><h3>gnome_language_has_translations ()</h3>
351
<pre class="programlisting"><span class="returnvalue">gboolean</span> gnome_language_has_translations (<em class="parameter"><code>const <span class="type">char</span> *code</code></em>);</pre>
353
Returns <code class="literal">TRUE</code> if there are translations for language <em class="parameter"><code>code</code></em>.
355
<div class="variablelist"><table border="0" class="variablelist">
357
<col align="left" valign="top">
362
<td><p><span class="term"><em class="parameter"><code>code</code></em> :</span></p></td>
363
<td>an ISO 639 code string</td>
366
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
368
<code class="literal">TRUE</code> if there are translations for language <em class="parameter"><code>code</code></em>.</td>
372
<p class="since">Since 3.8</p>
378
Generated by GTK-Doc V1.18</div>
b'\\ No newline at end of file'