← Back to branch summary

~sipe-collab/sipe-collab/gstreamer-plugins-base

« back to all changes in this revision

Viewing changes to docs/libs/html/gst-plugins-base-libs-gsttaglanguagecodes.html

  • Committer: Sebastian Dröge
  • Date: 2014-04-19 13:47:47 UTC
  • mfrom: (1.1.23)
  • Revision ID: git-v1:d06393f82dba0d5f13ec2e66275d75cf8178fe5c
Merge tag 'upstream/1.2.4'

Upstream version 1.2.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/libs/html/gst-plugins-base-libs-gsttaglanguagecodes.html
2
2
<html>
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>gsttaglanguagecodes</title>
 
5
<title>GStreamer Base Plugins 1.0 Library Reference Manual: gsttaglanguagecodes</title>
6
6
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
7
<link rel="home" href="index.html" title="GStreamer Base Plugins 1.0 Library Reference Manual">
8
8
<link rel="up" href="gstreamer-tag.html" title="Tag Support Library">
9
9
<link rel="prev" href="gst-plugins-base-libs-gsttagmux.html" title="gsttagmux">
10
10
<link rel="next" href="gst-plugins-base-libs-gsttaglicenses.html" title="gsttaglicenses">
11
 
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.20 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
 
<tr valign="middle">
17
 
<td><a accesskey="p" href="gst-plugins-base-libs-gsttagmux.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
 
<td><a accesskey="u" href="gstreamer-tag.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
 
<th width="100%" align="center">GStreamer Base Plugins 1.0 Library Reference Manual</th>
21
 
<td><a accesskey="n" href="gst-plugins-base-libs-gsttaglicenses.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
 
</tr>
23
 
<tr><td colspan="5" class="shortcuts">
24
 
<a href="#gst-plugins-base-libs-gsttaglanguagecodes.synopsis" class="shortcut">Top</a>
25
 
                   | 
26
 
                  <a href="#gst-plugins-base-libs-gsttaglanguagecodes.description" class="shortcut">Description</a>
27
 
</td></tr>
28
 
</table>
 
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
 
16
<td width="100%" align="left" class="shortcuts">
 
17
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 
 
18
                  <a href="#gst-plugins-base-libs-gsttaglanguagecodes.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 
 
19
                  <a href="#gst-plugins-base-libs-gsttaglanguagecodes.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
 
20
</td>
 
21
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
 
22
<td><a accesskey="u" href="gstreamer-tag.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
 
23
<td><a accesskey="p" href="gst-plugins-base-libs-gsttagmux.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
 
24
<td><a accesskey="n" href="gst-plugins-base-libs-gsttaglicenses.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
 
25
</tr></table>
29
26
<div class="refentry">
30
27
<a name="gst-plugins-base-libs-gsttaglanguagecodes"></a><div class="titlepage"></div>
31
28
<div class="refnamediv"><table width="100%"><tr>
33
30
<h2><span class="refentrytitle"><a name="gst-plugins-base-libs-gsttaglanguagecodes.top_of_page"></a>gsttaglanguagecodes</span></h2>
34
31
<p>gsttaglanguagecodes — mappings for ISO-639 language codes and names</p>
35
32
</td>
36
 
<td valign="top" align="right"></td>
 
33
<td class="gallery_image" valign="top" align="right"></td>
37
34
</tr></table></div>
38
 
<div class="refsynopsisdiv">
39
 
<a name="gst-plugins-base-libs-gsttaglanguagecodes.synopsis"></a><h2>Synopsis</h2>
40
 
<pre class="synopsis">
41
 
#include &lt;gst/tag/tag.h&gt;
42
 
 
43
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-codes" title="gst_tag_get_language_codes ()">gst_tag_get_language_codes</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
44
 
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-name" title="gst_tag_get_language_name ()">gst_tag_get_language_name</a>           (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *language_code</code></em>);
45
 
