Method

GLibKeyFileget_locale_for_key

Declaration

gchar*
g_key_file_get_locale_for_key (
  GKeyFile* key_file,
  const gchar* group_name,
  const gchar* key,
  const gchar* locale
)

Description

Returns the actual locale which the result of g_key_file_get_locale_string() or g_key_file_get_locale_string_list() came from.

If calling g_key_file_get_locale_string() or g_key_file_get_locale_string_list() with exactly the same key_file, group_name, key and locale, the result of those functions will have originally been tagged with the locale that is the result of this function.

Available since:2.56

Parameters

group_name const gchar*
 

A group name.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
key const gchar*
 

A key.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
locale const gchar*
 

A locale identifier or NULL.

 The argument can be NULL.
 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.

Return value

Returns: utf8
 

The locale from the file, or NULL if the key was not found or the entry in the file was was untranslated.

 The caller of the method takes ownership of the data, and is responsible for freeing it.
 The return value can be NULL.
 The string is a NUL terminated UTF-8 string.