pango.Language
pango.Language — an object that represents a language tag.
Synopsis
class pango.Language(gobject.GBoxed): |
Functionsdef pango.pango_language_from_string(
language
)def pango.pango_language_matches(
language
,range_list
)
Description
A pango.Language
object represents a language tag meeting the RFC-3066 standard. The pango.Language
can be retrieved from a pango.Context
by
using the pango.Context.get_language
()
method or created using the pango.Language() constructor.
Example RFC-3066 language tags include: "en-us", "fr", and
"sgn-us-ma".
Constructor
pango.Language(language
>)
| a string representing a language tag |
Returns : | a new pango.Language
object |
Note
This constructor is available in PyGTK 2.4 and above.
Creates a new pango.Language
object from the RFC-3066 language tag specified by
language
. This constructor first canonicalizes the
string in language
by converting it to lowercase,
mapping '_' to '-', and stripping all characters other than letters and
'-'.
Methods
pango.Language.matches
def matches(range_list
)
| a list of language ranges, separated by ';' characters. |
Returns : | True if a match was
found. |
Note
This method is available in PyGTK 2.4 and above.
The matches
() method returns
True
if the language matches one of the language ranges
in the list specified by range_list
.A language tag is
considered to match a range in the list if
- the range is '*'
- the range is exactly the same as the tag, or
- the range is a prefix of the tag, and the character after the matching portion of the tag is '-'
each range must either be '*', or a canonicalized RFC-3066 language range (see the pango.Language() constructor for more information).
pango.Language.matches
def to_string()
Returns : | the string representation of the language tag |
Note
This method is available in PyGTK 2.4 and above.
The to_string
() method returns a string
representation of the canonicalized language tag. See the pango.Language() constructor for
more information.
Functions
pango.pango_language_from_string
def pango.pango_language_from_string(language
)
| a string representing a language tag |
Returns : | a new pango.Language
object |
Note
This function is deprecated in PyGTK 2.4 and above. Use the pango.Language() constructor instead.
The pango.pango_language_from_string
()
function takes a RFC-3066 format language tag as a string (specified by
language
) and converts it to a pango.Language
object. This function first canonicalizes the string by converting it to
lowercase, mapping '_' to '-', and stripping all characters other than
letters and '-'.
pango.pango_language_matches
def pango.pango_language_matches(
)
| a language tag (see the pango.pango_language_from_string ()
function), None is allowed and matches nothing
but '*' |
| a list of language ranges, separated by ';'
characters. each element must either be '*', or a RFC 3066
language range canonicalized as by the pango.pango_language_from_string ()
function. |
Returns : | True if a match was
found. |
Note
This function is deprecated in PyGTK 2.4 and above. Use the
matches
()
method instead.
The pango.pango_language_matches
() function
checks if a language tag matches one of the elements in a list of language
ranges. A language tag is considered to match a range in the list if the
range is '*', the range is exactly the tag, or the range is a prefix of the
tag, and the character after the tag is '-'.