Gio.File::enumerate_children

function vfunc_enumerate_children(attributes: String, flags: Gio.FileQueryInfoFlags, cancellable: Gio.Cancellable): Gio.FileEnumerator {
}
  

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 Gio.IOErrorEnum.cancelled will be returned.

If the file does not exist, the Gio.IOErrorEnum.not_found error will be returned. If the file is not a directory, the Gio.IOErrorEnum.not_directory error will be returned. Other errors are possible too.

attributes

an attribute query string

flags

a set of Gio.FileQueryInfoFlags

cancellable

optional Gio.Cancellable object, null to ignore

Returns

A Gio.FileEnumerator if successful, null on error. Free the returned object with GObject.Object.prototype.unref.