FileEnumerator.nextFile

Returns information for the next file in the enumerated object. Will block until the information is available. The gio.FileInfo returned from this function will contain attributes that match the attribute string that was passed when the gio.FileEnumerator was created.

See the documentation of gio.FileEnumerator for information about the order of returned files.

On error, returns NULL and sets error to the error. If the enumerator is at the end, NULL will be returned and error will be unset.

class FileEnumerator
nextFile

Parameters

cancellable Cancellable

optional gio.Cancellable object, NULL to ignore.

Return Value

Type: FileInfo

A gio.FileInfo or NULL on error or end of enumerator. Free the returned object with g_object_unref() when no longer needed.

Throws

GException on failure.