1
<?xml version="1.0" encoding="UTF-8"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
6
<title>Soprano.LanguageTag</title>
7
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
8
<meta http-equiv="Content-Style-Type" content="text/css" />
9
<link rel="stylesheet" type="text/css" href="../common/doxygen.css" />
10
<link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../common/kde.css" />
18
<img alt ="" src="../common/top-kde.jpg"/>
19
KDE 4.3 PyKDE API Reference
23
<div id="header_bottom">
26
<li>KDE's Python API</li>
32
<li><a href="../modules.html">Overview</a></li>
33
<li><a href="http://techbase.kde.org/Development/Languages/Python">PyKDE Home</a></li>
34
<li><a href="http://kde.org/family/">Sitemap</a></li>
35
<li><a href="http://kde.org/contact/">Contact Us</a></li>
41
<div id="body_wrapper">
46
<div class="clearer"> </div>
48
<h1>LanguageTag Class Reference</h1>
49
<code>from PyKDE4.soprano import *</code>
53
Namespace: Soprano<br />
54
<h2>Detailed Description</h2>
56
<p>\class LanguageTag languagetag.h Soprano/LanguageTag
59
A LanguageTag represents a language according to RFC 3066 and RFC 4646.
63
<dl class="author" compact><dt><b>Author:</b></dt><dd> Greg Beauchesne <greg_b@vision-play.com> </dd></dl>
66
<dl class="since" compact><dt><b>Since:</b></dt><dd> 2.3
69
<table border="0" cellpadding="0" cellspacing="0"><tr><td colspan="2"><br><h2>Enumerations</h2></td></tr>
70
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#obj186803468">LookupFlag</a> </td><td class="memItemRight" valign="bottom">{ LookupFlagNone, LookupFlagNoFallback }</td></tr>
71
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#obj186804620">MatchFilter</a> </td><td class="memItemRight" valign="bottom">{ MatchFilterBasic, MatchFilterExtended }</td></tr>
72
<tr><td colspan="2"><br><h2>Methods</h2></td></tr>
73
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj164169996">__init__</a> (self)</td></tr>
74
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj174575436">__init__</a> (self, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> other)</td></tr>
75
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj174574060">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> tag)</td></tr>
76
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj176314380">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qlatin1string.html">QLatin1String</a> tag)</td></tr>
77
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj171405804">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> tag)</td></tr>
78
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj171407372">__init__</a> (self, <a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qlocale.html">QLocale</a> locale)</td></tr>
79
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj168307948">__init__</a> (self, QLocale.Language lang, QLocale.Country country=QLocale.AnyCountry)</td></tr>
80
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj184136204">isEmpty</a> (self)</td></tr>
81
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj186988172">isValid</a> (self)</td></tr>
82
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj176129068">matches</a> (self, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> range, Soprano.LanguageTag.MatchFilter scheme=Soprano.LanguageTag.MatchFilterBasic)</td></tr>
83
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj186803244">operator !=</a> (self, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> other)</td></tr>
84
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj165475660">operator <</a> (self, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> other)</td></tr>
85
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj165474508">operator <=</a> (self, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> other)</td></tr>
86
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj165476236">operator ==</a> (self, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> other)</td></tr>
87
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj165476332">operator ></a> (self, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> other)</td></tr>
88
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj164510412">operator >=</a> (self, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> other)</td></tr>
89
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj184138252">operator QString</a> (self)</td></tr>
90
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj186987724">subTags</a> (self)</td></tr>
91
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qlocale.html">QLocale</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj170475948">toLocale</a> (self)</td></tr>
92
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj184136684">toPrettyString</a> (self)</td></tr>
93
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj184138380">toString</a> (self)</td></tr>
94
<tr><td colspan="2"><br><h2>Static Methods</h2></td></tr>
95
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj170479532">lookup</a> ([<a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a>] choices, [<a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a>] priority, Soprano.LanguageTag.LookupFlags flags=Soprano.LanguageTag.LookupFlagNone, Soprano.LanguageTag.MatchFilter scheme=Soprano.LanguageTag.MatchFilterBasic)</td></tr>
96
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="#obj185956716">lookup</a> ([<a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a>] choices, <a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> priority, Soprano.LanguageTag.LookupFlags flags=Soprano.LanguageTag.LookupFlagNone, Soprano.LanguageTag.MatchFilter scheme=Soprano.LanguageTag.MatchFilterBasic)</td></tr>
98
<hr><h2>Method Documentation</h2><a class="anchor" name="obj164169996"></a>
100
<div class="memproto">
101
<table class="memname"><tr>
102
<td class="memname">__init__</td>
104
<td class="paramtype"> </td>
105
<td class="paramname"><em>self</em> )</td>
106
<td width="100%"> </td>
110
<div class="memdoc"><p>Default constructor.
111
Creates an empty language tag.
112
</p></div></div><a class="anchor" name="obj174575436"></a>
113
<div class="memitem">
114
<div class="memproto">
115
<table class="memname"><tr>
116
<td class="memname">__init__</td>
118
<td class="paramtype"> <em>self</em>, </td>
119
<td class="paramname"></td>
121
<td class="memname"></td>
123
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
124
<td class="paramname"><em>other</em></td>
131
<td width="100%"> </td>
134
<div class="memdoc"><p>Copy constructor.
137
</p><dl compact><dt><b>Parameters:</b></dt><dd>
138
<table border="0" cellspacing="2" cellpadding="0">
139
<tr><td></td><td valign="top"><em>other</em> </td><td> The language tag from which to copy
143
</p></div></div><a class="anchor" name="obj174574060"></a>
144
<div class="memitem">
145
<div class="memproto">
146
<table class="memname"><tr>
147
<td class="memname">__init__</td>
149
<td class="paramtype"> <em>self</em>, </td>
150
<td class="paramname"></td>
152
<td class="memname"></td>
154
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
155
<td class="paramname"><em>tag</em></td>
162
<td width="100%"> </td>
165
<div class="memdoc"><p>Creates a language tag.
168
</p><dl compact><dt><b>Parameters:</b></dt><dd>
169
<table border="0" cellspacing="2" cellpadding="0">
170
<tr><td></td><td valign="top"><em>tag</em> </td><td> The language tag string
174
</p></div></div><a class="anchor" name="obj176314380"></a>
175
<div class="memitem">
176
<div class="memproto">
177
<table class="memname"><tr>
178
<td class="memname">__init__</td>
180
<td class="paramtype"> <em>self</em>, </td>
181
<td class="paramname"></td>
183
<td class="memname"></td>
185
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qlatin1string.html">QLatin1String</a> </td>
186
<td class="paramname"><em>tag</em></td>
193
<td width="100%"> </td>
196
<div class="memdoc"><p>Creates a language tag.
199
</p><dl compact><dt><b>Parameters:</b></dt><dd>
200
<table border="0" cellspacing="2" cellpadding="0">
201
<tr><td></td><td valign="top"><em>tag</em> </td><td> The language tag string
205
</p></div></div><a class="anchor" name="obj171405804"></a>
206
<div class="memitem">
207
<div class="memproto">
208
<table class="memname"><tr>
209
<td class="memname">__init__</td>
211
<td class="paramtype"> <em>self</em>, </td>
212
<td class="paramname"></td>
214
<td class="memname"></td>
216
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> </td>
217
<td class="paramname"><em>tag</em></td>
224
<td width="100%"> </td>
227
<div class="memdoc"><p>Creates a language tag.
230
</p><dl compact><dt><b>Parameters:</b></dt><dd>
231
<table border="0" cellspacing="2" cellpadding="0">
232
<tr><td></td><td valign="top"><em>tag</em> </td><td> The language tag string
236
</p></div></div><a class="anchor" name="obj171407372"></a>
237
<div class="memitem">
238
<div class="memproto">
239
<table class="memname"><tr>
240
<td class="memname">__init__</td>
242
<td class="paramtype"> <em>self</em>, </td>
243
<td class="paramname"></td>
245
<td class="memname"></td>
247
<td class="paramtype"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qlocale.html">QLocale</a> </td>
248
<td class="paramname"><em>locale</em></td>
255
<td width="100%"> </td>
258
<div class="memdoc"><p>Creates a language tag from a QLocale. If the language is
259
QLocale.C, then an empty LanguageTag is produced.
262
</p><dl compact><dt><b>Parameters:</b></dt><dd>
263
<table border="0" cellspacing="2" cellpadding="0">
264
<tr><td></td><td valign="top"><em>locale</em> </td><td> the locale
268
</p></div></div><a class="anchor" name="obj168307948"></a>
269
<div class="memitem">
270
<div class="memproto">
271
<table class="memname"><tr>
272
<td class="memname">__init__</td>
274
<td class="paramtype"> <em>self</em>, </td>
275
<td class="paramname"></td>
277
<td class="memname"></td>
279
<td class="paramtype">QLocale.Language </td>
280
<td class="paramname"><em>lang</em>, </td>
283
<td class="memname"></td>
285
<td class="paramtype">QLocale.Country </td>
286
<td class="paramname"><em>country=QLocale.AnyCountry</em></td>
293
<td width="100%"> </td>
296
<div class="memdoc"><p>Creates a language tag from a language and country. If <b>lang</b> is
297
QLocale.C, then an empty LanguageTag is produced.
300
</p><dl compact><dt><b>Parameters:</b></dt><dd>
301
<table border="0" cellspacing="2" cellpadding="0">
302
<tr><td></td><td valign="top"><em>lang</em> </td><td> the language code
303
</td></tr> </table></dl>
304
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
305
<table border="0" cellspacing="2" cellpadding="0">
306
<tr><td></td><td valign="top"><em>country</em> </td><td> the country code
310
</p></div></div><a class="anchor" name="obj184136204"></a>
311
<div class="memitem">
312
<div class="memproto">
313
<table class="memname"><tr>
314
<td class="memname">bool isEmpty</td>
316
<td class="paramtype"> </td>
317
<td class="paramname"><em>self</em> )</td>
318
<td width="100%"> </td>
322
<div class="memdoc"><p><dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this language tag is empty.
324
</p></div></div><a class="anchor" name="obj186988172"></a>
325
<div class="memitem">
326
<div class="memproto">
327
<table class="memname"><tr>
328
<td class="memname">bool isValid</td>
330
<td class="paramtype"> </td>
331
<td class="paramname"><em>self</em> )</td>
332
<td width="100%"> </td>
336
<div class="memdoc"><p>Determines if this language tag is valid. A valid language
337
tag is divided into subtags that are divided by "-". The tag
338
must adhere the following rules:
339
- Each subtag is composed only of characters in the ASCII range
340
[a-zA-Z0-9] (letters and digits), with the exception of the
341
first subtag, which must be composed of letters only
342
- No subtags are empty
343
- No subtags are longer than 8 characters
344
- Single-character subtags cannot end the tag unless after a
345
private use ("x") subtag (e.g. "en-x-i" and "en-x-abcd-i" are
346
legal; "en-x", "en-i", and "en-i-abcd-g" are illegal)
349
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this language tag is valid
351
</p></div></div><a class="anchor" name="obj170479532"></a>
352
<div class="memitem">
353
<div class="memproto">
354
<table class="memname"><tr>
355
<td class="memname">int lookup</td>
357
<td class="paramtype">[<a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a>] </td>
358
<td class="paramname"><em>choices</em>, </td>
361
<td class="memname"></td>
363
<td class="paramtype">[<a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a>] </td>
364
<td class="paramname"><em>priority</em>, </td>
367
<td class="memname"></td>
369
<td class="paramtype">Soprano.LanguageTag.LookupFlags </td>
370
<td class="paramname"><em>flags=Soprano.LanguageTag.LookupFlagNone</em>, </td>
373
<td class="memname"></td>
375
<td class="paramtype">Soprano.LanguageTag.MatchFilter </td>
376
<td class="paramname"><em>scheme=Soprano.LanguageTag.MatchFilterBasic</em></td>
383
<td width="100%"> </td>
386
<div class="memdoc"><p>Compares a language tag against a list of language tags and
387
selects the most suitable tag according to the rules of RFC 4647
391
The arguments consist of <b>choices,</b> a list of tags from which
392
to select, and <b>priority,</b> a list of acceptable language ranges.
393
Both lists must be sorted in descending order of preference.
396
The matching algorithm works as follows:
398
<li>For each item in the <b>priority</b> list, the <b>choices</b> list is
399
scanned for matches. The wildcard value "*" is ignored in
400
lookup operations, as it would match any tag. If a match occurs,
401
the lookup is complete and the matching <b>choices</b> list index is
403
<li>If no match has been found, the last subtag on the current
404
<b>priority</b> item is truncated, and the <b>choices</b> list is scanned
405
again. Single-character subtags are also truncated if they are at
406
the end of the tag. This repeats until there are no subtags
407
remaining. This fallback behavior can be skipped by specifying the
408
LookupFlagsNoFallback flag.</li>
409
<li>If neither the current <b>priority</b> item nor any of its
410
fallback values matched the <b>choices</b> list, then the next item
411
in the <b>priority</b> list is considered according to the above
413
<li>If none of the <b>priority</b> items match the <b>choices</b> list,
414
then a value < 0 is returned.</li>
418
</p><dl compact><dt><b>Parameters:</b></dt><dd>
419
<table border="0" cellspacing="2" cellpadding="0">
420
<tr><td></td><td valign="top"><em>choices</em> </td><td> the list of available language choices
421
</td></tr> </table></dl>
422
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
423
<table border="0" cellspacing="2" cellpadding="0">
424
<tr><td></td><td valign="top"><em>priority</em> </td><td> the language priority list
425
</td></tr> </table></dl>
426
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
427
<table border="0" cellspacing="2" cellpadding="0">
428
<tr><td></td><td valign="top"><em>flags</em> </td><td> flags for the lookup operation
429
</td></tr> </table></dl>
430
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
431
<table border="0" cellspacing="2" cellpadding="0">
432
<tr><td></td><td valign="top"><em>scheme</em> </td><td> the matching scheme to use. RFC 4647 specifies
433
that basic (\link LanguageTag.MatchFilterBasic MatchFilterBasic\endlink)
434
processing should be used.
437
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the index of the matching language tag in <b>priority,</b> or
438
< 0 if no tag matched.
440
</p></div></div><a class="anchor" name="obj185956716"></a>
441
<div class="memitem">
442
<div class="memproto">
443
<table class="memname"><tr>
444
<td class="memname">int lookup</td>
446
<td class="paramtype">[<a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a>] </td>
447
<td class="paramname"><em>choices</em>, </td>
450
<td class="memname"></td>
452
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
453
<td class="paramname"><em>priority</em>, </td>
456
<td class="memname"></td>
458
<td class="paramtype">Soprano.LanguageTag.LookupFlags </td>
459
<td class="paramname"><em>flags=Soprano.LanguageTag.LookupFlagNone</em>, </td>
462
<td class="memname"></td>
464
<td class="paramtype">Soprano.LanguageTag.MatchFilter </td>
465
<td class="paramname"><em>scheme=Soprano.LanguageTag.MatchFilterBasic</em></td>
472
<td width="100%"> </td>
475
<div class="memdoc"><p>A convenience method to select a language tag based on a single
479
</p><dl compact><dt><b>Parameters:</b></dt><dd>
480
<table border="0" cellspacing="2" cellpadding="0">
481
<tr><td></td><td valign="top"><em>choices</em> </td><td> the list of available language choices
482
</td></tr> </table></dl>
483
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
484
<table border="0" cellspacing="2" cellpadding="0">
485
<tr><td></td><td valign="top"><em>priority</em> </td><td> the language range against which to match
486
</td></tr> </table></dl>
487
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
488
<table border="0" cellspacing="2" cellpadding="0">
489
<tr><td></td><td valign="top"><em>flags</em> </td><td> flags for the lookup operation
490
</td></tr> </table></dl>
491
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
492
<table border="0" cellspacing="2" cellpadding="0">
493
<tr><td></td><td valign="top"><em>scheme</em> </td><td> the matching scheme to use. RFC 4647 specifies
494
that basic (\link LanguageTag.MatchFilterBasic MatchFilterBasic\endlink)
495
processing should be used.
498
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> the index of the matching language tag in <b>priority,</b> or
499
< 0 if no tag matched.
502
\sa lookup(const QList<LanguageTag> &, const QList<LanguageTag> &, LookupFlags, MatchFilter)
503
</p></div></div><a class="anchor" name="obj176129068"></a>
504
<div class="memitem">
505
<div class="memproto">
506
<table class="memname"><tr>
507
<td class="memname">bool matches</td>
509
<td class="paramtype"> <em>self</em>, </td>
510
<td class="paramname"></td>
512
<td class="memname"></td>
514
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
515
<td class="paramname"><em>range</em>, </td>
518
<td class="memname"></td>
520
<td class="paramtype">Soprano.LanguageTag.MatchFilter </td>
521
<td class="paramname"><em>scheme=Soprano.LanguageTag.MatchFilterBasic</em></td>
528
<td width="100%"> </td>
531
<div class="memdoc"><p>Match this language tag against <b>range</b> using the specified
535
</p><dl compact><dt><b>Parameters:</b></dt><dd>
536
<table border="0" cellspacing="2" cellpadding="0">
537
<tr><td></td><td valign="top"><em>range</em> </td><td> the range against which to match
538
</td></tr> </table></dl>
539
<p> </p><dl compact><dt><b>Parameters:</b></dt><dd>
540
<table border="0" cellspacing="2" cellpadding="0">
541
<tr><td></td><td valign="top"><em>scheme</em> </td><td> the filtering scheme to use
544
<p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this tag matches <b>pattern,</b> false if not.
546
</p></div></div><a class="anchor" name="obj186803244"></a>
547
<div class="memitem">
548
<div class="memproto">
549
<table class="memname"><tr>
550
<td class="memname">bool operator !=</td>
552
<td class="paramtype"> <em>self</em>, </td>
553
<td class="paramname"></td>
555
<td class="memname"></td>
557
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
558
<td class="paramname"><em>other</em></td>
565
<td width="100%"> </td>
568
<div class="memdoc"><p>Comparison operator. Language tag comparisons are
570
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this tag and <b>other</b> differ.
572
</p></div></div><a class="anchor" name="obj165475660"></a>
573
<div class="memitem">
574
<div class="memproto">
575
<table class="memname"><tr>
576
<td class="memname">bool operator <</td>
578
<td class="paramtype"> <em>self</em>, </td>
579
<td class="paramname"></td>
581
<td class="memname"></td>
583
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
584
<td class="paramname"><em>other</em></td>
591
<td width="100%"> </td>
594
<div class="memdoc"><p>Comparison operator.
595
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this tag is lexically less than <b>other.</b>
597
</p></div></div><a class="anchor" name="obj165474508"></a>
598
<div class="memitem">
599
<div class="memproto">
600
<table class="memname"><tr>
601
<td class="memname">bool operator <=</td>
603
<td class="paramtype"> <em>self</em>, </td>
604
<td class="paramname"></td>
606
<td class="memname"></td>
608
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
609
<td class="paramname"><em>other</em></td>
616
<td width="100%"> </td>
619
<div class="memdoc"><p>Comparison operator.
620
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this tag is lexically less than or equal to <b>other.</b>
622
</p></div></div><a class="anchor" name="obj165476236"></a>
623
<div class="memitem">
624
<div class="memproto">
625
<table class="memname"><tr>
626
<td class="memname">bool operator ==</td>
628
<td class="paramtype"> <em>self</em>, </td>
629
<td class="paramname"></td>
631
<td class="memname"></td>
633
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
634
<td class="paramname"><em>other</em></td>
641
<td width="100%"> </td>
644
<div class="memdoc"><p>Comparison operator. Language tag comparisons are
648
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this tag and <b>other</b> are equal.
650
</p></div></div><a class="anchor" name="obj165476332"></a>
651
<div class="memitem">
652
<div class="memproto">
653
<table class="memname"><tr>
654
<td class="memname">bool operator ></td>
656
<td class="paramtype"> <em>self</em>, </td>
657
<td class="paramname"></td>
659
<td class="memname"></td>
661
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
662
<td class="paramname"><em>other</em></td>
669
<td width="100%"> </td>
672
<div class="memdoc"><p>Comparison operator.
673
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this tag is lexically greater than <b>other.</b>
675
</p></div></div><a class="anchor" name="obj164510412"></a>
676
<div class="memitem">
677
<div class="memproto">
678
<table class="memname"><tr>
679
<td class="memname">bool operator >=</td>
681
<td class="paramtype"> <em>self</em>, </td>
682
<td class="paramname"></td>
684
<td class="memname"></td>
686
<td class="paramtype"><a href="../soprano/Soprano.LanguageTag.html">Soprano.LanguageTag</a> </td>
687
<td class="paramname"><em>other</em></td>
694
<td width="100%"> </td>
697
<div class="memdoc"><p>Comparison operator.
698
<dl class="return" compact><dt><b>Returns:</b></dt><dd> true if this tag is lexically greater than or equal to <b>other.</b>
700
</p></div></div><a class="anchor" name="obj184138252"></a>
701
<div class="memitem">
702
<div class="memproto">
703
<table class="memname"><tr>
704
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> operator QString</td>
706
<td class="paramtype"> </td>
707
<td class="paramname"><em>self</em> )</td>
708
<td width="100%"> </td>
712
<div class="memdoc"><p>A convenience operator to convert this LanguageTag to a string.
715
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the string representation of this LanguageTag
719
</p></div></div><a class="anchor" name="obj186987724"></a>
720
<div class="memitem">
721
<div class="memproto">
722
<table class="memname"><tr>
723
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstringlist.html">QStringList</a> subTags</td>
725
<td class="paramtype"> </td>
726
<td class="paramname"><em>self</em> )</td>
727
<td width="100%"> </td>
731
<div class="memdoc"><p><dl class="return" compact><dt><b>Returns:</b></dt><dd> the subtag parts that make up this language tag
733
</p></div></div><a class="anchor" name="obj170475948"></a>
734
<div class="memitem">
735
<div class="memproto">
736
<table class="memname"><tr>
737
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qlocale.html">QLocale</a> toLocale</td>
739
<td class="paramtype"> </td>
740
<td class="paramname"><em>self</em> )</td>
741
<td width="100%"> </td>
745
<div class="memdoc"><p>Converts this LanguageTag to a locale, using the primary language
746
tag and first two-letter language subtag, if any.
747
If the conversion could not be performed, then the "C"
751
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the converted locale
754
<dl class="note" compact><dt><b>Note:</b></dt><dd> QLocale restricts the countries that can be paired with a
755
particular language. If the language-country pair in this tag
756
is not in the QLocale database, or if this language tag does not
757
contain country information, then the most appropriate country
758
will be used for the locale. For example, "de-US" (German as
759
spoken in the United States) is not a valid combination, and the
760
country would be changed to Germany.
762
</p></div></div><a class="anchor" name="obj184136684"></a>
763
<div class="memitem">
764
<div class="memproto">
765
<table class="memname"><tr>
766
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> toPrettyString</td>
768
<td class="paramtype"> </td>
769
<td class="paramname"><em>self</em> )</td>
770
<td width="100%"> </td>
774
<div class="memdoc"><p>Converts this LanguageTag to a string formatted according to the
775
case rules in RFC 4647 section 4.4 (page 44).
778
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the pretty string representation of this LanguageTag
780
</p></div></div><a class="anchor" name="obj184138380"></a>
781
<div class="memitem">
782
<div class="memproto">
783
<table class="memname"><tr>
784
<td class="memname"><a href="http://www.riverbankcomputing.co.uk/static/Docs/PyQt4/html/qstring.html">QString</a> toString</td>
786
<td class="paramtype"> </td>
787
<td class="paramname"><em>self</em> )</td>
788
<td width="100%"> </td>
792
<div class="memdoc"><p>Converts this LanguageTag to a string.
795
<dl class="return" compact><dt><b>Returns:</b></dt><dd> the string representation of this LanguageTag
797
</p></div></div><hr><h2>Enumeration Documentation</h2><a class="anchor" name="obj186803468"></a>
798
<div class="memitem">
799
<div class="memproto">
800
<table class="memname">
801
<tr><td class="memname">LookupFlag</td>
805
<div class="memdoc"><p>Flags for performing LanguageTag lookups.
809
</p><dl compact><dt><b>Enumerator: </b></dt><dd>
810
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>LookupFlagNone</em> = 0</td><td><tr><td valign="top"><em>LookupFlagNoFallback</em> = 1</td><td></table>
812
</div></div><p><a class="anchor" name="obj186804620"></a>
813
<div class="memitem">
814
<div class="memproto">
815
<table class="memname">
816
<tr><td class="memname">MatchFilter</td>
820
<div class="memdoc"><p>Represents basic language filtering as described in RFC 3066 section 2.5
821
(or RFC 4647 section 3.3.1). Basic language filtering checks only that the
822
range string is a prefix of a language tag and that the prefix is followed
823
by "-" or the end of the string. Additionally, the language range "*"
825
</p><dl compact><dt><b>Enumerator: </b></dt><dd>
826
<table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>MatchFilterBasic</em> = 0</td><td><tr><td valign="top"><em>MatchFilterExtended</em> = 1</td><td></table>
835
<div class="menu_box">
836
<div class="nav_list">
838
<li><a href="../allclasses.html">Full Index</a></li>
842
<a name="cp-menu" /><div class="menutitle"><div>
843
<h2 id="cp-menu-project">Modules</h2>
845
<div class="nav_list">
847
<li><a href="../akonadi/index.html">akonadi</a></li>
848
<li><a href="../dnssd/index.html">dnssd</a></li>
849
<li><a href="../kdecore/index.html">kdecore</a></li>
850
<li><a href="../kdeui/index.html">kdeui</a></li>
851
<li><a href="../khtml/index.html">khtml</a></li>
852
<li><a href="../kio/index.html">kio</a></li>
853
<li><a href="../knewstuff/index.html">knewstuff</a></li>
854
<li><a href="../kparts/index.html">kparts</a></li>
855
<li><a href="../kutils/index.html">kutils</a></li>
856
<li><a href="../nepomuk/index.html">nepomuk</a></li>
857
<li><a href="../phonon/index.html">phonon</a></li>
858
<li><a href="../plasma/index.html">plasma</a></li>
859
<li><a href="../polkitqt/index.html">polkitqt</a></li>
860
<li><a href="../solid/index.html">solid</a></li>
861
<li><a href="../soprano/index.html">soprano</a></li>
867
<div class="clearer"/>
870
<div id="end_body"></div>
872
<div id="footer"><div id="footer_text">
873
This documentation is maintained by <a href="mailto:simon@simonzone.com">Simon Edwards</a>.<br />
874
KDE<sup>®</sup> and <a href="../images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
875
<a href="http://www.kde.org/contact/impressum.php">Legal</a>