虚拟方法

GioFileEnumeratornext_file

声明 [src]

GFileInfo*
next_file (
  GFileEnumerator* enumerator,
  GCancellable* cancellable,
  GError** error
)

描述 [src]

返回枚举对象的下一个文件的信息。将阻塞，直到信息可用。此函数从返回的 GFileInfo 将包含与在创建 GFileEnumerator 时传递的属性字符串匹配的属性。

关于返回文件的顺序，请参阅 GFileEnumerator 的文档。

发生错误时，返回 NULL 并将 error 设置为错误。如果枚举器已到达末尾，将返回 NULL 并将 error 清除。

参数

cancellable

类型： GCancellable

可选的 GCancellable 对象，NULL 表示忽略。

此参数可以是 NULL。
数据由方法的调用者拥有。
error

类型： GError **

用于可恢复错误的返回位置。

此参数可以是 NULL。
如果返回位置不是 NULL，那么您必须将其初始化为 NULL GError*。
如果虚拟函数没有错误，则参数将保留初始化为 NULL。
如果有错误，将参数设置为新分配的 GError；调用者将接管数据，并负责释放它。

返回值

类型： GFileInfo

返回一个 GFileInfo 或在发生错误或枚举器结束时返回 NULL。当不再需要时，使用 g_object_unref() 释放返回的对象。

方法调用者接管返回的数据，并负责释放它。
返回值可以为 NULL。