函数

GioFileAttributeMatchernew

声明 [源]

GFileAttributeMatcher*
g_file_attribute_matcher_new (
  const char* attributes
)

描述 [源]

创建一个新的文件属性匹配器，该匹配器将属性与给定的字符串匹配。GFileAttributeMatchers是引用计数的结构体，创建时引用计数为1。如果引用数降至0，则自动销毁GFileAttributeMatcher。

attributes字符串应使用双冒号分隔的特定键格式化，键与命名空间分开。可以将多个“namespace::key”字符串使用单个逗号连接（例如：“standard::type,standard::is-hidden”）。可以使用通配符“*”匹配所有键和命名空间，或者“namespace::*”将匹配给定命名空间中的所有键。

文件属性匹配器字符串及其结果的示例

  • "*"：匹配所有属性。
  • "standard::is-hidden"：仅匹配标准命名空间中的is-hidden键。
  • "standard::type,unix::*"：匹配标准命名空间中的type键和unix命名空间中的所有键。

参数

attributes

类型：const char*

匹配的属性字符串。

数据由函数的调用者拥有。
值是一个以null终止的UTF-8字符串。

返回值

类型：GFileAttributeMatcher

一个GFileAttributeMatcher。

函数的调用者拥有数据的所有权，并负责释放它。