方法
GioFilequery_info
声明 [src]
GFileInfo*
g_file_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。
对于符号链接，通常返回符号链接目标的信息，而不是符号链接本身的信息。但是，如果您将G_FILE_QUERY_INFO_NOFOLLOW_SYMLINKS传递到flags中，则将返回符号链接本身的信息。此外，对于指向非现有文件的符号链接，将返回符号链接本身的信息。
如果文件不存在，将返回错误G_IO_ERROR_NOT_FOUND。也可能发生其他错误，这些都取决于文件所在的文件系统类型。
参数
attributes-
类型：
const char*一个属性查询字符串。
数据由方法的调用者拥有。 值是一个以NUL结尾的UTF-8字符串。 flags-
一组
GFileQueryInfoFlags。 cancellable-
类型：
GCancellable可选的
GCancellable对象，NULL表示忽略。该参数可以为 NULL。数据由方法的调用者拥有。 error-
类型：
GError **用于可恢复错误的返回位置。
该参数可以为 NULL。如果返回位置不为 NULL，则必须将其初始化为NULLGError*。如果没有错误，方法将保留参数初始化为 NULL。在出现错误的情况下，参数将被设置为一个新的 GError；调用者将接管数据，并负责释放它。
返回值
类型： GFileInfo
给定文件的GFileInfo，或者在出现错误时为NULL。使用g_object_unref()释放返回的对象。
| 方法的调用者将接管返回的数据，并负责释放它。 |