方法
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 。 |