类

GioFileInfo

描述 [源码]

final class Gio.FileInfo : GObject.Object
{
  /* No available fields */
}

存储由GFile引用的文件系统对象的信息。

用于操作文件的元数据的基本功能。GFileInfo实现了获取所有文件都应该包含的信息的方法，并允许操作扩展属性。

有关GIO如何处理文件属性的更多信息，请参阅文件属性文档。

要获取GFile的GFileInfo，请使用g_file_query_info()（或其异步变体）。要获取文件输入或输出流的GFileInfo，请使用g_file_input_stream_query_info()或g_file_output_stream_query_info()（或它们的异步变体）。

要更改文件的实际属性，您应在GFileInfo中设置属性，并在GFile上调用g_file_set_attributes_from_info()或g_file_set_attributes_async()。

但是，并非所有属性都可以更改。例如，无法通过g_file_info_set_size()更改文件的实际大小。您可以通过调用g_file_query_settable_attributes()和g_file_query_writable_namespaces()在运行时发现特定文件的可设置属性。

直接访问器，如g_file_info_get_name()，比通用属性访问器（如g_file_info_get_attribute_byte_string()）稍加优化。只有当在紧密循环中调用API时，此优化才会产生影响。

在创建GFileInfo时没有指定其所需文件属性时调用这些访问器是错误的。使用g_file_info_has_attribute()或g_file_info_list_attributes()检查为GFileInfo指定的属性。

GFileAttributeMatcher允许搜索GFileInfo中的属性。

祖先

构造函数

g_file_info_new

创建一个新的文件信息结构。

实例方法

g_file_info_clear_status

清除info中的状态信息。

g_file_info_copy_into

首先清除dest_info中的所有[GFileAttribute][gio-GFileAttribute]，然后将所有文件属性从src_info复制到dest_info。

g_file_info_dup

复制文件信息结构。

g_file_info_get_access_date_time

获取当前info的访问时间，并以GDateTime形式返回。

since: 2.70

g_file_info_get_attribute_as_string

获取属性值，以字符串格式。需要时逃逸内容以使字符串有效UTF-8。

g_file_info_get_attribute_boolean

获取布尔属性值。如果属性不包含布尔值，则返回FALSE。

g_file_info_get_attribute_byte_string

获取字节数组属性值。如果属性不包含字节数组，则返回NULL。

g_file_info_get_attribute_data

获取属性键的属性类型、值和状态。

g_file_info_get_attribute_file_path

获取字节数组属性值作为文件路径。

since: 2.78

g_file_info_get_attribute_int32

获取属性中包含的32位有符号整数。如果属性不包含32位有符号整数或无效，则返回0。

g_file_info_get_attribute_int64

获取属性中的有符号64位整数值。如果属性不包含有符号64位整数或者无效，则返回0。

g_file_info_get_attribute_object

获取一个GObject属性值。如果属性不包含GObject，则返回NULL。

g_file_info_get_attribute_status

获取一个属性键的属性状态。

g_file_info_get_attribute_string

获取字符串属性的值。如果属性不包含字符串，则返回NULL。

g_file_info_get_attribute_stringv

获取字符串v属性的值。如果属性不包含字符串v，则返回NULL。

自版本2.22起

g_file_info_get_attribute_type

获取一个属性键的属性类型。

g_file_info_get_attribute_uint32

获取属性中的无符号32位整数值。如果属性不包含无符号32位整数或者无效，则返回0。

g_file_info_get_attribute_uint64

获取属性中的无符号64位整数值。如果属性不包含无符号64位整数或者无效，则返回0。

g_file_info_get_content_type

获取文件的类型。

g_file_info_get_creation_date_time

获取当前info的创建时间，并以GDateTime返回。

since: 2.70

g_file_info_get_deletion_date

返回表示文件删除日期的GDateTime，来自G_FILE_ATTRIBUTE_TRASH_DELETION_DATE。如果G_FILE_ATTRIBUTE_TRASH_DELETION_DATE属性未设置，则返回NULL。

自版本2.36起

g_file_info_get_display_name

获取文件的显示名称。这保证了总是设置。

g_file_info_get_edit_name

获取文件的编辑名称。

g_file_info_get_etag

获取特定GFileInfo的实体标签。参见G_FILE_ATTRIBUTE_ETAG_VALUE。

g_file_info_get_file_type

获取文件类型（是否为普通文件、符号链接等）。这不同于文件的类型，参见g_file_info_get_content_type()。

g_file_info_get_icon

获取文件的图标。

g_file_info_get_is_backup

检查文件是否是备份文件。

g_file_info_get_is_hidden

检查文件是否隐藏。

g_file_info_get_is_symlink

检查文件是否是符号链接。

g_file_info_get_modification_date_time

获取当前info的修改时间，并以GDateTime返回。

自版本2.62起

g_file_info_get_modification_time

获取当前info的修改时间，并将其设置在result中。

已弃用：2.62 

g_file_info_get_name

获取文件的名称。这保证了总是设置。

g_file_info_get_size

