Opens a directory for reading. The names of the files in the directory can then be retrieved using g_dir_read_name(). Note that the ordering is not defined.
This function is not directly available to language bindings.
The path to the directory you are interested in. On Unix in the on-disk encoding. On Windows in UTF-8
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
Currently must be set to 0. Reserved for future use.
The return location for a recoverable error.
The argument can be
If the return location is not
NULL, then you must initialize it to a
The argument will be left initialized to
NULLby the function 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.
A newly allocated
GDir on success,
NULL on failure.
NULL, you must free the result with
when you are finished with it.
|The data is owned by the called function.|