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-array.c b/json-glib/json-array.c
index 530674a..d699bed 100644
--- a/json-glib/json-array.c
+++ b/json-glib/json-array.c
@@ -180,6 +180,35 @@ json_array_get_elements (JsonArray *array)
 }
 
 /**
+ * json_array_dup_element:
+ * @array: a #JsonArray
+ * @index_: the index of the element to retrieve
+ *
+ * Retrieves a copy of the #JsonNode containing the value of the
+ * element at @index_ inside a #JsonArray
+ *
+ * Return value: a copy of the #JsonNode at the requested index.
+ *   Use json_node_free() when done.
+ *
+ * Since: 0.6
+ */
+JsonNode *
+json_array_dup_element (JsonArray *array,
+                        guint      index_)
+{
+  JsonNode *retval;
+
+  g_return_val_if_fail (array != NULL, NULL);
+  g_return_val_if_fail (index_ < array->elements->len, NULL);
+
+  retval = json_array_get_element (array, index_);
+  if (!retval)
+    return NULL;
+
+  return json_node_copy (retval);
+}
+
+/**
  * json_array_get_element:
  * @array: a #JsonArray
  * @index_: the index of the element to retrieve