#define             <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code" title="gst_tag_get_language_code()">gst_tag_get_language_code</a>           (lang_code)
46
 
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code-iso-639-1" title="gst_tag_get_language_code_iso_639_1 ()">gst_tag_get_language_code_iso_639_1</a> (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);
47
 
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code-iso-639-2B" title="gst_tag_get_language_code_iso_639_2B ()">gst_tag_get_language_code_iso_639_2B</a>
48
 
                                                        (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);
49
 
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code-iso-639-2T" title="gst_tag_get_language_code_iso_639_2T ()">gst_tag_get_language_code_iso_639_2T</a>
50
 
                                                        (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);
51
 
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-check-language-code" title="gst_tag_check_language_code ()">gst_tag_check_language_code</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);
 
35
<div class="refsect1">
 
36
<a name="gst-plugins-base-libs-gsttaglanguagecodes.functions"></a><h2>Functions</h2>
 
37
<div class="informaltable"><table width="100%" border="0">
 
38
<colgroup>
 
39
<col width="150px" class="functions_return">
 
40
<col class="functions_name">
 
41
</colgroup>
 
42
<tbody>
 
43
<tr>
 
44
<td class="function_type">
 
45
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
 
46
</td>
 
47
<td class="function_name">
 
48
<a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-codes" title="gst_tag_get_language_codes ()">gst_tag_get_language_codes</a> <span class="c_punctuation">()</span>
 
49
</td>
 
50
</tr>
 
51
<tr>
 
52
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
53
</td>
 
54
<td class="function_name">
 
55
<a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-name" title="gst_tag_get_language_name ()">gst_tag_get_language_name</a> <span class="c_punctuation">()</span>
 
56
</td>
 
57
</tr>
 
58
<tr>
 
59
<td class="define_keyword">#define</td>
 
60
<td class="function_name">
 
61
<a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code" title="gst_tag_get_language_code()">gst_tag_get_language_code</a><span class="c_punctuation">()</span>
 
62
</td>
 
63
</tr>
 
64
<tr>
 
65
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
66
</td>
 
67
<td class="function_name">
 
68
<a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code-iso-639-1" title="gst_tag_get_language_code_iso_639_1 ()">gst_tag_get_language_code_iso_639_1</a> <span class="c_punctuation">()</span>
 
69
</td>
 
70
</tr>
 
71
<tr>
 
72
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
73
</td>
 
74
<td class="function_name">
 
75
<a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code-iso-639-2B" title="gst_tag_get_language_code_iso_639_2B ()">gst_tag_get_language_code_iso_639_2B</a> <span class="c_punctuation">()</span>
 
76
</td>
 
77
</tr>
 
78
<tr>
 
79
<td class="function_type">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
80
</td>
 
81
<td class="function_name">
 
82
<a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code-iso-639-2T" title="gst_tag_get_language_code_iso_639_2T ()">gst_tag_get_language_code_iso_639_2T</a> <span class="c_punctuation">()</span>
 
83
</td>
 
84
</tr>
 
85
<tr>
 
86
<td class="function_type">
 
87
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
88
</td>
 
89
<td class="function_name">
 
90
<a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-check-language-code" title="gst_tag_check_language_code ()">gst_tag_check_language_code</a> <span class="c_punctuation">()</span>
 
91
</td>
 
92
</tr>
 
93
</tbody>
 
94
</table></div>
 
95
</div>
 
96
<div class="refsect1">
 
97
<a name="gst-plugins-base-libs-gsttaglanguagecodes.object-hierarchy"></a><h2>Object Hierarchy</h2>
 
98
<pre class="screen">
 
99
</pre>
 
100
</div>
 
101
<div class="refsect1">
 
102
<a name="gst-plugins-base-libs-gsttaglanguagecodes.includes"></a><h2>Includes</h2>
 
103
<pre class="synopsis">#include &lt;gst/tag/tag.h&gt;
52
104
</pre>
53
105
</div>
54
106
<div class="refsect1">
55
107
<a name="gst-plugins-base-libs-gsttaglanguagecodes.description"></a><h2>Description</h2>
56
 
<p>
57
 
</p>
58
108
<div class="refsect2">
59
 