获取文件的大小（字节数）。大小是通过G_FILE_ATTRIBUTE_STANDARD_SIZE属性的值检索的，并在返回结果之前从#guint64转换为#goffset。

g_file_info_get_sort_order

从GFileInfo获取sort_order属性的值。参见G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER。

g_file_info_get_symbolic_icon

获取文件的符号图标。

自版本2.34起

g_file_info_get_symlink_target

获取特定GFileInfo的符号链接目标。

g_file_info_has_attribute

检查文件信息结构是否有名为attribute的属性。

g_file_info_has_namespace

检查文件信息结构是否有在指定的name_space中的属性。

自版本2.22起

g_file_info_list_attributes

列出文件信息结构的属性。

g_file_info_remove_attribute

如果存在，从 info 中移除所有 attribute 的实例。

g_file_info_set_access_date_time

将文件信息中的 G_FILE_ATTRIBUTE_TIME_ACCESS 和 G_FILE_ATTRIBUTE_TIME_ACCESS_USEC 属性设置为给定的日期/时间值。

since: 2.70

g_file_info_set_attribute

尽可能将 attribute 设置为包含给定的值。要取消属性，请将 type 设置为 G_FILE_ATTRIBUTE_TYPE_INVALID。

g_file_info_set_attribute_boolean

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_attribute_byte_string

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_attribute_file_path

如果可能，将 attribute 设置为包含给定的 attr_value。

since: 2.78

g_file_info_set_attribute_int32

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_attribute_int64

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_attribute_mask

设置 info 上的 mask 以匹配特定的属性类型。

g_file_info_set_attribute_object

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_attribute_status

设置属性键的属性状态。这仅由实现 g_file_set_attributes_from_info() 或类似函数的外部代码需要。

自版本2.22起

g_file_info_set_attribute_string

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_attribute_stringv

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_attribute_uint32

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_attribute_uint64

如果可能，将 attribute 设置为包含给定的 attr_value。

g_file_info_set_content_type

为给定的 GFileInfo 设置内容类型属性。请参阅 G_FILE_ATTRIBUTE_STANDARD_CONTENT_TYPE。

g_file_info_set_creation_date_time

将文件信息中的 G_FILE_ATTRIBUTE_TIME_CREATED 和 G_FILE_ATTRIBUTE_TIME_CREATED_USEC 属性设置为给定的日期/时间值。

since: 2.70

g_file_info_set_display_name

为当前的 GFileInfo 设置显示名称。请参阅 G_FILE_ATTRIBUTE_STANDARD_DISPLAY_NAME。

g_file_info_set_edit_name

为当前文件设置编辑名称。请参阅 G_FILE_ATTRIBUTE_STANDARD_EDIT_NAME。

g_file_info_set_file_type

将 GFileInfo 中的文件类型设置为 type。请参阅 G_FILE_ATTRIBUTE_STANDARD_TYPE。

g_file_info_set_icon

为给定的 GFileInfo 设置图标。请参阅 G_FILE_ATTRIBUTE_STANDARD_ICON。

g_file_info_set_is_hidden

根据 is_hidden 设置 GFileInfo 中的“is_hidden”属性。请参阅 G_FILE_ATTRIBUTE_STANDARD_IS_HIDDEN。

g_file_info_set_is_symlink

根据 is_symlink 设置 GFileInfo 中的“is_symlink”属性。请参阅 G_FILE_ATTRIBUTE_STANDARD_IS_SYMLINK。

g_file_info_set_modification_date_time

将文件信息中的 G_FILE_ATTRIBUTE_TIME_MODIFIED 和 G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC 属性设置为给定的日期/时间值。

自版本2.62起

g_file_info_set_modification_time

将文件信息中的 G_FILE_ATTRIBUTE_TIME_MODIFIED 和 G_FILE_ATTRIBUTE_TIME_MODIFIED_USEC 属性设置为给定的时值。

已弃用：2.62 

g_file_info_set_name

为当前的 GFileInfo 设置名称属性。请参阅 G_FILE_ATTRIBUTE_STANDARD_NAME。

g_file_info_set_size

将文件信息中的 G_FILE_ATTRIBUTE_STANDARD_SIZE 属性设置为给定的 size。

g_file_info_set_sort_order

在文件信息结构中设置排序顺序属性。请参阅 G_FILE_ATTRIBUTE_STANDARD_SORT_ORDER。

g_file_info_set_symbolic_icon

为给定的 GFileInfo 设置符号图标。请参阅 G_FILE_ATTRIBUTE_STANDARD_SYMBOLIC_ICON。

自版本2.34起

g_file_info_set_symlink_target

将文件信息中的 G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET 属性设置为给定的符号链接目标。

g_file_info_unset_attribute_mask

如果已设置，取消由 g_file_info_set_attribute_mask() 设置的 mask。

从 GObject 继承的方法（43）

请参阅 GObject 获取方法列表。

信号

从 GObject 继承的信号（1）
GObject::notify

当对象中的一个属性通过 g_object_set_property(), g_object_set() 等设置其值时，将发出 notify 信号。

类结构 

struct GioFileInfoClass {
  /* no available fields */
}

无描述可用。