虚拟方法
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
集。 cancellable
-
类型:
GCancellable
可选的
GCancellable
对象,NULL
表示忽略。该参数可以 NULL
。由方法调用者拥有数据。 error
-
类型:
GError **
可恢复错误的返回位置。
该参数可以 NULL
。如果返回位置不为 NULL
,则必须将其初始化为NULL
GError*
。如果没有错误,虚拟功能将初始化参数为 NULL
。如果发生错误,将使用新分配的 GError
设置参数;调用者将获取数据的所有权,并负责释放它。
返回值
类型: GFileInfo
给定文件的GFileInfo
,或在错误发生时为NULL
。使用g_object_unref()释放返回的对象。
方法调用者将获取返回数据的所有权,并负责释放它。 |