<a name="id-1.2.12.11.4.2.1"></a><p>
 
109
<a name="id-1.2.12.11.6.2"></a><p>
60
110
Provides helper functions to convert between the various ISO-639 language
61
111
codes, and to map language codes to language names.
62
112
</p>
63
113
</div>
64
 
<p>
65
 
</p>
66
114
</div>
67
115
<div class="refsect1">
68
 
<a name="gst-plugins-base-libs-gsttaglanguagecodes.details"></a><h2>Details</h2>
 
116
<a name="gst-plugins-base-libs-gsttaglanguagecodes.functions_details"></a><h2>Functions</h2>
69
117
<div class="refsect2">
70
 
<a name="gst-tag-get-language-codes"></a><h3>gst_tag_get_language_codes ()</h3>
71
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            gst_tag_get_language_codes          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
72
 
<p>
73
 
Returns a list of known language codes (in form of two-letter ISO-639-1
 
118
<a name="gst-tag-get-language-codes"></a><h3>gst_tag_get_language_codes ()</h3>
 
119
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **
 
120
gst_tag_get_language_codes (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
121
<p>Returns a list of known language codes (in form of two-letter ISO-639-1
74
122
codes). This is useful for UIs to build a list of available languages for
75
123
tagging purposes (e.g. to tag an audio track appropriately in a video or
76
 
audio editor).
77
 
</p>
78
 
<div class="variablelist"><table border="0" class="variablelist">
79
 
<colgroup>
80
 
<col align="left" valign="top">
81
 
<col>
82
 
</colgroup>
83
 
<tbody><tr>
84
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
85
 
<td>NULL-terminated string array with two-letter
86
 
language codes. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when no longer needed. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
87
 
</td>
88
 
</tr></tbody>
89
 
</table></div>
 
124
audio editor).</p>
 
125
<div class="refsect3">
 
126
<a name="id-1.2.12.11.7.2.5"></a><h4>Returns</h4>
 
127
<p> NULL-terminated string array with two-letter
 
128
language codes. Free with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when no longer needed. </p>
 
129
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 
130
</div>
90
131
</div>
91
132
<hr>
92
133
<div class="refsect2">
93
 
<a name="gst-tag-get-language-name"></a><h3>gst_tag_get_language_name ()</h3>
94
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_tag_get_language_name           (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *language_code</code></em>);</pre>
95
 
<p>
96
 
Returns the name of the language given an ISO-639 language code as
 
134
<a name="gst-tag-get-language-name"></a><h3>gst_tag_get_language_name ()</h3>
 
135
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
136
gst_tag_get_language_name (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *language_code</code></em>);</pre>
 
137
<p>Returns the name of the language given an ISO-639 language code as
97
138
found in a GST_TAG_LANGUAGE_CODE tag. The name will be translated
98
139
according to the current locale (if the library was built against the
99
 
iso-codes package, otherwise the English name will be returned).
100
 
</p>
101
 
<p>
102
 
Language codes are case-sensitive and expected to be lower case.
103
 
</p>
104
 
<div class="variablelist"><table border="0" class="variablelist">
 
140
iso-codes package, otherwise the English name will be returned).</p>
 
141
<p>Language codes are case-sensitive and expected to be lower case.</p>
 
142
<div class="refsect3">
 
143
<a name="id-1.2.12.11.7.3.6"></a><h4>Parameters</h4>
 
144
<div class="informaltable"><table width="100%" border="0">
105
145
<colgroup>
106
 
<col align="left" valign="top">
107
 
<col>
 
146
<col width="150px" class="parameters_name">
 
147
<col class="parameters_description">
 
148
<col width="200px" class="parameters_annotations">
108
149
</colgroup>
109
 
<tbody>
110
 
<tr>
111
 
<td><p><span class="term"><em class="parameter"><code>language_code</code></em> :</span></p></td>
112
 
<td>two or three-letter ISO-639 language code</td>
113
 
</tr>
114
 
<tr>
115
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
116
 
<td>language name in UTF-8 format, or NULL if <em class="parameter"><code>language_code</code></em> could
 
