Gio.FileAttributeMatcher.new

function new(attributes: String): Gio.FileAttributeMatcher {
    // Gjs wrapper for 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 Gio.FileAttributeMatcher is automatically destroyed.

The @attribute string should be formatted with specific keys separated from namespaces with a double colon. Several "namespace::key" strings may be concatenated with a single comma (e.g. "standard::type,standard::is-hidden"). The wildcard "*" may be used to match all keys and namespaces, or "namespace::*" will match all keys in a given namespace.

## Examples of file attribute matcher strings and results

- `"*"`: matches all attributes. - `"standard::is-hidden"`: matches only the key is-hidden in the standard namespace. - `"standard::type,unix::*"`: matches the type key in the standard namespace and all keys in the unix namespace.

attributes

an attribute string to match.

Returns

a Gio.FileAttributeMatcher