Client

---

Object Hierarchy:

Description:

Content:

Static methods:

• public static weak Client get_default ()
  Creates a new Client using the default Engine. Normally this is the engine you want. If someone else is already using the default Client, this function returns the same one they're using, but with the reference count incremented. So you have to unref either way.
• public static weak Client get_for_engine (Engine engine)
  Creates a new Client with a specific Engine. Only specialized configuration-related programs should need to call this function. The returned Client should be unref'd when you're done with unref. Remember to avoid using the Engine directly once you have a Client wrapper.
• public static void set_global_default_error_handler (ClientErrorHandlerFunc func)
  Set func as the default error handler for the Client. This handler would be called for all Client internal errors.

Creation methods:

• protected Client ()

Methods:

• public void add_dir (string dir, ClientPreloadType preload) throws Error
• public SList<string> all_dirs (string dir) throws Error
  Lists the subdirectories in dir. The returned list contains allocated strings. Each string is the absolute path of a subdirectory. You should g_free each string in the list, then g_slist_free the list itself. Just like all_dirs, but uses Client caching and error-handling features.
• public SList<Entry> all_entries (string dir) throws Error
  Lists the key-value pairs in dir. Does not list subdirectories; for that use all_dirs. The returned list contains Entry objects. A Entry contains an absolute key and a value. The list is not recursive, it contains only the immediate children of dir. To free the returned list, gconf_entry_free each list element, then g_slist_free the list itself. Just like all_entries, but uses Client caching and error-handling features.
• public weak ChangeSet change_set_from_current (...) throws Error
• public weak ChangeSet change_set_from_currentv (string keys) throws Error
• public void clear_cache ()
• public bool commit_change_set (ChangeSet cs, bool remove_committed) throws Error
• public bool dir_exists (string dir) throws Error
• public Value? get (string key) throws Error
• public bool get_bool (string key) throws Error
• public Value? get_default_from_schema (string key) throws Error
• public Entry get_entry (string key, string? locale, bool use_schema_default) throws Error
• public double get_float (string key) throws Error
• public int get_int (string key) throws Error
• public SList get_list (string key, ValueType list_type) throws Error
• public bool get_pair (string key, ValueType car_type, ValueType cdr_type, void* car_retloc, void* cdr_retloc) throws Error
• public Schema? get_schema (string key) throws Error
• public string? get_string (string key) throws Error
• public Value? get_without_default (string key) throws Error
• public bool key_is_writable (string key) throws Error
• public void notify (string key)
• public uint notify_add (string namespace_section, owned ClientNotifyFunc func) throws Error
• public void notify_remove (uint cnxn)
• public void preload (string dirname, ClientPreloadType type) throws Error
• public bool recursive_unset (string key, UnsetFlags flags) throws Error
• public void remove_dir (string dir) throws Error
• public weak ChangeSet reverse_change_set (ChangeSet cs) throws Error
• public void set (string key, Value val) throws Error
• public bool set_bool (string key, bool val) throws Error
• public void set_error_handling (ClientErrorHandlingMode mode)
• public bool set_float (string key, double val) throws Error
• public bool set_int (string key, int val) throws Error
• public bool set_list (string key, ValueType list_type, SList list) throws Error
• public bool set_pair (string key, ValueType car_type, ValueType cdr_type, void* address_of_car, void* address_of_cdr) throws Error
• public bool set_schema (string key, Schema val) throws Error
• public bool set_string (string key, string val) throws Error
• public void suggest_sync () throws Error
• public bool unset (string key) throws Error

Signals:

• public virtual void error ()
• public virtual void unreturned_error (void* error)
• public virtual void value_changed (string key, void* value)

Fields:

• public weak HashTable cache_dirs
• public weak HashTable cache_hash
• public weak HashTable dir_hash
• public weak Engine engine
• public ClientErrorHandlingMode error_mode
• public unowned Listeners listeners
• public uint notify_handler
• public unowned SList notify_list
• public int pad2
• public int pending_notify_count