### Struct

# Gio FileAttributeMatcher

#### Description

    struct GFileAttributeMatcher {
      /* No available fields */
    }

Determines if a string matches a file attribute.

#### Constructors

###### g_file_attribute_matcher_new

Creates a new file attribute matcher, which matches attributes against a given string. `GFileAttributeMatchers` are reference counted structures, and are created with a reference count of 1. If the number of references falls to 0, the `GFileAttributeMatcher` is automatically destroyed.

#### Instance methods

###### g_file_attribute_matcher_enumerate_namespace

Checks if the matcher will match all of the keys in a given namespace. This will always return `TRUE` if a wildcard character is in use (e.g. if matcher was created with “standard::” and `ns` is “standard”, or if matcher was created using “” and namespace is anything.).

###### g_file_attribute_matcher_enumerate_next

Gets the next matched attribute from a `GFileAttributeMatcher`.

###### g_file_attribute_matcher_matches

Checks if an attribute will be matched by an attribute matcher. If the matcher was created with the “*” matching string, this function will always return `TRUE`.

###### g_file_attribute_matcher_matches_only

Checks if an attribute matcher only matches a given attribute. Always returns `FALSE` if “*” was used when creating the matcher.

###### g_file_attribute_matcher_ref

References a file attribute matcher.

###### g_file_attribute_matcher_subtract

Subtracts all attributes of `subtract` from `matcher` and returns a matcher that supports those attributes.

###### g_file_attribute_matcher_to_string

Prints what the matcher is matching against. The format will be equal to the format passed to g_file_attribute_matcher_new(). The output however, might not be identical, as the matcher may decide to use a different order or omit needless parts.

since: 2.32

###### g_file_attribute_matcher_unref

Unreferences `matcher`. If the reference count falls below 1, the `matcher` is automatically freed.