FileAttributeMatcher allows for searching through a FileInfo for attributes.  
 More...
#include <giomm/fileinfo.h>
FileAttributeMatcher allows for searching through a FileInfo for attributes. 
- Since glibmm 2.16:
  
  | 
        
          | Gio::FileAttributeMatcher::FileAttributeMatcher | ( |  | ) |  |  | delete | 
 
 
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. 
 
 
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
- trueif the matcher matches all of the entries in the given ns,- falseotherwise.
 
 
      
        
          | std::string Gio::FileAttributeMatcher::enumerate_next | ( |  | ) |  | 
      
 
Gets the next matched attribute from a FileAttributeMatcher. 
- Returns
- A string containing the next attribute or nullptrif 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
- trueif attribute matches matcher.- falseotherwise.
 
 
      
        
          | 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
- trueif the matcher only matches attribute.- falseotherwise.
 
 
  
  | 
        
          | void Gio::FileAttributeMatcher::operator delete | ( | void * | , |  
          |  |  | std::size_t |  |  
          |  | ) |  |  |  | protected | 
 
 
      
        
          | 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 nullptrif matcher wasnullptr.
 
 
      
        
          | 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. 
 
 
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.