Method
GLibKeyFileload_from_dirs
Declaration
gboolean
g_key_file_load_from_dirs (
GKeyFile* key_file,
const gchar* file,
const gchar** search_dirs,
gchar** full_path,
GKeyFileFlags flags,
GError** error
)
Description
This function looks for a key file named file
in the paths
specified in search_dirs
, loads the file into key_file
and
returns the file’s full path in full_path
.
If the file could not be found in any of the search_dirs
,
G_KEY_FILE_ERROR_NOT_FOUND
is returned. If
the file is found but the OS returns an error when opening or reading the
file, a G_FILE_ERROR
is returned. If there is a problem parsing the file, a
G_KEY_FILE_ERROR
is returned.
Available since: | 2.14 |
Parameters
file |
const gchar* |
A relative path to a filename to open and parse. |
|
The data is owned by the caller of the function. | |
The value is a file system path, using the OS encoding. | |
search_dirs |
An array of filename |
|
|
The array must be NULL -terminated. | |
The data is owned by the caller of the function. | |
Each element is a file system path, using the OS encoding. | |
full_path |
gchar** |
Return location for a string containing the full path
of the file, or |
|
The argument will be set by the function. | |
The argument can be NULL . | |
The instance takes ownership of the data, and is responsible for freeing it. | |
The value is a file system path, using the OS encoding. | |
flags |
GKeyFileFlags |
Flags from |
|
error |
GError ** |
The return location for a GError* , or NULL . |