An opaque structure representing an opened directory.
Parameters: tmpl (
None) – Template for directory name, as in g_mkdtemp(), basename only, or
Nonefor a default template
Returns: The actual name used. This string should be freed with
GLib.free() when not needed any longer and is is in the GLib file name encoding. In case of errors,
Noneis returned and error will be set.
Creates a subdirectory in the preferred directory for temporary files (as returned by
tmpl should be a string in the GLib file name encoding containing a sequence of six ‘X’ characters, as the parameter to g_mkstemp(). However, unlike these functions, the template should only be a basename, no directory components are allowed. If template is
None, a default template is used.
Note that in contrast to g_mkdtemp() (and mkdtemp()) tmpl is not modified, and might thus be a read-only literal string.
New in version 2.30.
Closes the directory and deallocates all related resources.
Returns: The entry’s name or
Noneif there are no more entries. The return value is owned by GLib and must not be modified or freed.
Retrieves the name of another entry in the directory, or
None. The order of entries returned from this function is not defined, and may vary by file system or other operating-system dependent factors.
On Unix, the ‘.’ and ‘..’ entries are omitted, and the returned name is in the on-disk encoding.
On Windows, as is true of all GLib functions which operate on filenames, the returned name is in UTF-8.