Method
GLibKeyFileget_locale_string_list
Declaration
gchar**
g_key_file_get_locale_string_list (
GKeyFile* key_file,
const gchar* group_name,
const gchar* key,
const gchar* locale,
gsize* length,
GError** error
)
Description
Returns the values 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 values associated
with key
cannot be interpreted or no suitable translations
can be found then the untranslated values are returned. The
returned array is NULL
-terminated, so length
may optionally
be NULL
.
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. | |
length |
gsize* |
Return location for the number of returned strings or |
|
The argument will be set by the function. | |
The argument can be NULL . | |
error |
GError ** |
The return location for a GError* , or NULL . |
Return value
Returns: | An array of utf8 |
A newly allocated |
|
The array is NULL -terminated. | |
The length of the array is in the length argument. | |
The caller of the method takes ownership of the data, and is responsible for freeing it. | |
Each element is a NUL terminated UTF-8 string. |