GSettings: add g_settings_is_set()wip/settings-backend

Also add the equivalent vfunc to the backend.

https://bugzilla.gnome.org/show_bug.cgi?id=668233

6 files changed, 66 insertions, 1 deletions

diff --git a/docs/reference/gio/gio-sections.txt b/docs/reference/gio/gio-sections.txt
index e709e83d5..83cf760f4 100644
--- a/docs/reference/gio/gio-sections.txt
+++ b/docs/reference/gio/gio-sections.txt
@@ -2367,6 +2367,7 @@ g_settings_new_full
 g_settings_sync
 g_settings_get_value
 g_settings_set_value
+g_settings_is_set
 g_settings_is_writable
 g_settings_delay
 g_settings_apply
diff --git a/gio/gio.symbols b/gio/gio.symbols
index 02806f637..6e3c20b7c 100644
--- a/gio/gio.symbols
+++ b/gio/gio.symbols
@@ -1175,6 +1175,7 @@ g_settings_get_child
 g_settings_get_has_unapplied
 g_settings_get_type
 g_settings_get_value
+g_settings_is_set
 g_settings_is_writable
 g_settings_new
 g_settings_new_with_backend
diff --git a/gio/gsettings.c b/gio/gsettings.c
index 46229a4af..10da1a6d8 100644
--- a/gio/gsettings.c
+++ b/gio/gsettings.c
@@ -2033,7 +2033,7 @@ g_settings_get_has_unapplied (GSettings *settings)
   return g_settings_backend_get_has_unapplied (settings->priv->backend);
 }
 
-/* Extra API (reset, sync, get_child, is_writable, list_*, ranges) {{{1 */
+/* Extra API (reset, sync, get_child, is_set, is_writable, list_*, ranges) {{{1 */
 /**
  * g_settings_reset:
  * @settings: a #GSettings object
@@ -2105,6 +2105,45 @@ g_settings_is_writable (GSettings   *settings,
 }
 
 /**
+ * g_settings_is_set:
+ * @settings: a #GSettings object
+ * @name: the name of a key
+ *
+ * Determines if a key is "set".
+ *
+ * A key being set means (more or less) that g_settings_set() has been
+ * called on it more recently than the last call to g_settings_reset().
+ * This does not include system-level default settings.
+ *
+ * Another way of looking at it is that g_settings_reset() will only
+ * change the value of a key if it was already set.  It is possible,
+ * however, that a key is explicitly set to the default value.
+ *
+ * Keys that are "set" will not change if the default value for the key
+ * is changed (ie: by the system administrator) unless it is also locked
+ * down.
+ *
+ * Returns: %TRUE if the key is set
+ *
+ * Since: 2.34
+ **/
+gboolean
+g_settings_is_set (GSettings   *settings,
+                   const gchar *key)
+{
+  gboolean set;
+  gchar *path;
+
+  g_return_val_if_fail (G_IS_SETTINGS (settings), FALSE);
+
+  path = g_strconcat (settings->priv->path, key, NULL);
+  set = g_settings_backend_is_set (settings->priv->backend, path);
+  g_free (path);
+
+  return set;
+}
+
+/**
  * g_settings_get_child:
  * @settings: a #GSettings object
  * @name: the name of the 'child' schema
diff --git a/gio/gsettingsbackend.c b/gio/gsettingsbackend.c
index bd2147782..744a9917b 100644
--- a/gio/gsettingsbackend.c
+++ b/gio/gsettingsbackend.c
@@ -606,6 +606,24 @@ g_settings_backend_get_writable (GSettingsBackend *backend,
 }
 
 /*< private >
+ * g_settings_backend_is_set:
+ * @backend: a #GSettingsBackend Implementation
+ * @key: the name of a key
+ *
+ * Finds out if a key is "set".  See g_settings_is_set().
+ *
+ * Returns: %TRUE if the key is set
+ */
+gboolean
+g_settings_backend_is_set (GSettingsBackend *backend,
+                           const gchar      *key)
+{
+  return G_SETTINGS_BACKEND_GET_CLASS (backend)
+    ->is_set (backend, key);
+}
+
+
+/*< private >
  * g_settings_backend_unsubscribe:
  * @backend: a #GSettingsBackend
  * @name: a key or path to subscribe to
diff --git a/gio/gsettingsbackend.h b/gio/gsettingsbackend.h
index 8f1e6c627..bfda6e85b 100644
--- a/gio/gsettingsbackend.h
+++ b/gio/gsettingsbackend.h
@@ -70,6 +70,9 @@ struct _GSettingsBackendClass
                                          const GVariantType  *expected_type,
                                          gboolean             default_value);
 
+  gboolean           (* is_set)         (GSettingsBackend    *backend,
+                                         const gchar         *key);
+
   gboolean           (* get_writable)   (GSettingsBackend    *backend,
                                          const gchar         *key);
 
diff --git a/gio/gsettingsbackendinternal.h b/gio/gsettingsbackendinternal.h
index 1649987fe..3aead35ed 100644
--- a/gio/gsettingsbackendinternal.h
+++ b/gio/gsettingsbackendinternal.h
@@ -53,6 +53,9 @@ G_GNUC_INTERNAL
 void                    g_settings_backend_reset                        (GSettingsBackend     *backend,
                                                                          const gchar          *key);
 G_GNUC_INTERNAL
+gboolean                g_settings_backend_is_set                       (GSettingsBackend     *backend,
+                                                                         const char           *key);
+G_GNUC_INTERNAL
 gboolean                g_settings_backend_get_writable                 (GSettingsBackend     *backend,
                                                                          const char           *key);
 G_GNUC_INTERNAL