get_locale_string_list


Description:

[ CCode ( array_length_type = "gsize" ) ]
public string[] get_locale_string_list (string group_name, string key, string? locale = null) throws KeyFileError

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 KeyFile, 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 throws is set to 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 return.length may optionally be null.

Parameters:

this

a KeyFile

group_name

a group name

key

a key

locale

a locale identifier or null

length

return location for the number of returned strings or null

Returns:

a newly allocated null-terminated string array or null if the key isn't found. The string array should be freed with strfreev.