Add API to retrieve copies of the nodes inside objects and arrays

Getting copies of the nodes might work better for high level languages
binding the JSON-GLib API, because they can manage the lifetime of the
returned values using their own rules.

1 files changed, 29 insertions, 0 deletions

diff --git a/json-glib/json-object.c b/json-glib/json-object.c
index c6eeff1..e0b4181 100644
--- a/json-glib/json-object.c
+++ b/json-glib/json-object.c
@@ -254,6 +254,35 @@ json_object_get_values (JsonObject *object)
 }
 
 /**
+ * json_object_dup_member:
+ * @object: a #JsonObject
+ * @member_name: the name of the JSON object member to access
+ *
+ * Retrieves a copy of the #JsonNode containing the value of @member_name
+ * inside a #JsonObject
+ *
+ * Return value: a copy of the node for the requested object member
+ *   or %NULL. Use json_node_free() when done.
+ *
+ * Since: 0.6
+ */
+JsonNode *
+json_object_dup_member (JsonObject  *object,
+                        const gchar *member_name)
+{
+  JsonNode *retval;
+
+  g_return_val_if_fail (object != NULL, NULL);
+  g_return_val_if_fail (member_name != NULL, NULL);
+
+  retval = json_object_get_member (object, member_name);
+  if (!retval)
+    return NULL;
+
+  return json_node_copy (retval);
+}
+
+/**
  * json_object_get_member:
  * @object: a #JsonObject
  * @member_name: the name of the JSON object member to access