150
<tbody><tr>
 
151
<td class="parameter_name"><p>language_code</p></td>
 
152
<td class="parameter_description"><p>two or three-letter ISO-639 language code</p></td>
 
153
<td class="parameter_annotations"> </td>
 
154
</tr></tbody>
 
155
</table></div>
 
156
</div>
 
157
<div class="refsect3">
 
158
<a name="id-1.2.12.11.7.3.7"></a><h4>Returns</h4>
 
159
<p> language name in UTF-8 format, or NULL if <em class="parameter"><code>language_code</code></em>
 
160
could
117
161
not be mapped to a language name. The returned string must not be
118
162
modified and does not need to freed; it will stay valid until the
119
 
application is terminated.</td>
120
 
</tr>
121
 
</tbody>
122
 
</table></div>
 
163
application is terminated.</p>
 
164
<p></p>
 
165
</div>
123
166
</div>
124
167
<hr>
125
168
<div class="refsect2">
126
169
<a name="gst-tag-get-language-code"></a><h3>gst_tag_get_language_code()</h3>
127
170
<pre class="programlisting">#define             gst_tag_get_language_code(lang_code)</pre>
128
 
<p>
129
 
Convenience macro wrapping <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code-iso-639-1" title="gst_tag_get_language_code_iso_639_1 ()"><code class="function">gst_tag_get_language_code_iso_639_1()</code></a>.
130
 
</p>
131
 
<div class="variablelist"><table border="0" class="variablelist">
 
171
<p>Convenience macro wrapping <a class="link" href="gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-code-iso-639-1" title="gst_tag_get_language_code_iso_639_1 ()"><code class="function">gst_tag_get_language_code_iso_639_1()</code></a>.</p>
 
172
<div class="refsect3">
 
173
<a name="id-1.2.12.11.7.4.5"></a><h4>Parameters</h4>
 
174
<div class="informaltable"><table width="100%" border="0">
132
175
<colgroup>
133
 
<col align="left" valign="top">
134
 
<col>
 
176
<col width="150px" class="parameters_name">
 
177
<col class="parameters_description">
 
178
<col width="200px" class="parameters_annotations">
135
179
</colgroup>
136
180
<tbody><tr>
137
 
<td><p><span class="term"><em class="parameter"><code>lang_code</code></em> :</span></p></td>
138
 
<td>ISO-639 language code (e.g. "deu" or "ger" or "de")</td>
 
181
<td class="parameter_name"><p>lang_code</p></td>
 
182
<td class="parameter_description"><p>ISO-639 language code (e.g. "deu" or "ger" or "de")</p></td>
 
183
<td class="parameter_annotations"> </td>
139
184
</tr></tbody>
140
185
</table></div>
141
186
</div>
 
187
</div>
142
188
<hr>
143
189
<div class="refsect2">
144
 
<a name="gst-tag-get-language-code-iso-639-1"></a><h3>gst_tag_get_language_code_iso_639_1 ()</h3>
145
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_tag_get_language_code_iso_639_1 (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);</pre>
146
 
<p>
147
 
Returns two-letter ISO-639-1 language code given a three-letter ISO-639-2
 
190
<a name="gst-tag-get-language-code-iso-639-1"></a><h3>gst_tag_get_language_code_iso_639_1 ()</h3>
 
191
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
192
gst_tag_get_language_code_iso_639_1 (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);</pre>
 
193
<p>Returns two-letter ISO-639-1 language code given a three-letter ISO-639-2
148
194
language code or two-letter ISO-639-1 language code (both are accepted for
149
 
convenience).
150
 
</p>
151
 
<p>
152
 
Language codes are case-sensitive and expected to be lower case.
153
 
</p>
154
 
<div class="variablelist"><table border="0" class="variablelist">
 
195
convenience).</p>
 
196
<p>Language codes are case-sensitive and expected to be lower case.</p>
 
197
<div class="refsect3">
 
198
<a name="id-1.2.12.11.7.5.6"></a><h4>Parameters</h4>
 
