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`
	`NULL`-terminated array of directories to search.
	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 `NULL`.
	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 `GKeyFileFlags`.
`error`	`GError **`
	The return location for a `GError*`, or `NULL`.

Return value

Returns:	`gboolean`
	`TRUE` if a key file could be loaded, `FALSE` otherwise.