Method
GLibKeyFileget_string_list
Declaration
gchar**
g_key_file_get_string_list (
GKeyFile* key_file,
const gchar* group_name,
const gchar* key,
gsize* length,
GError** error
)
Description
Returns the values associated with key
under group_name
.
In the event the key cannot be found, NULL
is returned and
error
is set to G_KEY_FILE_ERROR_KEY_NOT_FOUND
. In the
event that the group_name
cannot be found, NULL
is returned
and error
is set to G_KEY_FILE_ERROR_GROUP_NOT_FOUND
.
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. | |
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 |
|
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. |