glibmm: Gio::FileAttributeMatcher Class Reference

FileAttributeMatcher allows for searching through a FileInfo for attributes. More...

#include <giomm/fileinfo.h>

Public Member Functions

void reference () const
Increment the reference count for this object. More...

void unreference () const
Decrement the reference count for this object. More...

GFileAttributeMatcher* gobj ()
Provides access to the underlying C instance. More...

const GFileAttributeMatcher* gobj () const
Provides access to the underlying C instance. More...

GFileAttributeMatcher* gobj_copy () const
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...

FileAttributeMatcher ()=delete
FileAttributeMatcher (const FileAttributeMatcher &)=delete
FileAttributeMatcher & operator= (const FileAttributeMatcher &)=delete
Glib::RefPtr < FileAttributeMatcher > create_difference (const Glib::RefPtr < const FileAttributeMatcher >& subtract) const
Subtracts all attributes of subtract from matcher and returns a matcher that supports those attributes. More...

bool matches (const std::string & attribute) const
Checks if an attribute will be matched by an attribute matcher. More...

bool matches_only (const std::string & attribute) const
Checks if a attribute matcher only matches a given attribute. More...

bool enumerate_namespace (const std::string & ns)
Checks if the matcher will match all of the keys in a given namespace. More...

std::string enumerate_next ()
Gets the next matched attribute from a FileAttributeMatcher . More...

std::string to_string () const
Prints what the matcher is matching against. More...

Static Public Member Functions

static Glib::RefPtr < FileAttributeMatcher > create (const std::string & attributes="*")
Creates a new file attribute matcher, which matches attributes against a given string. More...

Protected Member Functions

void operator delete (void*, std::size_t)

Related Functions

(Note that these are not member functions.)

Glib::RefPtr < Gio::FileAttributeMatcher > wrap (GFileAttributeMatcher* object, bool take_copy=false)
A Glib::wrap() method for this object. More...

Detailed Description

FileAttributeMatcher allows for searching through a FileInfo for attributes.

Since glibmm 2.16:

Constructor & Destructor Documentation

Gio::FileAttributeMatcher::FileAttributeMatcher ( )
delete
Gio::FileAttributeMatcher::FileAttributeMatcher ( const FileAttributeMatcher & )
delete

Member Function Documentation

static Glib::RefPtr < FileAttributeMatcher > Gio::FileAttributeMatcher::create ( const std::string & attributes = "*" )
static

Creates a new file attribute matcher, which matches attributes against a given string.

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.

Parameters
attributes The attributes string.
Returns
a new FileAttributeMatcher .
Glib::RefPtr < FileAttributeMatcher > Gio::FileAttributeMatcher::create_difference ( const Glib::RefPtr < const FileAttributeMatcher >& subtract ) const

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.

Parameters
subtract The matcher to subtract.
Returns
A file attribute matcher matching all attributes of matcher that are not matched by subtract .
bool Gio::FileAttributeMatcher::enumerate_namespace ( const std::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.

Parameters
ns A string containing a file attribute namespace.
Returns
true if the matcher matches all of the entries in the given ns , false otherwise.
std::string Gio::FileAttributeMatcher::enumerate_next ( )

Gets the next matched attribute from a FileAttributeMatcher .

Returns
A string containing the next attribute or nullptr if no more attribute exist.
GFileAttributeMatcher* Gio::FileAttributeMatcher::gobj ( )

Provides access to the underlying C instance.

const GFileAttributeMatcher* Gio::FileAttributeMatcher::gobj ( ) const

Provides access to the underlying C instance.

GFileAttributeMatcher* Gio::FileAttributeMatcher::gobj_copy ( ) const

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

bool Gio::FileAttributeMatcher::matches ( const std::string & attribute ) const

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 .

Parameters
attribute A file attribute key.
Returns
true if attribute matches matcher . false otherwise.
bool Gio::FileAttributeMatcher::matches_only ( const std::string & attribute ) const

Checks if a attribute matcher only matches a given attribute.

Always returns false if "*" was used when creating the matcher.

Parameters
attribute A file attribute key.
Returns
true if the matcher only matches attribute . false otherwise.
void Gio::FileAttributeMatcher::operator delete ( void * ,
std::size_t
)
protected
FileAttributeMatcher & Gio::FileAttributeMatcher::operator= ( const FileAttributeMatcher & )
delete
void Gio::FileAttributeMatcher::reference ( ) const

Increment the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

std::string Gio::FileAttributeMatcher::to_string ( ) const

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 glibmm 2.32:
Returns
A string describing the attributes the matcher matches against or nullptr if matcher was nullptr .
void Gio::FileAttributeMatcher::unreference ( ) const

Decrement the reference count for this object.

You should never need to do this manually - use the object via a RefPtr instead.

Friends And Related Function Documentation

Glib::RefPtr < Gio::FileAttributeMatcher > wrap ( GFileAttributeMatcher * object ,
bool take_copy = false
)
related

A Glib::wrap() method for this object.

Parameters
object The C instance.
take_copy False if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.