Viewing file: babel.support.Translations-class.html (22.91 KB) -rw-r--r-- Select action/file-type: (+ ) | (+ ) | (+ ) | Code (+ ) | Session (+ ) | (+ ) | SDB (+ ) | (+ ) | (+ ) | (+ ) | (+ ) | (+ ) |
babel.support.Translations
Class Translations
gettext.NullTranslations --+
|
gettext.GNUTranslations --+
|
object --+
|
Translations
An extended translation catalog class.
__init__ (self ,
fileobj =None ,
domain ='
messages
'
)
Initialize the translations catalog.
Translations
add (self ,
translations ,
merge =True )
Add the given translations to the catalog.
Translations
merge (self ,
translations )
Merge the given translations into the catalog.
dgettext (self ,
domain ,
message )
Like gettext() , but look the message up in the specified
domain.
ldgettext (self ,
domain ,
message )
Like lgettext() , but look the message up in the specified
domain.
dugettext (self ,
domain ,
message )
Like ugettext() , but look the message up in the specified
domain.
dngettext (self ,
domain ,
singular ,
plural ,
num )
Like ngettext() , but look the message up in the specified
domain.
ldngettext (self ,
domain ,
singular ,
plural ,
num )
Like lngettext() , but look the message up in the specified
domain.
dungettext (self ,
domain ,
singular ,
plural ,
num )
Like ungettext() but look the message up in the specified
domain.
Inherited from gettext.GNUTranslations
:
gettext
,
lgettext
,
lngettext
,
ngettext
,
ugettext
,
ungettext
Inherited from gettext.NullTranslations
:
add_fallback
,
charset
,
info
,
install
,
output_charset
,
set_output_charset
Inherited from object
:
__delattr__
,
__format__
,
__getattribute__
,
__hash__
,
__new__
,
__reduce__
,
__reduce_ex__
,
__setattr__
,
__sizeof__
,
__str__
,
__subclasshook__
Translations
load (cls ,
dirname =None ,
locales =None ,
domain ='
messages
'
)
Load translations from the given directory.
DEFAULT_DOMAIN = '
messages
'
Inherited from gettext.GNUTranslations
:
BE_MAGIC
,
LE_MAGIC
Inherited from object
:
__class__
__init__ (self ,
fileobj =None ,
domain ='
messages
'
)
(Constructor)
Initialize the translations catalog.
Parameters:
fileobj
- the file-like object the translation should be read
from
Overrides:
object.__init__
load (cls ,
dirname =None ,
locales =None ,
domain ='
messages
'
)
Class Method
Load translations from the given directory.
Parameters:
dirname
- the directory containing the MO files
locales
- the list of locales in order of preference (items in
this list can be either Locale objects or locale
strings)
domain
- the message domain
Returns: Translations
the loaded catalog, or a NullTranslations instance if no
matching translations were found
__repr__ (self )
(Representation operator)
repr(x)
Overrides:
object.__repr__
(inherited documentation)
add (self ,
translations ,
merge =True )
Add the given translations to the catalog.
If the domain of the translations is different than that of the
current catalog, they are added as a catalog that is only accessible
by the various d*gettext functions.
Parameters:
translations
- the Translations instance with the messages to
add
merge
- whether translations for message domains that have
already been added should be merged with the existing
translations
Returns: Translations
the Translations instance (self ) so that merge calls
can be easily chained
merge (self ,
translations )
Merge the given translations into the catalog.
Message translations in the specified catalog override any messages
with the same identifier in the existing catalog.
Parameters:
translations
- the Translations instance with the messages to
merge
Returns: Translations
the Translations instance (self ) so that merge calls
can be easily chained