199
<div class="informaltable"><table width="100%" border="0">
155
200
<colgroup>
156
 
<col align="left" valign="top">
157
 
<col>
 
201
<col width="150px" class="parameters_name">
 
202
<col class="parameters_description">
 
203
<col width="200px" class="parameters_annotations">
158
204
</colgroup>
159
 
<tbody>
160
 
<tr>
161
 
<td><p><span class="term"><em class="parameter"><code>lang_code</code></em> :</span></p></td>
162
 
<td>ISO-639 language code (e.g. "deu" or "ger" or "de")</td>
163
 
</tr>
164
 
<tr>
165
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
166
 
<td>two-letter ISO-639-1 language code string that maps to <em class="parameter"><code>lang_code</code></em>,
 
205
<tbody><tr>
 
206
<td class="parameter_name"><p>lang_code</p></td>
 
207
<td class="parameter_description"><p>ISO-639 language code (e.g. "deu" or "ger" or "de")</p></td>
 
208
<td class="parameter_annotations"> </td>
 
209
</tr></tbody>
 
210
</table></div>
 
211
</div>
 
212
<div class="refsect3">
 
213
<a name="id-1.2.12.11.7.5.7"></a><h4>Returns</h4>
 
214
<p> two-letter ISO-639-1 language code string that maps to <em class="parameter"><code>lang_code</code></em>
 
215
,
167
216
or NULL if no mapping is known. The returned string must not be
168
 
modified or freed.</td>
169
 
</tr>
170
 
</tbody>
171
 
</table></div>
 
217
modified or freed.</p>
 
218
<p></p>
 
219
</div>
172
220
</div>
173
221
<hr>
174
222
<div class="refsect2">
175
 
<a name="gst-tag-get-language-code-iso-639-2B"></a><h3>gst_tag_get_language_code_iso_639_2B ()</h3>
176
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_tag_get_language_code_iso_639_2B
177
 
                                                        (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);</pre>
178
 
<p>
179
 
Returns three-letter ISO-639-2 "bibliographic" language code given a
 
223
<a name="gst-tag-get-language-code-iso-639-2B"></a><h3>gst_tag_get_language_code_iso_639_2B ()</h3>
 
224
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
225
gst_tag_get_language_code_iso_639_2B (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);</pre>
 
226
<p>Returns three-letter ISO-639-2 "bibliographic" language code given a
180
227
two-letter ISO-639-1 language code or a three-letter ISO-639-2 language
181
 
code (both are accepted for convenience).
182
 
</p>
183
 
<p>
184
 
The "bibliographic" code is derived from the English name of the language
 
228
code (both are accepted for convenience).</p>
 
229
<p>The "bibliographic" code is derived from the English name of the language
185
230
(e.g. "ger" for German instead of "de" or "deu"). In most scenarios, the
186
 
"terminological" codes are prefered.
187
 
</p>
188
 
<p>
189
 
Language codes are case-sensitive and expected to be lower case.
190
 
</p>
191
 
<div class="variablelist"><table border="0" class="variablelist">
 
231
"terminological" codes are prefered.</p>
 
232
<p>Language codes are case-sensitive and expected to be lower case.</p>
 
233
<div class="refsect3">
 
234
<a name="id-1.2.12.11.7.6.7"></a><h4>Parameters</h4>
 
235
<div class="informaltable"><table width="100%" border="0">
192
236
<colgroup>
193
 
<col align="left" valign="top">
194
 
<col>
 
237
<col width="150px" class="parameters_name">
 
238
<col class="parameters_description">
 
239
<col width="200px" class="parameters_annotations">
195
240
</colgroup>
196
 
<tbody>
197
 
<tr>
198
 
<td><p><span class="term"><em class="parameter"><code>lang_code</code></em> :</span></p></td>
199
 
<td>ISO-639 language code (e.g. "deu" or "ger" or "de")</td>
200
 
</tr>
201
 
<tr>
202
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
203
 
<td>three-letter ISO-639-2 language code string that maps to <em class="parameter"><code>lang_code</code></em>,
 
241
<tbody><tr>
 
