Method
GLibKeyFileget_locale_string
Declaration
gchar*
g_key_file_get_locale_string (
GKeyFile* key_file,
const gchar* group_name,
const gchar* key,
const gchar* locale,
GError** error
)
Description
Returns the value associated with key
under group_name
translated in the given locale
if available. If locale
is
NULL
then the current locale is assumed.
If locale
is to be non-NULL
, or if the current locale will change over
the lifetime of the GKeyFile
, it must be loaded with
G_KEY_FILE_KEEP_TRANSLATIONS
in order to load strings for all locales.
If key
cannot be found then NULL
is returned and error
is set
to G_KEY_FILE_ERROR_KEY_NOT_FOUND
. If the value associated
with key
cannot be interpreted or no suitable translation can
be found then the untranslated value is returned.
Available since: | 2.6 |
Parameters
group_name |
const gchar* |
A group name. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
key |
const gchar* |
A key. |
|
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
locale |
const gchar* |
A locale identifier or |
|
The argument can be NULL . | |
The data is owned by the caller of the function. | |
The value is a NUL terminated UTF-8 string. | |
error |
GError ** |
The return location for a GError* , or NULL . |