方法

GioFileEnumeratornext_file

声明 [源代码]

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

描述 [源代码]

返回枚举对象的下一个文件的信息。将在信息可用前阻塞。从该功能返回的GFileInfo将包含与创建GFileEnumerator时传递的属性字符串匹配的属性。

有关返回文件的顺序信息,请参阅GFileEnumerator的文档。

如果发生错误,返回NULL并将错误设置为错误。如果枚举器位于末尾,则返回NULL并将错误清除。

参数

cancellable

类型: GCancellable

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

参数可以为NULL
数据由方法调用者所有。
error

类型: GError **

可恢复错误的返回位置。

参数可以为NULL
如果返回位置不为NULL,则必须将其初始化为NULL GError*
如果没有错误,方法将使用NULL初始化该参数。
如果发生错误,该参数将被设置为一个新的GError;调用者将接管数据,并负责释放它。

返回值

类型: GFileInfo

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

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