Package: glib

Function glib:key-file-locale-string-list

Lambda List

glib:key-file-locale-string-list (keyfile group key &optional locale)

Syntax

(g:key-file-locale-string-list keyfile group key locale) => value
(setf (g:key-file-locale-string-list keyfile group key locale) value)

Arguments

keyfile -- a g:key-file instance
group -- a string with the group name
key -- a string with the key name
locale -- a string for the locale identifier
value -- a list of strings

Details

The g:key-file-locale-string-list function returns the values associated with key under group translated in the given locale if available. If the locale argument is nil, the default, then the current locale is assumed.

The (setf g:key-file-locale-string-list) function associates a list of string values for key and locale under group. If the translation for key cannot be found then it is created.

If the locale argument is to be not nil, or if the current locale will change over the lifetime of the g:key-file instance, it must be loaded with the :keep-translations value for the g:key-file-flags flags in order to load strings for all locales.

If the key argument cannot be found then nil is returned. If the values associated with key cannot be interpreted or no suitable translations can be found then the untranslated values are returned.
 

See also

2025-1-12