null on error. Free the returned object with [gobject.object.ObjectWrap.unref].
File.enumerateChildren
gio.file_enumerator.FileEnumerator enumerateChildren(string attributes, gio.types.FileQueryInfoFlags flags, gio.cancellable.Cancellable cancellable = null)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 [gio.types.FILE_ATTRIBUTE_STANDARD_NAME]. [gio.types.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 | an attribute query string |
flags | a set of #GFileQueryInfoFlags |
cancellable | optional #GCancellable object, null to ignore |