242
<td class="parameter_name"><p>lang_code</p></td>
 
243
<td class="parameter_description"><p>ISO-639 language code (e.g. "deu" or "ger" or "de")</p></td>
 
244
<td class="parameter_annotations"> </td>
 
245
</tr></tbody>
 
246
</table></div>
 
247
</div>
 
248
<div class="refsect3">
 
249
<a name="id-1.2.12.11.7.6.8"></a><h4>Returns</h4>
 
250
<p> three-letter ISO-639-2 language code string that maps to <em class="parameter"><code>lang_code</code></em>
 
251
,
204
252
or NULL if no mapping is known. The returned string must not be
205
 
modified or freed.</td>
206
 
</tr>
207
 
</tbody>
208
 
</table></div>
 
253
modified or freed.</p>
 
254
<p></p>
 
255
</div>
209
256
</div>
210
257
<hr>
211
258
<div class="refsect2">
212
 
<a name="gst-tag-get-language-code-iso-639-2T"></a><h3>gst_tag_get_language_code_iso_639_2T ()</h3>
213
 
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *       gst_tag_get_language_code_iso_639_2T
214
 
                                                        (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);</pre>
215
 
<p>
216
 
Returns three-letter ISO-639-2 "terminological" language code given a
 
259
<a name="gst-tag-get-language-code-iso-639-2T"></a><h3>gst_tag_get_language_code_iso_639_2T ()</h3>
 
260
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 
261
gst_tag_get_language_code_iso_639_2T (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);</pre>
 
262
<p>Returns three-letter ISO-639-2 "terminological" language code given a
217
263
two-letter ISO-639-1 language code or a three-letter ISO-639-2 language
218
 
code (both are accepted for convenience).
219
 
</p>
220
 
<p>
221
 
The "terminological" code is derived from the local name of the language
 
264
code (both are accepted for convenience).</p>
 
265
<p>The "terminological" code is derived from the local name of the language
222
266
(e.g. "deu" for German instead of "ger"). In most scenarios, the
223
 
"terminological" codes are prefered over the "bibliographic" ones.
224
 
</p>
225
 
<p>
226
 
Language codes are case-sensitive and expected to be lower case.
227
 
</p>
228
 
<div class="variablelist"><table border="0" class="variablelist">
 
267
"terminological" codes are prefered over the "bibliographic" ones.</p>
 
268
<p>Language codes are case-sensitive and expected to be lower case.</p>
 
269
<div class="refsect3">
 
270
<a name="id-1.2.12.11.7.7.7"></a><h4>Parameters</h4>
 
271
<div class="informaltable"><table width="100%" border="0">
229
272
<colgroup>
230
 
<col align="left" valign="top">
231
 
<col>
 
273
<col width="150px" class="parameters_name">
 
274
<col class="parameters_description">
 
275
<col width="200px" class="parameters_annotations">
232
276
</colgroup>
233
 
<tbody>
234
 
<tr>
235
 
<td><p><span class="term"><em class="parameter"><code>lang_code</code></em> :</span></p></td>
236
 
<td>ISO-639 language code (e.g. "deu" or "ger" or "de")</td>
237
 
</tr>
238
 
<tr>
239
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
240
 
<td>three-letter ISO-639-2 language code string that maps to <em class="parameter"><code>lang_code</code></em>,
 
277
<tbody><tr>
 
278
<td class="parameter_name"><p>lang_code</p></td>
 
279
<td class="parameter_description"><p>ISO-639 language code (e.g. "deu" or "ger" or "de")</p></td>
 
280
<td class="parameter_annotations"> </td>
 
281
</tr></tbody>
 
282
</table></div>
 
283
</div>
 
284
<div class="refsect3">
 
285
<a name="id-1.2.12.11.7.7.8"></a><h4>Returns</h4>
 
286
<p> three-letter ISO-639-2 language code string that maps to <em class="parameter"><code>lang_code</code></em>
 
287
,
241
288
or NULL if no mapping is known. The returned string must not be
242
 
modified or freed.</td>
243
 
