方法

GioFileenumerate_children

声明 [源码]

GFileEnumerator*
g_file_enumerate_children (
  GFile* file,
  const char* attributes,
  GFileQueryInfoFlags flags,
  GCancellable* cancellable,
  GError** error
)

描述 [源码]

获取目录中文件的详细信息。结果是一个 GFileEnumerator 对象，它将为目录中的所有文件提供 GFileInfo 对象。

attributes 值是一个字符串，指定应收集的文件属性。如果无法从文件中读取特定请求的属性，则不会发生错误 - 它只是不会设置。 attributes 应该是属性或属性通配符的以逗号分隔的列表。通配符 “” 表示所有属性，就像通配符 “standard::” 表示标准命名空间中的所有属性。一个属性查询的例子可以是 “standard::*,owner::user”。标准属性作为定义可用，如 G_FILE_ATTRIBUTE_STANDARD_NAME。如果您计划在返回的枚举器上调用 g_file_enumerator_get_child() 或 g_file_enumerator_iterate()，则应始终指定 G_FILE_ATTRIBUTE_STANDARD_NAME。

如果 cancellable 不是 NULL，则可以通过从另一个线程触发可取消对象来取消操作。如果操作被取消，将返回错误 G_IO_ERROR_CANCELLED。

如果文件不存在，将返回错误 G_IO_ERROR_NOT_FOUND。如果文件不是目录，将返回错误 G_IO_ERROR_NOT_DIRECTORY。也可能有其他错误。

参数

attributes

类型： const char*

一个属性查询字符串。

数据由方法调用者拥有。

值是一个以 null 结尾的 UTF-8 字符串。

flags

类型： GFileQueryInfoFlags

GFileQueryInfoFlags 的一组。

cancellable

类型： GCancellable

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

参数可以为 NULL。

数据由方法调用者拥有。

error

类型： GError **

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

参数可以为 NULL。

如果返回位置不是 NULL，那么您必须将其初始化为 NULL GError*。

如果没有错误，方法将保留初始化为 NULL 的参数。

出错误时，参数将设置为新分配的 GError；调用者将拥有数据，并负责释放它。

返回值

类型： GFileEnumerator

如果成功，则返回一个 GFileEnumerator，错误时返回 NULL。使用 g_object_unref() 释放返回的对象。

方法的调用者将拥有返回的数据，并负责释放它。