summaryrefslogtreecommitdiff
path: root/json-glib/json-object.c
diff options
context:
space:
mode:
authorEmmanuele Bassi <ebassi@openedhand.com>2007-10-01 16:16:15 +0100
committerEmmanuele Bassi <ebassi@openedhand.com>2007-10-01 16:16:15 +0100
commit29feafc236f888021b817fdfe0cfe685f5e3b65e (patch)
treebc3931f2746d66cf23c4692a3d56d54c6e8cee0c /json-glib/json-object.c
parent6eb1a5e94957d3555e7de5f6744a8777cd89efaf (diff)
downloadjson-glib-29feafc236f888021b817fdfe0cfe685f5e3b65e.tar.gz
Add licensing informations to the source code
Diffstat (limited to 'json-glib/json-object.c')
-rw-r--r--json-glib/json-object.c34
1 files changed, 30 insertions, 4 deletions
diff --git a/json-glib/json-object.c b/json-glib/json-object.c
index 0aa7855..df2591a 100644
--- a/json-glib/json-object.c
+++ b/json-glib/json-object.c
@@ -1,3 +1,22 @@
+/* json-object.c - JSON object implementation
+ *
+ * This file is part of JSON-GLib
+ * Copyright (C) 2007 OpenedHand Ltd.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * Author:
+ * Emmanuele Bassi <ebassi@openedhand.com>
+ */
+
#include "config.h"
#include <glib.h>
@@ -9,10 +28,17 @@
* SECTION:json-object
* @short_description: a JSON object representation
*
- * #JsonObject is a boxed type representing a JSON object data type. Each
- * JSON object can have zero or more members, and each member is accessed
- * by name. Each member can contain different values: numbers, strings,
- * arrays (see
+ * #JsonArray is the representation of the object type inside JSON. It contains
+ * #JsonNode<!-- -->s, which may contain fundamental types, arrays or other
+ * objects. Each member of an object is accessed using its name.
+ *
+ * Since objects can be expensive, they are reference counted. You can control
+ * the lifetime of a #JsonObject using json_object_ref() and json_object_unref().
+ *
+ * To extract a member with a given name, use json_object_get_member().
+ * To retrieve the list of members, use json_object_get_members().
+ * To retrieve the size of the object (that is, the number of members it has), use
+ * json_object_get_size().
*/
struct _JsonObject