虚拟方法

GioFilequery_info

声明 [src]

GFileInfo*
query_info (
  GFile* file,
  const char* attributes,
  GFileQueryInfoFlags flags,
  GCancellable* cancellable,
  GError** error
)

说明 [src]

获取指定文件的控制信息。返回的结果是一个包含键值属性的GFileInfo对象,如文件类型或大小。

attributes值是一个字符串,指定了要收集的文件属性。如果无法从文件中读取特定请求的属性,不会发生错误 - 只是它不会被设置。attributes应是一个属性或属性通配符的逗号分隔列表。通配符“”表示所有属性,而像“standard::”这样的通配符表示标准命名空间中的所有属性。一个示例属性查询可以是“standard::*,owner::user”。标准属性可作为定义提供,如G_FILE_ATTRIBUTE_STANDARD_NAME

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

对于符号链接,通常返回符号链接目标的信息,而不是符号链接本身的信息。但是,如果您在flags中传递G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS,则将返回符号链接本身的信息。此外,对于指向不存在文件的符号链接,也将返回符号链接本身的信息。

如果文件不存在,将返回错误G_IO_ERROR_NOT_FOUND。也可能存在其他错误,这些错误取决于文件所在的文件系统类型。

参数

attributes

类型: const char*

一个属性查询字符串。

由方法调用者拥有数据。
值是NUL终止的UTF-8字符串。
flags

类型: GFileQueryInfoFlags

GFileQueryInfoFlags集。

cancellable

类型: GCancellable

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

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

类型: GError **

可恢复错误的返回位置。

该参数可以NULL
如果返回位置不为NULL,则必须将其初始化为NULL GError*
如果没有错误,虚拟功能将初始化参数为NULL
如果发生错误,将使用新分配的GError设置参数;调用者将获取数据的所有权,并负责释放它。

返回值

类型: GFileInfo

给定文件的GFileInfo,或在错误发生时为NULL。使用g_object_unref()释放返回的对象。

方法调用者将获取返回数据的所有权,并负责释放它。