FileT.enumerateChildren

Gets the requested information about the files in a directory. The result is a #GFileEnumerator object that will give out #GFileInfo 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. G_FILE_ATTRIBUTE_STANDARD_NAME should always be specified if you plan to call gio.file_enumerator.FileEnumerator.getChild or gio.file_enumerator.FileEnumerator.iterate on the returned enumerator.

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 gio.types.IOErrorEnum.Cancelled will be returned.

If the file does not exist, the gio.types.IOErrorEnum.NotFound error will be returned. If the file is not a directory, the gio.types.IOErrorEnum.NotDirectory error will be returned. Other errors are possible too.

Parameters

attributes string

an attribute query string

flags gio.types.FileQueryInfoFlags

a set of #GFileQueryInfoFlags

cancellable gio.cancellable.Cancellable

optional #GCancellable object, null to ignore

Return Value

Type: gio.file_enumerator.FileEnumerator

A #GFileEnumerator if successful, null on error. Free the returned object with gobject.object.ObjectG.unref.