</tr>
244
 
</tbody>
245
 
</table></div>
 
289
modified or freed.</p>
 
290
<p></p>
 
291
</div>
246
292
</div>
247
293
<hr>
248
294
<div class="refsect2">
249
 
<a name="gst-tag-check-language-code"></a><h3>gst_tag_check_language_code ()</h3>
250
 
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_tag_check_language_code         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);</pre>
251
 
<p>
252
 
Check if a given string contains a known ISO 639 language code.
253
 
</p>
254
 
<p>
255
 
This is useful in situations where it's not clear whether a given
 
295
<a name="gst-tag-check-language-code"></a><h3>gst_tag_check_language_code ()</h3>
 
296
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 
297
gst_tag_check_language_code (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *lang_code</code></em>);</pre>
 
298
<p>Check if a given string contains a known ISO 639 language code.</p>
 
299
<p>This is useful in situations where it's not clear whether a given
256
300
string is a language code (which should be put into a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-LANGUAGE-CODE:CAPS"><span class="type">GST_TAG_LANGUAGE_CODE</span></a>
257
301
tag) or a free-form language name descriptor (which should be put into a
258
 
<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-LANGUAGE-NAME:CAPS"><span class="type">GST_TAG_LANGUAGE_NAME</span></a> tag instead).
259
 
</p>
260
 
<div class="variablelist"><table border="0" class="variablelist">
 
302
<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-LANGUAGE-NAME:CAPS"><span class="type">GST_TAG_LANGUAGE_NAME</span></a> tag instead).</p>
 
303
<div class="refsect3">
 
304
<a name="id-1.2.12.11.7.8.6"></a><h4>Parameters</h4>
 
305
<div class="informaltable"><table width="100%" border="0">
261
306
<colgroup>
262
 
<col align="left" valign="top">
263
 
<col>
 
307
<col width="150px" class="parameters_name">
 
308
<col class="parameters_description">
 
309
<col width="200px" class="parameters_annotations">
264
310
</colgroup>
265
 
<tbody>
266
 
<tr>
267
 
<td><p><span class="term"><em class="parameter"><code>lang_code</code></em> :</span></p></td>
268
 
<td>ISO-639 language code (e.g. "deu" or "ger" or "de")</td>
269
 
</tr>
270
 
<tr>
271
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
272
 
<td>TRUE if the two- or three-letter language code in <em class="parameter"><code>lang_code</code></em>
273
 
is a valid ISO-639 language code.</td>
274
 
</tr>
275
 
</tbody>
 
311
<tbody><tr>
 
312
<td class="parameter_name"><p>lang_code</p></td>
 
313
<td class="parameter_description"><p>ISO-639 language code (e.g. "deu" or "ger" or "de")</p></td>
 
314
<td class="parameter_annotations"> </td>
 
315
</tr></tbody>
276
316
</table></div>
277
317
</div>
 
318
<div class="refsect3">
 
319
<a name="id-1.2.12.11.7.8.7"></a><h4>Returns</h4>
 
320
<p> TRUE if the two- or three-letter language code in <em class="parameter"><code>lang_code</code></em>
 
321
is a valid ISO-639 language code.</p>
 
322
<p></p>
 
323
</div>
 
324
</div>
 
325
</div>
 
326
<div class="refsect1">
 
327
<a name="gst-plugins-base-libs-gsttaglanguagecodes.other_details"></a><h2>Types and Values</h2>
278
328
</div>
279
329
<div class="refsect1">
280
330
<a name="gst-plugins-base-libs-gsttaglanguagecodes.see-also"></a><h2>See Also</h2>
281
 
<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GstTagList"><span class="type">GstTagList</span></a>
 
331
<p><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GstTagList"><span class="type">GstTagList</span></a></p>
282
332
</div>
283
333
</div>
284
334
<div class="footer">
285
335
<hr>
286
 
          Generated by GTK-Doc V1.19</div>
 
336
          Generated by GTK-Doc V1.20</div>
287
337
</body>
288
338
</html>
 
 
b'\\ No newline at end of file'