class: GFileAttributeMatcher

[12:7] extends: object

Determines if a string matches a file attribute.

Members

handleObj
lib
retainedCallbacks
signalHandlerNames
signalSetterHandlers

Methods

GFileAttributeMatcher (attributes = null)

Creates a new file attribute matcher, which matches attributes against a given string. [GFileAttributeMatchers][struct@FileAttributeMatcher] are reference counted structures, and are created with a reference count of 1. If the number of references falls to 0, the [struct@FileAttributeMatcher] is automatically destroyed. The @attributes 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.
- @p attributes is an attribute string to match..
toNativeHandle (Source)

Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from fn.call(...), another generated wrapper exposing handle(), or null. Returns null when the argument carries no pointer.
- @p Source is the raw handle, raw buffer, wrapper, or null.
- @r A raw pointer carrier or null when no pointer is present.
getLib ()

Returns the opened native library for this generated wrapper.
- @r The opened native library.
handle ()

Returns the wrapped NativeHandle.
- @r The wrapped NativeHandle.
isNull ()

Returns true when the wrapped handle is null.
- @r A bool.
describe ()

Returns a small string for debugging generated wrappers.
- @r A string.
enumerate_namespace (string ns)

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.) TODO: this is awkwardly worded.
- @p ns is a string containing a file attribute namespace..
- @r %TRUE if the matcher matches all of the entries in the given @ns, %FALSE otherwise..
enumerate_next ()

Gets the next matched attribute from a #GFileAttributeMatcher.
- @r a string containing the next attribute or, %NULL if no more attribute exist..
matches (string attribute)

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.
- @p attribute is a file attribute key..
- @r %TRUE if @attribute matches @matcher. %FALSE otherwise..
matches_only (string attribute)

Checks if an attribute matcher only matches a given attribute. Always returns %FALSE if "*" was used when creating the matcher.
- @p attribute is a file attribute key..
- @r %TRUE if the matcher only matches @attribute. %FALSE otherwise..
ref ()

References a file attribute matcher.
- @r a #GFileAttributeMatcher..
subtract (object subtract)

Subtracts all attributes of @subtract from @matcher and returns a matcher that supports those attributes. Note that currently it is not possible to remove a single attribute when the @matcher matches the whole namespace - or remove a namespace or attribute when the matcher matches everything. This is a limitation of the current implementation, but may be fixed in the future.
- @p subtract is The matcher to subtract.
- @r A file attribute matcher matching all attributes of @matcher that are not matched by @subtract.
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.
- @r a string describing the attributes the matcher matches against or %NULL if @matcher was %NULL..
unref ()

Unreferences @matcher. If the reference count falls below 1, the @matcher is automatically freed.
- @r None.