next_file


Description:

public virtual FileInfo? next_file (Cancellable? cancellable = null) throws Error

Returns information for the next file in the enumerated object.

Will block until the information is available. The FileInfo returned from this function will contain attributes that match the attribute string that was passed when the FileEnumerator was created.

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

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

Parameters:

this

a FileEnumerator.

cancellable

optional Cancellable object, null to ignore.

Returns:

A FileInfo or null on error or end of enumerator. Free the returned object with unref when no longer needed.