Method
GLibKeyFileget_boolean_list
since: 2.6
Declaration
gboolean*
g_key_file_get_boolean_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 as booleans.
If key cannot be found then NULL is returned and error is set to
G_KEY_FILE_ERROR_KEY_NOT_FOUND. Likewise, if the values associated
with key cannot be interpreted as booleans then NULL is returned
and error is set to G_KEY_FILE_ERROR_INVALID_VALUE.
Available since: 2.6
Parameters
group_name-
Type:
const gchar*A group name.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. key-
Type:
const gchar*A key.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. length-
Type:
gsize*The number of booleans returned.
The argument will be set by the function. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will be left initialized to NULLby the method if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: An array of gboolean
the values associated with the key as a list of booleans, or NULL if the
key was not found or could not be parsed. The returned list of booleans
should be freed with g_free() when no longer needed.
The length of the array is in the length argument. |
| The caller of the method takes ownership of the data container, but not the data inside it. |