FileT.enumerateChildren

Gets the requested information about the files in a directory. The result is a gio.FileEnumerator object that will give out gio.FileInfo objects for all the files in the directory.

The attributes value is a string that specifies the file attributes that should be gathered. It is not an error if it's not possible to read a particular requested attribute from a file - it just won't be set. attributes should be a comma-separated list of attributes or attribute wildcards. The wildcard "*" means all attributes, and a wildcard like "standard::*" means all attributes in the standard namespace. An example attribute query be "standard::*,owner::user". The standard attributes are available as defines, like G_FILE_ATTRIBUTE_STANDARD_NAME

If cancellable is not NULL, then the operation can be cancelled by triggering the cancellable object from another thread. If the operation was cancelled, the error G_IO_ERROR_CANCELLED will be returned.

If the file does not exist, the G_IO_ERROR_NOT_FOUND error will be returned. If the file is not a directory, the G_IO_ERROR_NOT_DIRECTORY error will be returned. Other errors are possible too.

template FileT(TStruct)
enumerateChildren

Parameters

attributes string

an attribute query string

flags GFileQueryInfoFlags
cancellable Cancellable

optional gio.Cancellable object, NULL to ignore

Return Value

A gio.FileEnumerator if successful, NULL on error. Free the returned object with g_object_unref().

Throws

GException on failure.