PSARC/2014/362 Jansson
19903653 Jansson - C library for working with JSON should be added to Userland
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/Makefile Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,58 @@
+#
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+# Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
+#
+include ../../make-rules/shared-macros.mk
+
+COMPONENT_NAME= jansson
+COMPONENT_VERSION= 2.7
+COMPONENT_PROJECT_URL= http://www.digip.org/jansson
+COMPONENT_SRC= $(COMPONENT_NAME)-$(COMPONENT_VERSION)
+COMPONENT_ARCHIVE= $(COMPONENT_SRC).tar.gz
+COMPONENT_ARCHIVE_HASH= \
+ sha256:7905e6590fb316c0ff943df3dc6a21cd81a59cff7a6d12514054c359d04d78d7
+COMPONENT_ARCHIVE_URL= $(COMPONENT_PROJECT_URL)/releases/$(COMPONENT_ARCHIVE)
+COMPONENT_BUGDB= library/jansson
+
+TPNO= 19403
+
+include ../../make-rules/prep.mk
+include ../../make-rules/configure.mk
+include ../../make-rules/ips.mk
+
+CONFIGURE_OPTIONS += CFLAGS="$(CFLAGS)"
+CONFIGURE_OPTIONS += --includedir=$(USRINCDIR)/jansson
+
+# The test/suites/api/check-exports uses nm and expects it to be the GNU kind.
+COMPONENT_TEST_ENV += PATH=/usr/gnu/bin:$(PATH)
+
+ASLR_MODE = $(ASLR_ENABLE)
+
+# common targets
+build: $(BUILD_32_and_64)
+
+install: $(INSTALL_32_and_64)
+
+test: $(TEST_32_and_64)
+
+BUILD_PKG_DEPENDENCIES = $(BUILD_TOOLS)
+
+include ../../make-rules/depend.mk
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/README Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,39 @@
+#
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+# Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
+#
+
+The manpage and the HTML documentation is generated using Sphinx -
+sphinx-doc.org. The last Oracle approved (TPNO 18268) version is 1.2.2.
+The tool is not delivered as part of Solaris, so there's no way to generate
+this automatically on build server(s), therefore whenever one is updating the
+library, the documentation should be manually re-generated and the resulting
+files added here.
+
+The 'html' subdirectory is added as generated.
+
+The jansson.3lib in 'man3lib' subdirectory needed to be manually modified after
+generation so that Solaris nroff(1) is able to read it (GNU nroff is needed
+otherwise).
+
+Because we deliver the header files to /usr/include/jansson, it's necessary to
+make sure the examples in the manpage and HTML documentation are correct when
+updating the library.
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_downloads/github_commits.c Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,201 @@
+/*
+ * Copyright (c) 2009-2014 Petri Lehtinen <[email protected]>
+ *
+ * Jansson is free software; you can redistribute it and/or modify
+ * it under the terms of the MIT license. See LICENSE for details.
+ */
+
+#include <stdlib.h>
+#include <string.h>
+
+#include <jansson.h>
+#include <curl/curl.h>
+
+#define BUFFER_SIZE (256 * 1024) /* 256 KB */
+
+#define URL_FORMAT "https://api.github.com/repos/%s/%s/commits"
+#define URL_SIZE 256
+
+/* Return the offset of the first newline in text or the length of
+ text if there's no newline */
+static int newline_offset(const char *text)
+{
+ const char *newline = strchr(text, '\n');
+ if(!newline)
+ return strlen(text);
+ else
+ return (int)(newline - text);
+}
+
+struct write_result
+{
+ char *data;
+ int pos;
+};
+
+static size_t write_response(void *ptr, size_t size, size_t nmemb, void *stream)
+{
+ struct write_result *result = (struct write_result *)stream;
+
+ if(result->pos + size * nmemb >= BUFFER_SIZE - 1)
+ {
+ fprintf(stderr, "error: too small buffer\n");
+ return 0;
+ }
+
+ memcpy(result->data + result->pos, ptr, size * nmemb);
+ result->pos += size * nmemb;
+
+ return size * nmemb;
+}
+
+static char *request(const char *url)
+{
+ CURL *curl = NULL;
+ CURLcode status;
+ struct curl_slist *headers = NULL;
+ char *data = NULL;
+ long code;
+
+ curl_global_init(CURL_GLOBAL_ALL);
+ curl = curl_easy_init();
+ if(!curl)
+ goto error;
+
+ data = malloc(BUFFER_SIZE);
+ if(!data)
+ goto error;
+
+ struct write_result write_result = {
+ .data = data,
+ .pos = 0
+ };
+
+ curl_easy_setopt(curl, CURLOPT_URL, url);
+
+ /* GitHub commits API v3 requires a User-Agent header */
+ headers = curl_slist_append(headers, "User-Agent: Jansson-Tutorial");
+ curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
+
+ curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_response);
+ curl_easy_setopt(curl, CURLOPT_WRITEDATA, &write_result);
+
+ status = curl_easy_perform(curl);
+ if(status != 0)
+ {
+ fprintf(stderr, "error: unable to request data from %s:\n", url);
+ fprintf(stderr, "%s\n", curl_easy_strerror(status));
+ goto error;
+ }
+
+ curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &code);
+ if(code != 200)
+ {
+ fprintf(stderr, "error: server responded with code %ld\n", code);
+ goto error;
+ }
+
+ curl_easy_cleanup(curl);
+ curl_slist_free_all(headers);
+ curl_global_cleanup();
+
+ /* zero-terminate the result */
+ data[write_result.pos] = '\0';
+
+ return data;
+
+error:
+ if(data)
+ free(data);
+ if(curl)
+ curl_easy_cleanup(curl);
+ if(headers)
+ curl_slist_free_all(headers);
+ curl_global_cleanup();
+ return NULL;
+}
+
+int main(int argc, char *argv[])
+{
+ size_t i;
+ char *text;
+ char url[URL_SIZE];
+
+ json_t *root;
+ json_error_t error;
+
+ if(argc != 3)
+ {
+ fprintf(stderr, "usage: %s USER REPOSITORY\n\n", argv[0]);
+ fprintf(stderr, "List commits at USER's REPOSITORY.\n\n");
+ return 2;
+ }
+
+ snprintf(url, URL_SIZE, URL_FORMAT, argv[1], argv[2]);
+
+ text = request(url);
+ if(!text)
+ return 1;
+
+ root = json_loads(text, 0, &error);
+ free(text);
+
+ if(!root)
+ {
+ fprintf(stderr, "error: on line %d: %s\n", error.line, error.text);
+ return 1;
+ }
+
+ if(!json_is_array(root))
+ {
+ fprintf(stderr, "error: root is not an array\n");
+ json_decref(root);
+ return 1;
+ }
+
+ for(i = 0; i < json_array_size(root); i++)
+ {
+ json_t *data, *sha, *commit, *message;
+ const char *message_text;
+
+ data = json_array_get(root, i);
+ if(!json_is_object(data))
+ {
+ fprintf(stderr, "error: commit data %d is not an object\n", (int)(i + 1));
+ json_decref(root);
+ return 1;
+ }
+
+ sha = json_object_get(data, "sha");
+ if(!json_is_string(sha))
+ {
+ fprintf(stderr, "error: commit %d: sha is not a string\n", (int)(i + 1));
+ return 1;
+ }
+
+ commit = json_object_get(data, "commit");
+ if(!json_is_object(commit))
+ {
+ fprintf(stderr, "error: commit %d: commit is not an object\n", (int)(i + 1));
+ json_decref(root);
+ return 1;
+ }
+
+ message = json_object_get(commit, "message");
+ if(!json_is_string(message))
+ {
+ fprintf(stderr, "error: commit %d: message is not a string\n", (int)(i + 1));
+ json_decref(root);
+ return 1;
+ }
+
+ message_text = json_string_value(message);
+ printf("%.8s %.*s\n",
+ json_string_value(sha),
+ newline_offset(message_text),
+ message_text);
+ }
+
+ json_decref(root);
+ return 0;
+}
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_sources/apiref.txt Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,1602 @@
+.. _apiref:
+
+*************
+API Reference
+*************
+
+.. highlight:: c
+
+Preliminaries
+=============
+
+All declarations are in :file:`jansson.h`, so it's enough to
+
+::
+
+ #include <jansson.h>
+
+in each source file.
+
+All constants are prefixed with ``JSON_`` (except for those describing
+the library version, prefixed with ``JANSSON_``). Other identifiers
+are prefixed with ``json_``. Type names are suffixed with ``_t`` and
+``typedef``\ 'd so that the ``struct`` keyword need not be used.
+
+
+Library Version
+===============
+
+The Jansson version is of the form *A.B.C*, where *A* is the major
+version, *B* is the minor version and *C* is the micro version. If the
+micro version is zero, it's omitted from the version string, i.e. the
+version string is just *A.B*.
+
+When a new release only fixes bugs and doesn't add new features or
+functionality, the micro version is incremented. When new features are
+added in a backwards compatible way, the minor version is incremented
+and the micro version is set to zero. When there are backwards
+incompatible changes, the major version is incremented and others are
+set to zero.
+
+The following preprocessor constants specify the current version of
+the library:
+
+``JANSSON_MAJOR_VERSION``, ``JANSSON_MINOR_VERSION``, ``JANSSON_MICRO_VERSION``
+ Integers specifying the major, minor and micro versions,
+ respectively.
+
+``JANSSON_VERSION``
+ A string representation of the current version, e.g. ``"1.2.1"`` or
+ ``"1.3"``.
+
+``JANSSON_VERSION_HEX``
+ A 3-byte hexadecimal representation of the version, e.g.
+ ``0x010201`` for version 1.2.1 and ``0x010300`` for version 1.3.
+ This is useful in numeric comparisions, e.g.::
+
+ #if JANSSON_VERSION_HEX >= 0x010300
+ /* Code specific to version 1.3 and above */
+ #endif
+
+
+Value Representation
+====================
+
+The JSON specification (:rfc:`4627`) defines the following data types:
+*object*, *array*, *string*, *number*, *boolean*, and *null*. JSON
+types are used dynamically; arrays and objects can hold any other data
+type, including themselves. For this reason, Jansson's type system is
+also dynamic in nature. There's one C type to represent all JSON
+values, and this structure knows the type of the JSON value it holds.
+
+.. type:: json_t
+
+ This data structure is used throughout the library to represent all
+ JSON values. It always contains the type of the JSON value it holds
+ and the value's reference count. The rest depends on the type of the
+ value.
+
+Objects of :type:`json_t` are always used through a pointer. There
+are APIs for querying the type, manipulating the reference count, and
+for constructing and manipulating values of different types.
+
+Unless noted otherwise, all API functions return an error value if an
+error occurs. Depending on the function's signature, the error value
+is either *NULL* or -1. Invalid arguments or invalid input are
+apparent sources for errors. Memory allocation and I/O operations may
+also cause errors.
+
+
+Type
+----
+
+The type of a JSON value is queried and tested using the following
+functions:
+
+.. type:: enum json_type
+
+ The type of a JSON value. The following members are defined:
+
+ +--------------------+
+ | ``JSON_OBJECT`` |
+ +--------------------+
+ | ``JSON_ARRAY`` |
+ +--------------------+
+ | ``JSON_STRING`` |
+ +--------------------+
+ | ``JSON_INTEGER`` |
+ +--------------------+
+ | ``JSON_REAL`` |
+ +--------------------+
+ | ``JSON_TRUE`` |
+ +--------------------+
+ | ``JSON_FALSE`` |
+ +--------------------+
+ | ``JSON_NULL`` |
+ +--------------------+
+
+ These correspond to JSON object, array, string, number, boolean and
+ null. A number is represented by either a value of the type
+ ``JSON_INTEGER`` or of the type ``JSON_REAL``. A true boolean value
+ is represented by a value of the type ``JSON_TRUE`` and false by a
+ value of the type ``JSON_FALSE``.
+
+.. function:: int json_typeof(const json_t *json)
+
+ Return the type of the JSON value (a :type:`json_type` cast to
+ :type:`int`). *json* MUST NOT be *NULL*. This function is actually
+ implemented as a macro for speed.
+
+.. function:: json_is_object(const json_t *json)
+ json_is_array(const json_t *json)
+ json_is_string(const json_t *json)
+ json_is_integer(const json_t *json)
+ json_is_real(const json_t *json)
+ json_is_true(const json_t *json)
+ json_is_false(const json_t *json)
+ json_is_null(const json_t *json)
+
+ These functions (actually macros) return true (non-zero) for values
+ of the given type, and false (zero) for values of other types and
+ for *NULL*.
+
+.. function:: json_is_number(const json_t *json)
+
+ Returns true for values of types ``JSON_INTEGER`` and
+ ``JSON_REAL``, and false for other types and for *NULL*.
+
+.. function:: json_is_boolean(const json_t *json)
+
+ Returns true for types ``JSON_TRUE`` and ``JSON_FALSE``, and false
+ for values of other types and for *NULL*.
+
+.. function:: json_boolean_value(const json_t *json)
+
+ Alias of :func:`json_is_true()`, i.e. returns 1 for ``JSON_TRUE``
+ and 0 otherwise.
+
+ .. versionadded:: 2.7
+
+
+.. _apiref-reference-count:
+
+Reference Count
+---------------
+
+The reference count is used to track whether a value is still in use
+or not. When a value is created, it's reference count is set to 1. If
+a reference to a value is kept (e.g. a value is stored somewhere for
+later use), its reference count is incremented, and when the value is
+no longer needed, the reference count is decremented. When the
+reference count drops to zero, there are no references left, and the
+value can be destroyed.
+
+The following functions are used to manipulate the reference count.
+
+.. function:: json_t *json_incref(json_t *json)
+
+ Increment the reference count of *json* if it's not *NULL*.
+ Returns *json*.
+
+.. function:: void json_decref(json_t *json)
+
+ Decrement the reference count of *json*. As soon as a call to
+ :func:`json_decref()` drops the reference count to zero, the value
+ is destroyed and it can no longer be used.
+
+Functions creating new JSON values set the reference count to 1. These
+functions are said to return a **new reference**. Other functions
+returning (existing) JSON values do not normally increase the
+reference count. These functions are said to return a **borrowed
+reference**. So, if the user will hold a reference to a value returned
+as a borrowed reference, he must call :func:`json_incref`. As soon as
+the value is no longer needed, :func:`json_decref` should be called
+to release the reference.
+
+Normally, all functions accepting a JSON value as an argument will
+manage the reference, i.e. increase and decrease the reference count
+as needed. However, some functions **steal** the reference, i.e. they
+have the same result as if the user called :func:`json_decref()` on
+the argument right after calling the function. These functions are
+suffixed with ``_new`` or have ``_new_`` somewhere in their name.
+
+For example, the following code creates a new JSON array and appends
+an integer to it::
+
+ json_t *array, *integer;
+
+ array = json_array();
+ integer = json_integer(42);
+
+ json_array_append(array, integer);
+ json_decref(integer);
+
+Note how the caller has to release the reference to the integer value
+by calling :func:`json_decref()`. By using a reference stealing
+function :func:`json_array_append_new()` instead of
+:func:`json_array_append()`, the code becomes much simpler::
+
+ json_t *array = json_array();
+ json_array_append_new(array, json_integer(42));
+
+In this case, the user doesn't have to explicitly release the
+reference to the integer value, as :func:`json_array_append_new()`
+steals the reference when appending the value to the array.
+
+In the following sections it is clearly documented whether a function
+will return a new or borrowed reference or steal a reference to its
+argument.
+
+
+Circular References
+-------------------
+
+A circular reference is created when an object or an array is,
+directly or indirectly, inserted inside itself. The direct case is
+simple::
+
+ json_t *obj = json_object();
+ json_object_set(obj, "foo", obj);
+
+Jansson will refuse to do this, and :func:`json_object_set()` (and
+all the other such functions for objects and arrays) will return with
+an error status. The indirect case is the dangerous one::
+
+ json_t *arr1 = json_array(), *arr2 = json_array();
+ json_array_append(arr1, arr2);
+ json_array_append(arr2, arr1);
+
+In this example, the array ``arr2`` is contained in the array
+``arr1``, and vice versa. Jansson cannot check for this kind of
+indirect circular references without a performance hit, so it's up to
+the user to avoid them.
+
+If a circular reference is created, the memory consumed by the values
+cannot be freed by :func:`json_decref()`. The reference counts never
+drops to zero because the values are keeping the references to each
+other. Moreover, trying to encode the values with any of the encoding
+functions will fail. The encoder detects circular references and
+returns an error status.
+
+
+True, False and Null
+====================
+
+These three values are implemented as singletons, so the returned
+pointers won't change between invocations of these functions.
+
+.. function:: json_t *json_true(void)
+
+ .. refcounting:: new
+
+ Returns the JSON true value.
+
+.. function:: json_t *json_false(void)
+
+ .. refcounting:: new
+
+ Returns the JSON false value.
+
+.. function:: json_t *json_boolean(val)
+
+ .. refcounting:: new
+
+ Returns JSON false if ``val`` is zero, and JSON true otherwise.
+ This is a macro, and equivalent to ``val ? json_true() :
+ json_false()``.
+
+ .. versionadded:: 2.4
+
+
+.. function:: json_t *json_null(void)
+
+ .. refcounting:: new
+
+ Returns the JSON null value.
+
+
+String
+======
+
+Jansson uses UTF-8 as the character encoding. All JSON strings must be
+valid UTF-8 (or ASCII, as it's a subset of UTF-8). All Unicode
+codepoints U+0000 through U+10FFFF are allowed, but you must use
+length-aware functions if you wish to embed NUL bytes in strings.
+
+.. function:: json_t *json_string(const char *value)
+
+ .. refcounting:: new
+
+ Returns a new JSON string, or *NULL* on error. *value* must be a
+ valid null terminated UTF-8 encoded Unicode string.
+
+.. function:: json_t *json_stringn(const char *value, size_t len)
+
+ .. refcounting:: new
+
+ Like :func:`json_string`, but with explicit length, so *value* may
+ contain null characters or not be null terminated.
+
+.. function:: json_t *json_string_nocheck(const char *value)
+
+ .. refcounting:: new
+
+ Like :func:`json_string`, but doesn't check that *value* is valid
+ UTF-8. Use this function only if you are certain that this really
+ is the case (e.g. you have already checked it by other means).
+
+.. function:: json_t *json_stringn_nocheck(const char *value, size_t len)
+
+ .. refcounting:: new
+
+ Like :func:`json_string_nocheck`, but with explicit length, so
+ *value* may contain null characters or not be null terminated.
+
+.. function:: const char *json_string_value(const json_t *string)
+
+ Returns the associated value of *string* as a null terminated UTF-8
+ encoded string, or *NULL* if *string* is not a JSON string.
+
+ The retuned value is read-only and must not be modified or freed by
+ the user. It is valid as long as *string* exists, i.e. as long as
+ its reference count has not dropped to zero.
+
+.. function:: size_t json_string_length(const json_t *string)
+
+ Returns the length of *string* in its UTF-8 presentation, or zero
+ if *string* is not a JSON string.
+
+.. function:: int json_string_set(const json_t *string, const char *value)
+
+ Sets the associated value of *string* to *value*. *value* must be a
+ valid UTF-8 encoded Unicode string. Returns 0 on success and -1 on
+ error.
+
+.. function:: int json_string_setn(json_t *string, const char *value, size_t len)
+
+ Like :func:`json_string_set`, but with explicit length, so *value*
+ may contain null characters or not be null terminated.
+
+.. function:: int json_string_set_nocheck(const json_t *string, const char *value)
+
+ Like :func:`json_string_set`, but doesn't check that *value* is
+ valid UTF-8. Use this function only if you are certain that this
+ really is the case (e.g. you have already checked it by other
+ means).
+
+.. function:: int json_string_setn_nocheck(json_t *string, const char *value, size_t len)
+
+ Like :func:`json_string_set_nocheck`, but with explicit length,
+ so *value* may contain null characters or not be null terminated.
+
+
+Number
+======
+
+The JSON specification only contains one numeric type, "number". The C
+programming language has distinct types for integer and floating-point
+numbers, so for practical reasons Jansson also has distinct types for
+the two. They are called "integer" and "real", respectively. For more
+information, see :ref:`rfc-conformance`.
+
+.. type:: json_int_t
+
+ This is the C type that is used to store JSON integer values. It
+ represents the widest integer type available on your system. In
+ practice it's just a typedef of ``long long`` if your compiler
+ supports it, otherwise ``long``.
+
+ Usually, you can safely use plain ``int`` in place of
+ ``json_int_t``, and the implicit C integer conversion handles the
+ rest. Only when you know that you need the full 64-bit range, you
+ should use ``json_int_t`` explicitly.
+
+``JSON_INTEGER_IS_LONG_LONG``
+ This is a preprocessor variable that holds the value 1 if
+ :type:`json_int_t` is ``long long``, and 0 if it's ``long``. It
+ can be used as follows::
+
+ #if JSON_INTEGER_IS_LONG_LONG
+ /* Code specific for long long */
+ #else
+ /* Code specific for long */
+ #endif
+
+``JSON_INTEGER_FORMAT``
+ This is a macro that expands to a :func:`printf()` conversion
+ specifier that corresponds to :type:`json_int_t`, without the
+ leading ``%`` sign, i.e. either ``"lld"`` or ``"ld"``. This macro
+ is required because the actual type of :type:`json_int_t` can be
+ either ``long`` or ``long long``, and :func:`printf()` reuiqres
+ different length modifiers for the two.
+
+ Example::
+
+ json_int_t x = 123123123;
+ printf("x is %" JSON_INTEGER_FORMAT "\n", x);
+
+
+.. function:: json_t *json_integer(json_int_t value)
+
+ .. refcounting:: new
+
+ Returns a new JSON integer, or *NULL* on error.
+
+.. function:: json_int_t json_integer_value(const json_t *integer)
+
+ Returns the associated value of *integer*, or 0 if *json* is not a
+ JSON integer.
+
+.. function:: int json_integer_set(const json_t *integer, json_int_t value)
+
+ Sets the associated value of *integer* to *value*. Returns 0 on
+ success and -1 if *integer* is not a JSON integer.
+
+.. function:: json_t *json_real(double value)
+
+ .. refcounting:: new
+
+ Returns a new JSON real, or *NULL* on error.
+
+.. function:: double json_real_value(const json_t *real)
+
+ Returns the associated value of *real*, or 0.0 if *real* is not a
+ JSON real.
+
+.. function:: int json_real_set(const json_t *real, double value)
+
+ Sets the associated value of *real* to *value*. Returns 0 on
+ success and -1 if *real* is not a JSON real.
+
+In addition to the functions above, there's a common query function
+for integers and reals:
+
+.. function:: double json_number_value(const json_t *json)
+
+ Returns the associated value of the JSON integer or JSON real
+ *json*, cast to double regardless of the actual type. If *json* is
+ neither JSON real nor JSON integer, 0.0 is returned.
+
+
+Array
+=====
+
+A JSON array is an ordered collection of other JSON values.
+
+.. function:: json_t *json_array(void)
+
+ .. refcounting:: new
+
+ Returns a new JSON array, or *NULL* on error. Initially, the array
+ is empty.
+
+.. function:: size_t json_array_size(const json_t *array)
+
+ Returns the number of elements in *array*, or 0 if *array* is NULL
+ or not a JSON array.
+
+.. function:: json_t *json_array_get(const json_t *array, size_t index)
+
+ .. refcounting:: borrow
+
+ Returns the element in *array* at position *index*. The valid range
+ for *index* is from 0 to the return value of
+ :func:`json_array_size()` minus 1. If *array* is not a JSON array,
+ if *array* is *NULL*, or if *index* is out of range, *NULL* is
+ returned.
+
+.. function:: int json_array_set(json_t *array, size_t index, json_t *value)
+
+ Replaces the element in *array* at position *index* with *value*.
+ The valid range for *index* is from 0 to the return value of
+ :func:`json_array_size()` minus 1. Returns 0 on success and -1 on
+ error.
+
+.. function:: int json_array_set_new(json_t *array, size_t index, json_t *value)
+
+ Like :func:`json_array_set()` but steals the reference to *value*.
+ This is useful when *value* is newly created and not used after
+ the call.
+
+.. function:: int json_array_append(json_t *array, json_t *value)
+
+ Appends *value* to the end of *array*, growing the size of *array*
+ by 1. Returns 0 on success and -1 on error.
+
+.. function:: int json_array_append_new(json_t *array, json_t *value)
+
+ Like :func:`json_array_append()` but steals the reference to
+ *value*. This is useful when *value* is newly created and not used
+ after the call.
+
+.. function:: int json_array_insert(json_t *array, size_t index, json_t *value)
+
+ Inserts *value* to *array* at position *index*, shifting the
+ elements at *index* and after it one position towards the end of
+ the array. Returns 0 on success and -1 on error.
+
+.. function:: int json_array_insert_new(json_t *array, size_t index, json_t *value)
+
+ Like :func:`json_array_insert()` but steals the reference to
+ *value*. This is useful when *value* is newly created and not used
+ after the call.
+
+.. function:: int json_array_remove(json_t *array, size_t index)
+
+ Removes the element in *array* at position *index*, shifting the
+ elements after *index* one position towards the start of the array.
+ Returns 0 on success and -1 on error. The reference count of the
+ removed value is decremented.
+
+.. function:: int json_array_clear(json_t *array)
+
+ Removes all elements from *array*. Returns 0 on sucess and -1 on
+ error. The reference count of all removed values are decremented.
+
+.. function:: int json_array_extend(json_t *array, json_t *other_array)
+
+ Appends all elements in *other_array* to the end of *array*.
+ Returns 0 on success and -1 on error.
+
+The following macro can be used to iterate through all elements
+in an array.
+
+.. function:: json_array_foreach(array, index, value)
+
+ Iterate over every element of ``array``, running the block
+ of code that follows each time with the proper values set to
+ variables ``index`` and ``value``, of types :type:`size_t` and
+ :type:`json_t *` respectively. Example::
+
+ /* array is a JSON array */
+ size_t index;
+ json_t *value;
+
+ json_array_foreach(array, index, value) {
+ /* block of code that uses index and value */
+ }
+
+ The items are returned in increasing index order.
+
+ This macro expands to an ordinary ``for`` statement upon
+ preprocessing, so its performance is equivalent to that of
+ hand-written code using the array access functions.
+ The main advantage of this macro is that it abstracts
+ away the complexity, and makes for shorter, more
+ concise code.
+
+ .. versionadded:: 2.5
+
+
+Object
+======
+
+A JSON object is a dictionary of key-value pairs, where the key is a
+Unicode string and the value is any JSON value.
+
+Even though NUL bytes are allowed in string values, they are not
+allowed in object keys.
+
+.. function:: json_t *json_object(void)
+
+ .. refcounting:: new
+
+ Returns a new JSON object, or *NULL* on error. Initially, the
+ object is empty.
+
+.. function:: size_t json_object_size(const json_t *object)
+
+ Returns the number of elements in *object*, or 0 if *object* is not
+ a JSON object.
+
+.. function:: json_t *json_object_get(const json_t *object, const char *key)
+
+ .. refcounting:: borrow
+
+ Get a value corresponding to *key* from *object*. Returns *NULL* if
+ *key* is not found and on error.
+
+.. function:: int json_object_set(json_t *object, const char *key, json_t *value)
+
+ Set the value of *key* to *value* in *object*. *key* must be a
+ valid null terminated UTF-8 encoded Unicode string. If there
+ already is a value for *key*, it is replaced by the new value.
+ Returns 0 on success and -1 on error.
+
+.. function:: int json_object_set_nocheck(json_t *object, const char *key, json_t *value)
+
+ Like :func:`json_object_set`, but doesn't check that *key* is
+ valid UTF-8. Use this function only if you are certain that this
+ really is the case (e.g. you have already checked it by other
+ means).
+
+.. function:: int json_object_set_new(json_t *object, const char *key, json_t *value)
+
+ Like :func:`json_object_set()` but steals the reference to
+ *value*. This is useful when *value* is newly created and not used
+ after the call.
+
+.. function:: int json_object_set_new_nocheck(json_t *object, const char *key, json_t *value)
+
+ Like :func:`json_object_set_new`, but doesn't check that *key* is
+ valid UTF-8. Use this function only if you are certain that this
+ really is the case (e.g. you have already checked it by other
+ means).
+
+.. function:: int json_object_del(json_t *object, const char *key)
+
+ Delete *key* from *object* if it exists. Returns 0 on success, or
+ -1 if *key* was not found. The reference count of the removed value
+ is decremented.
+
+.. function:: int json_object_clear(json_t *object)
+
+ Remove all elements from *object*. Returns 0 on success and -1 if
+ *object* is not a JSON object. The reference count of all removed
+ values are decremented.
+
+.. function:: int json_object_update(json_t *object, json_t *other)
+
+ Update *object* with the key-value pairs from *other*, overwriting
+ existing keys. Returns 0 on success or -1 on error.
+
+.. function:: int json_object_update_existing(json_t *object, json_t *other)
+
+ Like :func:`json_object_update()`, but only the values of existing
+ keys are updated. No new keys are created. Returns 0 on success or
+ -1 on error.
+
+ .. versionadded:: 2.3
+
+.. function:: int json_object_update_missing(json_t *object, json_t *other)
+
+ Like :func:`json_object_update()`, but only new keys are created.
+ The value of any existing key is not changed. Returns 0 on success
+ or -1 on error.
+
+ .. versionadded:: 2.3
+
+The following macro can be used to iterate through all key-value pairs
+in an object.
+
+.. function:: json_object_foreach(object, key, value)
+
+ Iterate over every key-value pair of ``object``, running the block
+ of code that follows each time with the proper values set to
+ variables ``key`` and ``value``, of types :type:`const char *` and
+ :type:`json_t *` respectively. Example::
+
+ /* obj is a JSON object */
+ const char *key;
+ json_t *value;
+
+ json_object_foreach(obj, key, value) {
+ /* block of code that uses key and value */
+ }
+
+ The items are not returned in any particular order.
+
+ This macro expands to an ordinary ``for`` statement upon
+ preprocessing, so its performance is equivalent to that of
+ hand-written iteration code using the object iteration protocol
+ (see below). The main advantage of this macro is that it abstracts
+ away the complexity behind iteration, and makes for shorter, more
+ concise code.
+
+ .. versionadded:: 2.3
+
+
+The following functions implement an iteration protocol for objects,
+allowing to iterate through all key-value pairs in an object. The
+items are not returned in any particular order, as this would require
+sorting due to the internal hashtable implementation.
+
+.. function:: void *json_object_iter(json_t *object)
+
+ Returns an opaque iterator which can be used to iterate over all
+ key-value pairs in *object*, or *NULL* if *object* is empty.
+
+.. function:: void *json_object_iter_at(json_t *object, const char *key)
+
+ Like :func:`json_object_iter()`, but returns an iterator to the
+ key-value pair in *object* whose key is equal to *key*, or NULL if
+ *key* is not found in *object*. Iterating forward to the end of
+ *object* only yields all key-value pairs of the object if *key*
+ happens to be the first key in the underlying hash table.
+
+.. function:: void *json_object_iter_next(json_t *object, void *iter)
+
+ Returns an iterator pointing to the next key-value pair in *object*
+ after *iter*, or *NULL* if the whole object has been iterated
+ through.
+
+.. function:: const char *json_object_iter_key(void *iter)
+
+ Extract the associated key from *iter*.
+
+.. function:: json_t *json_object_iter_value(void *iter)
+
+ .. refcounting:: borrow
+
+ Extract the associated value from *iter*.
+
+.. function:: int json_object_iter_set(json_t *object, void *iter, json_t *value)
+
+ Set the value of the key-value pair in *object*, that is pointed to
+ by *iter*, to *value*.
+
+.. function:: int json_object_iter_set_new(json_t *object, void *iter, json_t *value)
+
+ Like :func:`json_object_iter_set()`, but steals the reference to
+ *value*. This is useful when *value* is newly created and not used
+ after the call.
+
+.. function:: void *json_object_key_to_iter(const char *key)
+
+ Like :func:`json_object_iter_at()`, but much faster. Only works for
+ values returned by :func:`json_object_iter_key()`. Using other keys
+ will lead to segfaults. This function is used internally to
+ implement :func:`json_object_foreach`.
+
+ .. versionadded:: 2.3
+
+The iteration protocol can be used for example as follows::
+
+ /* obj is a JSON object */
+ const char *key;
+ json_t *value;
+
+ void *iter = json_object_iter(obj);
+ while(iter)
+ {
+ key = json_object_iter_key(iter);
+ value = json_object_iter_value(iter);
+ /* use key and value ... */
+ iter = json_object_iter_next(obj, iter);
+ }
+
+.. function:: void json_object_seed(size_t seed)
+
+ Seed the hash function used in Jansson's hashtable implementation.
+ The seed is used to randomize the hash function so that an
+ attacker cannot control its output.
+
+ If *seed* is 0, Jansson generates the seed itselfy by reading
+ random data from the operating system's entropy sources. If no
+ entropy sources are available, falls back to using a combination
+ of the current timestamp (with microsecond precision if possible)
+ and the process ID.
+
+ If called at all, this function must be called before any calls to
+ :func:`json_object()`, either explicit or implicit. If this
+ function is not called by the user, the first call to
+ :func:`json_object()` (either explicit or implicit) seeds the hash
+ function. See :ref:`portability-thread-safety` for notes on thread
+ safety.
+
+ If repeatable results are required, for e.g. unit tests, the hash
+ function can be "unrandomized" by calling :func:`json_object_seed`
+ with a constant value on program startup, e.g.
+ ``json_object_seed(1)``.
+
+ .. versionadded:: 2.6
+
+
+Error reporting
+===============
+
+Jansson uses a single struct type to pass error information to the
+user. See sections :ref:`apiref-decoding`, :ref:`apiref-pack` and
+:ref:`apiref-unpack` for functions that pass error information using
+this struct.
+
+.. type:: json_error_t
+
+ .. member:: char text[]
+
+ The error message (in UTF-8), or an empty string if a message is
+ not available.
+
+ .. member:: char source[]
+
+ Source of the error. This can be (a part of) the file name or a
+ special identifier in angle brackers (e.g. ``<string>``).
+
+ .. member:: int line
+
+ The line number on which the error occurred.
+
+ .. member:: int column
+
+ The column on which the error occurred. Note that this is the
+ *character column*, not the byte column, i.e. a multibyte UTF-8
+ character counts as one column.
+
+ .. member:: size_t position
+
+ The position in bytes from the start of the input. This is
+ useful for debugging Unicode encoding problems.
+
+The normal use of :type:`json_error_t` is to allocate it on the stack,
+and pass a pointer to a function. Example::
+
+ int main() {
+ json_t *json;
+ json_error_t error;
+
+ json = json_load_file("/path/to/file.json", 0, &error);
+ if(!json) {
+ /* the error variable contains error information */
+ }
+ ...
+ }
+
+Also note that if the call succeeded (``json != NULL`` in the above
+example), the contents of ``error`` are generally left unspecified.
+The decoding functions write to the ``position`` member also on
+success. See :ref:`apiref-decoding` for more info.
+
+All functions also accept *NULL* as the :type:`json_error_t` pointer,
+in which case no error information is returned to the caller.
+
+
+Encoding
+========
+
+This sections describes the functions that can be used to encode
+values to JSON. By default, only objects and arrays can be encoded
+directly, since they are the only valid *root* values of a JSON text.
+To encode any JSON value, use the ``JSON_ENCODE_ANY`` flag (see
+below).
+
+By default, the output has no newlines, and spaces are used between
+array and object elements for a readable output. This behavior can be
+altered by using the ``JSON_INDENT`` and ``JSON_COMPACT`` flags
+described below. A newline is never appended to the end of the encoded
+JSON data.
+
+Each function takes a *flags* parameter that controls some aspects of
+how the data is encoded. Its default value is 0. The following macros
+can be ORed together to obtain *flags*.
+
+``JSON_INDENT(n)``
+ Pretty-print the result, using newlines between array and object
+ items, and indenting with *n* spaces. The valid range for *n* is
+ between 0 and 31 (inclusive), other values result in an undefined
+ output. If ``JSON_INDENT`` is not used or *n* is 0, no newlines are
+ inserted between array and object items.
+
+ The ``JSON_MAX_INDENT`` constant defines the maximum indentation
+ that can be used, and its value is 31.
+
+ .. versionchanged:: 2.7
+ Added ``JSON_MAX_INDENT``.
+
+``JSON_COMPACT``
+ This flag enables a compact representation, i.e. sets the separator
+ between array and object items to ``","`` and between object keys
+ and values to ``":"``. Without this flag, the corresponding
+ separators are ``", "`` and ``": "`` for more readable output.
+
+``JSON_ENSURE_ASCII``
+ If this flag is used, the output is guaranteed to consist only of
+ ASCII characters. This is achived by escaping all Unicode
+ characters outside the ASCII range.
+
+``JSON_SORT_KEYS``
+ If this flag is used, all the objects in output are sorted by key.
+ This is useful e.g. if two JSON texts are diffed or visually
+ compared.
+
+``JSON_PRESERVE_ORDER``
+ If this flag is used, object keys in the output are sorted into the
+ same order in which they were first inserted to the object. For
+ example, decoding a JSON text and then encoding with this flag
+ preserves the order of object keys.
+
+``JSON_ENCODE_ANY``
+ Specifying this flag makes it possible to encode any JSON value on
+ its own. Without it, only objects and arrays can be passed as the
+ *root* value to the encoding functions.
+
+ **Note:** Encoding any value may be useful in some scenarios, but
+ it's generally discouraged as it violates strict compatiblity with
+ :rfc:`4627`. If you use this flag, don't expect interoperatibility
+ with other JSON systems.
+
+ .. versionadded:: 2.1
+
+``JSON_ESCAPE_SLASH``
+ Escape the ``/`` characters in strings with ``\/``.
+
+ .. versionadded:: 2.4
+
+``JSON_REAL_PRECISION(n)``
+ Output all real numbers with at most *n* digits of precision. The
+ valid range for *n* is between 0 and 31 (inclusive), and other
+ values result in an undefined behavior.
+
+ By default, the precision is 17, to correctly and losslessly encode
+ all IEEE 754 double precision floating point numbers.
+
+ .. versionadded:: 2.7
+
+The following functions perform the actual JSON encoding. The result
+is in UTF-8.
+
+.. function:: char *json_dumps(const json_t *root, size_t flags)
+
+ Returns the JSON representation of *root* as a string, or *NULL* on
+ error. *flags* is described above. The return value must be freed
+ by the caller using :func:`free()`.
+
+.. function:: int json_dumpf(const json_t *root, FILE *output, size_t flags)
+
+ Write the JSON representation of *root* to the stream *output*.
+ *flags* is described above. Returns 0 on success and -1 on error.
+ If an error occurs, something may have already been written to
+ *output*. In this case, the output is undefined and most likely not
+ valid JSON.
+
+.. function:: int json_dump_file(const json_t *json, const char *path, size_t flags)
+
+ Write the JSON representation of *root* to the file *path*. If
+ *path* already exists, it is overwritten. *flags* is described
+ above. Returns 0 on success and -1 on error.
+
+.. type:: json_dump_callback_t
+
+ A typedef for a function that's called by
+ :func:`json_dump_callback()`::
+
+ typedef int (*json_dump_callback_t)(const char *buffer, size_t size, void *data);
+
+ *buffer* points to a buffer containing a chunk of output, *size* is
+ the length of the buffer, and *data* is the corresponding
+ :func:`json_dump_callback()` argument passed through.
+
+ On error, the function should return -1 to stop the encoding
+ process. On success, it should return 0.
+
+ .. versionadded:: 2.2
+
+.. function:: int json_dump_callback(const json_t *json, json_dump_callback_t callback, void *data, size_t flags)
+
+ Call *callback* repeatedly, passing a chunk of the JSON
+ representation of *root* each time. *flags* is described above.
+ Returns 0 on success and -1 on error.
+
+ .. versionadded:: 2.2
+
+
+.. _apiref-decoding:
+
+Decoding
+========
+
+This sections describes the functions that can be used to decode JSON
+text to the Jansson representation of JSON data. The JSON
+specification requires that a JSON text is either a serialized array
+or object, and this requirement is also enforced with the following
+functions. In other words, the top level value in the JSON text being
+decoded must be either array or object. To decode any JSON value, use
+the ``JSON_DECODE_ANY`` flag (see below).
+
+See :ref:`rfc-conformance` for a discussion on Jansson's conformance
+to the JSON specification. It explains many design decisions that
+affect especially the behavior of the decoder.
+
+Each function takes a *flags* parameter that can be used to control
+the behavior of the decoder. Its default value is 0. The following
+macros can be ORed together to obtain *flags*.
+
+``JSON_REJECT_DUPLICATES``
+ Issue a decoding error if any JSON object in the input text
+ contains duplicate keys. Without this flag, the value of the last
+ occurence of each key ends up in the result. Key equivalence is
+ checked byte-by-byte, without special Unicode comparison
+ algorithms.
+
+ .. versionadded:: 2.1
+
+``JSON_DECODE_ANY``
+ By default, the decoder expects an array or object as the input.
+ With this flag enabled, the decoder accepts any valid JSON value.
+
+ **Note:** Decoding any value may be useful in some scenarios, but
+ it's generally discouraged as it violates strict compatiblity with
+ :rfc:`4627`. If you use this flag, don't expect interoperatibility
+ with other JSON systems.
+
+ .. versionadded:: 2.3
+
+``JSON_DISABLE_EOF_CHECK``
+ By default, the decoder expects that its whole input constitutes a
+ valid JSON text, and issues an error if there's extra data after
+ the otherwise valid JSON input. With this flag enabled, the decoder
+ stops after decoding a valid JSON array or object, and thus allows
+ extra data after the JSON text.
+
+ Normally, reading will stop when the last ``]`` or ``}`` in the
+ JSON input is encountered. If both ``JSON_DISABLE_EOF_CHECK`` and
+ ``JSON_DECODE_ANY`` flags are used, the decoder may read one extra
+ UTF-8 code unit (up to 4 bytes of input). For example, decoding
+ ``4true`` correctly decodes the integer 4, but also reads the
+ ``t``. For this reason, if reading multiple consecutive values that
+ are not arrays or objects, they should be separated by at least one
+ whitespace character.
+
+ .. versionadded:: 2.1
+
+``JSON_DECODE_INT_AS_REAL``
+ JSON defines only one number type. Jansson distinguishes between
+ ints and reals. For more information see :ref:`real-vs-integer`.
+ With this flag enabled the decoder interprets all numbers as real
+ values. Integers that do not have an exact double representation
+ will silently result in a loss of precision. Integers that cause
+ a double overflow will cause an error.
+
+ .. versionadded:: 2.5
+
+``JSON_ALLOW_NUL``
+ Allow ``\u0000`` escape inside string values. This is a safety
+ measure; If you know your input can contain NUL bytes, use this
+ flag. If you don't use this flag, you don't have to worry about NUL
+ bytes inside strings unless you explicitly create themselves by
+ using e.g. :func:`json_stringn()` or ``s#`` format specifier for
+ :func:`json_pack()`.
+
+ Object keys cannot have embedded NUL bytes even if this flag is
+ used.
+
+ .. versionadded:: 2.6
+
+Each function also takes an optional :type:`json_error_t` parameter
+that is filled with error information if decoding fails. It's also
+updated on success; the number of bytes of input read is written to
+its ``position`` field. This is especially useful when using
+``JSON_DISABLE_EOF_CHECK`` to read multiple consecutive JSON texts.
+
+.. versionadded:: 2.3
+ Number of bytes of input read is written to the ``position`` field
+ of the :type:`json_error_t` structure.
+
+If no error or position information is needed, you can pass *NULL*.
+
+The following functions perform the actual JSON decoding.
+
+.. function:: json_t *json_loads(const char *input, size_t flags, json_error_t *error)
+
+ .. refcounting:: new
+
+ Decodes the JSON string *input* and returns the array or object it
+ contains, or *NULL* on error, in which case *error* is filled with
+ information about the error. *flags* is described above.
+
+.. function:: json_t *json_loadb(const char *buffer, size_t buflen, size_t flags, json_error_t *error)
+
+ .. refcounting:: new
+
+ Decodes the JSON string *buffer*, whose length is *buflen*, and
+ returns the array or object it contains, or *NULL* on error, in
+ which case *error* is filled with information about the error. This
+ is similar to :func:`json_loads()` except that the string doesn't
+ need to be null-terminated. *flags* is described above.
+
+ .. versionadded:: 2.1
+
+.. function:: json_t *json_loadf(FILE *input, size_t flags, json_error_t *error)
+
+ .. refcounting:: new
+
+ Decodes the JSON text in stream *input* and returns the array or
+ object it contains, or *NULL* on error, in which case *error* is
+ filled with information about the error. *flags* is described
+ above.
+
+ This function will start reading the input from whatever position
+ the input file was, without attempting to seek first. If an error
+ occurs, the file position will be left indeterminate. On success,
+ the file position will be at EOF, unless ``JSON_DISABLE_EOF_CHECK``
+ flag was used. In this case, the file position will be at the first
+ character after the last ``]`` or ``}`` in the JSON input. This
+ allows calling :func:`json_loadf()` on the same ``FILE`` object
+ multiple times, if the input consists of consecutive JSON texts,
+ possibly separated by whitespace.
+
+.. function:: json_t *json_load_file(const char *path, size_t flags, json_error_t *error)
+
+ .. refcounting:: new
+
+ Decodes the JSON text in file *path* and returns the array or
+ object it contains, or *NULL* on error, in which case *error* is
+ filled with information about the error. *flags* is described
+ above.
+
+.. type:: json_load_callback_t
+
+ A typedef for a function that's called by
+ :func:`json_load_callback()` to read a chunk of input data::
+
+ typedef size_t (*json_load_callback_t)(void *buffer, size_t buflen, void *data);
+
+ *buffer* points to a buffer of *buflen* bytes, and *data* is the
+ corresponding :func:`json_load_callback()` argument passed through.
+
+ On success, the function should return the number of bytes read; a
+ returned value of 0 indicates that no data was read and that the
+ end of file has been reached. On error, the function should return
+ ``(size_t)-1`` to abort the decoding process.
+
+ .. versionadded:: 2.4
+
+.. function:: json_t *json_load_callback(json_load_callback_t callback, void *data, size_t flags, json_error_t *error)
+
+ .. refcounting:: new
+
+ Decodes the JSON text produced by repeated calls to *callback*, and
+ returns the array or object it contains, or *NULL* on error, in
+ which case *error* is filled with information about the error.
+ *data* is passed through to *callback* on each call. *flags* is
+ described above.
+
+ .. versionadded:: 2.4
+
+
+.. _apiref-pack:
+
+Building Values
+===============
+
+This section describes functions that help to create, or *pack*,
+complex JSON values, especially nested objects and arrays. Value
+building is based on a *format string* that is used to tell the
+functions about the expected arguments.
+
+For example, the format string ``"i"`` specifies a single integer
+value, while the format string ``"[ssb]"`` or the equivalent ``"[s, s,
+b]"`` specifies an array value with two strings and a boolean as its
+items::
+
+ /* Create the JSON integer 42 */
+ json_pack("i", 42);
+
+ /* Create the JSON array ["foo", "bar", true] */
+ json_pack("[ssb]", "foo", "bar", 1);
+
+Here's the full list of format specifiers. The type in parentheses
+denotes the resulting JSON type, and the type in brackets (if any)
+denotes the C type that is expected as the corresponding argument or
+arguments.
+
+``s`` (string) [const char \*]
+ Convert a NULL terminated UTF-8 string to a JSON string.
+
+``s#`` (string) [const char \*, int]
+ Convert a UTF-8 buffer of a given length to a JSON string.
+
+ .. versionadded:: 2.5
+
+``s%`` (string) [const char \*, size_t]
+ Like ``s#`` but the length argument is of type :type:`size_t`.
+
+ .. versionadded:: 2.6
+
+``+`` [const char \*]
+ Like ``s``, but concatenate to the previous string. Only valid
+ after ``s``, ``s#``, ``+`` or ``+#``.
+
+ .. versionadded:: 2.5
+
+``+#`` [const char \*, int]
+ Like ``s#``, but concatenate to the previous string. Only valid
+ after ``s``, ``s#``, ``+`` or ``+#``.
+
+ .. versionadded:: 2.5
+
+``+%`` (string) [const char \*, size_t]
+ Like ``+#`` but the length argument is of type :type:`size_t`.
+
+ .. versionadded:: 2.6
+
+``n`` (null)
+ Output a JSON null value. No argument is consumed.
+
+``b`` (boolean) [int]
+ Convert a C :type:`int` to JSON boolean value. Zero is converted
+ to ``false`` and non-zero to ``true``.
+
+``i`` (integer) [int]
+ Convert a C :type:`int` to JSON integer.
+
+``I`` (integer) [json_int_t]
+ Convert a C :type:`json_int_t` to JSON integer.
+
+``f`` (real) [double]
+ Convert a C :type:`double` to JSON real.
+
+``o`` (any value) [json_t \*]
+ Output any given JSON value as-is. If the value is added to an
+ array or object, the reference to the value passed to ``o`` is
+ stolen by the container.
+
+``O`` (any value) [json_t \*]
+ Like ``o``, but the argument's reference count is incremented.
+ This is useful if you pack into an array or object and want to
+ keep the reference for the JSON value consumed by ``O`` to
+ yourself.
+
+``[fmt]`` (array)
+ Build an array with contents from the inner format string. ``fmt``
+ may contain objects and arrays, i.e. recursive value building is
+ supported.
+
+``{fmt}`` (object)
+ Build an object with contents from the inner format string
+ ``fmt``. The first, third, etc. format specifier represent a key,
+ and must be a string (see ``s``, ``s#``, ``+`` and ``+#`` above),
+ as object keys are always strings. The second, fourth, etc. format
+ specifier represent a value. Any value may be an object or array,
+ i.e. recursive value building is supported.
+
+Whitespace, ``:`` and ``,`` are ignored.
+
+The following functions compose the value building API:
+
+.. function:: json_t *json_pack(const char *fmt, ...)
+
+ .. refcounting:: new
+
+ Build a new JSON value according to the format string *fmt*. For
+ each format specifier (except for ``{}[]n``), one or more arguments
+ are consumed and used to build the corresponding value. Returns
+ *NULL* on error.
+
+.. function:: json_t *json_pack_ex(json_error_t *error, size_t flags, const char *fmt, ...)
+ json_t *json_vpack_ex(json_error_t *error, size_t flags, const char *fmt, va_list ap)
+
+ .. refcounting:: new
+
+ Like :func:`json_pack()`, but an in the case of an error, an error
+ message is written to *error*, if it's not *NULL*. The *flags*
+ parameter is currently unused and should be set to 0.
+
+ As only the errors in format string (and out-of-memory errors) can
+ be caught by the packer, these two functions are most likely only
+ useful for debugging format strings.
+
+More examples::
+
+ /* Build an empty JSON object */
+ json_pack("{}");
+
+ /* Build the JSON object {"foo": 42, "bar": 7} */
+ json_pack("{sisi}", "foo", 42, "bar", 7);
+
+ /* Like above, ':', ',' and whitespace are ignored */
+ json_pack("{s:i, s:i}", "foo", 42, "bar", 7);
+
+ /* Build the JSON array [[1, 2], {"cool": true}] */
+ json_pack("[[i,i],{s:b}]", 1, 2, "cool", 1);
+
+ /* Build a string from a non-NUL terminated buffer */
+ char buffer[4] = {'t', 'e', 's', 't'};
+ json_pack("s#", buffer, 4);
+
+ /* Concatentate strings together to build the JSON string "foobarbaz" */
+ json_pack("s++", "foo", "bar", "baz");
+
+
+.. _apiref-unpack:
+
+Parsing and Validating Values
+=============================
+
+This section describes functions that help to validate complex values
+and extract, or *unpack*, data from them. Like :ref:`building values
+<apiref-pack>`, this is also based on format strings.
+
+While a JSON value is unpacked, the type specified in the format
+string is checked to match that of the JSON value. This is the
+validation part of the process. In addition to this, the unpacking
+functions can also check that all items of arrays and objects are
+unpacked. This check be enabled with the format specifier ``!`` or by
+using the flag ``JSON_STRICT``. See below for details.
+
+Here's the full list of format specifiers. The type in parentheses
+denotes the JSON type, and the type in brackets (if any) denotes the C
+type whose address should be passed.
+
+``s`` (string) [const char \*]
+ Convert a JSON string to a pointer to a NULL terminated UTF-8
+ string. The resulting string is extracted by using
+ :func:`json_string_value()` internally, so it exists as long as
+ there are still references to the corresponding JSON string.
+
+``s%`` (string) [const char \*, size_t \*]
+ Convert a JSON string to a pointer to a NULL terminated UTF-8
+ string and its length.
+
+ .. versionadded:: 2.6
+
+``n`` (null)
+ Expect a JSON null value. Nothing is extracted.
+
+``b`` (boolean) [int]
+ Convert a JSON boolean value to a C :type:`int`, so that ``true``
+ is converted to 1 and ``false`` to 0.
+
+``i`` (integer) [int]
+ Convert a JSON integer to C :type:`int`.
+
+``I`` (integer) [json_int_t]
+ Convert a JSON integer to C :type:`json_int_t`.
+
+``f`` (real) [double]
+ Convert a JSON real to C :type:`double`.
+
+``F`` (integer or real) [double]
+ Convert a JSON number (integer or real) to C :type:`double`.
+
+``o`` (any value) [json_t \*]
+ Store a JSON value with no conversion to a :type:`json_t` pointer.
+
+``O`` (any value) [json_t \*]
+ Like ``O``, but the JSON value's reference count is incremented.
+
+``[fmt]`` (array)
+ Convert each item in the JSON array according to the inner format
+ string. ``fmt`` may contain objects and arrays, i.e. recursive
+ value extraction is supporetd.
+
+``{fmt}`` (object)
+ Convert each item in the JSON object according to the inner format
+ string ``fmt``. The first, third, etc. format specifier represent
+ a key, and must be ``s``. The corresponding argument to unpack
+ functions is read as the object key. The second fourth, etc.
+ format specifier represent a value and is written to the address
+ given as the corresponding argument. **Note** that every other
+ argument is read from and every other is written to.
+
+ ``fmt`` may contain objects and arrays as values, i.e. recursive
+ value extraction is supporetd.
+
+ .. versionadded:: 2.3
+ Any ``s`` representing a key may be suffixed with a ``?`` to
+ make the key optional. If the key is not found, nothing is
+ extracted. See below for an example.
+
+``!``
+ This special format specifier is used to enable the check that
+ all object and array items are accessed, on a per-value basis. It
+ must appear inside an array or object as the last format specifier
+ before the closing bracket or brace. To enable the check globally,
+ use the ``JSON_STRICT`` unpacking flag.
+
+``*``
+ This special format specifier is the opposite of ``!``. If the
+ ``JSON_STRICT`` flag is used, ``*`` can be used to disable the
+ strict check on a per-value basis. It must appear inside an array
+ or object as the last format specifier before the closing bracket
+ or brace.
+
+Whitespace, ``:`` and ``,`` are ignored.
+
+The following functions compose the parsing and validation API:
+
+.. function:: int json_unpack(json_t *root, const char *fmt, ...)
+
+ Validate and unpack the JSON value *root* according to the format
+ string *fmt*. Returns 0 on success and -1 on failure.
+
+.. function:: int json_unpack_ex(json_t *root, json_error_t *error, size_t flags, const char *fmt, ...)
+ int json_vunpack_ex(json_t *root, json_error_t *error, size_t flags, const char *fmt, va_list ap)
+
+ Validate and unpack the JSON value *root* according to the format
+ string *fmt*. If an error occurs and *error* is not *NULL*, write
+ error information to *error*. *flags* can be used to control the
+ behaviour of the unpacker, see below for the flags. Returns 0 on
+ success and -1 on failure.
+
+.. note::
+
+ The first argument of all unpack functions is ``json_t *root``
+ instead of ``const json_t *root``, because the use of ``O`` format
+ specifier causes the reference count of ``root``, or some value
+ reachable from ``root``, to be increased. Furthermore, the ``o``
+ format specifier may be used to extract a value as-is, which allows
+ modifying the structure or contents of a value reachable from
+ ``root``.
+
+ If the ``O`` and ``o`` format specifiers are not used, it's
+ perfectly safe to cast a ``const json_t *`` variable to plain
+ ``json_t *`` when used with these functions.
+
+The following unpacking flags are available:
+
+``JSON_STRICT``
+ Enable the extra validation step checking that all object and
+ array items are unpacked. This is equivalent to appending the
+ format specifier ``!`` to the end of every array and object in the
+ format string.
+
+``JSON_VALIDATE_ONLY``
+ Don't extract any data, just validate the JSON value against the
+ given format string. Note that object keys must still be specified
+ after the format string.
+
+Examples::
+
+ /* root is the JSON integer 42 */
+ int myint;
+ json_unpack(root, "i", &myint);
+ assert(myint == 42);
+
+ /* root is the JSON object {"foo": "bar", "quux": true} */
+ const char *str;
+ int boolean;
+ json_unpack(root, "{s:s, s:b}", "foo", &str, "quux", &boolean);
+ assert(strcmp(str, "bar") == 0 && boolean == 1);
+
+ /* root is the JSON array [[1, 2], {"baz": null} */
+ json_error_t error;
+ json_unpack_ex(root, &error, JSON_VALIDATE_ONLY, "[[i,i], {s:n}]", "baz");
+ /* returns 0 for validation success, nothing is extracted */
+
+ /* root is the JSON array [1, 2, 3, 4, 5] */
+ int myint1, myint2;
+ json_unpack(root, "[ii!]", &myint1, &myint2);
+ /* returns -1 for failed validation */
+
+ /* root is an empty JSON object */
+ int myint = 0, myint2 = 0;
+ json_unpack(root, "{s?i, s?[ii]}",
+ "foo", &myint1,
+ "bar", &myint2, &myint3);
+ /* myint1, myint2 or myint3 is no touched as "foo" and "bar" don't exist */
+
+
+Equality
+========
+
+Testing for equality of two JSON values cannot, in general, be
+achieved using the ``==`` operator. Equality in the terms of the
+``==`` operator states that the two :type:`json_t` pointers point to
+exactly the same JSON value. However, two JSON values can be equal not
+only if they are exactly the same value, but also if they have equal
+"contents":
+
+* Two integer or real values are equal if their contained numeric
+ values are equal. An integer value is never equal to a real value,
+ though.
+
+* Two strings are equal if their contained UTF-8 strings are equal,
+ byte by byte. Unicode comparison algorithms are not implemented.
+
+* Two arrays are equal if they have the same number of elements and
+ each element in the first array is equal to the corresponding
+ element in the second array.
+
+* Two objects are equal if they have exactly the same keys and the
+ value for each key in the first object is equal to the value of the
+ corresponding key in the second object.
+
+* Two true, false or null values have no "contents", so they are equal
+ if their types are equal. (Because these values are singletons,
+ their equality can actually be tested with ``==``.)
+
+The following function can be used to test whether two JSON values are
+equal.
+
+.. function:: int json_equal(json_t *value1, json_t *value2)
+
+ Returns 1 if *value1* and *value2* are equal, as defined above.
+ Returns 0 if they are inequal or one or both of the pointers are
+ *NULL*.
+
+
+Copying
+=======
+
+Because of reference counting, passing JSON values around doesn't
+require copying them. But sometimes a fresh copy of a JSON value is
+needed. For example, if you need to modify an array, but still want to
+use the original afterwards, you should take a copy of it first.
+
+Jansson supports two kinds of copying: shallow and deep. There is a
+difference between these methods only for arrays and objects. Shallow
+copying only copies the first level value (array or object) and uses
+the same child values in the copied value. Deep copying makes a fresh
+copy of the child values, too. Moreover, all the child values are deep
+copied in a recursive fashion.
+
+.. function:: json_t *json_copy(json_t *value)
+
+ .. refcounting:: new
+
+ Returns a shallow copy of *value*, or *NULL* on error.
+
+.. function:: json_t *json_deep_copy(const json_t *value)
+
+ .. refcounting:: new
+
+ Returns a deep copy of *value*, or *NULL* on error.
+
+
+.. _apiref-custom-memory-allocation:
+
+Custom Memory Allocation
+========================
+
+By default, Jansson uses :func:`malloc()` and :func:`free()` for
+memory allocation. These functions can be overridden if custom
+behavior is needed.
+
+.. type:: json_malloc_t
+
+ A typedef for a function pointer with :func:`malloc()`'s
+ signature::
+
+ typedef void *(*json_malloc_t)(size_t);
+
+.. type:: json_free_t
+
+ A typedef for a function pointer with :func:`free()`'s
+ signature::
+
+ typedef void (*json_free_t)(void *);
+
+.. function:: void json_set_alloc_funcs(json_malloc_t malloc_fn, json_free_t free_fn)
+
+ Use *malloc_fn* instead of :func:`malloc()` and *free_fn* instead
+ of :func:`free()`. This function has to be called before any other
+ Jansson's API functions to ensure that all memory operations use
+ the same functions.
+
+**Examples:**
+
+Circumvent problems with different CRT heaps on Windows by using
+application's :func:`malloc()` and :func:`free()`::
+
+ json_set_alloc_funcs(malloc, free);
+
+Use the `Boehm's conservative garbage collector`_ for memory
+operations::
+
+ json_set_alloc_funcs(GC_malloc, GC_free);
+
+.. _Boehm's conservative garbage collector: http://www.hpl.hp.com/personal/Hans_Boehm/gc/
+
+Allow storing sensitive data (e.g. passwords or encryption keys) in
+JSON structures by zeroing all memory when freed::
+
+ static void *secure_malloc(size_t size)
+ {
+ /* Store the memory area size in the beginning of the block */
+ void *ptr = malloc(size + 8);
+ *((size_t *)ptr) = size;
+ return ptr + 8;
+ }
+
+ static void secure_free(void *ptr)
+ {
+ size_t size;
+
+ ptr -= 8;
+ size = *((size_t *)ptr);
+
+ guaranteed_memset(ptr, 0, size + 8);
+ free(ptr);
+ }
+
+ int main()
+ {
+ json_set_alloc_funcs(secure_malloc, secure_free);
+ /* ... */
+ }
+
+For more information about the issues of storing sensitive data in
+memory, see
+http://www.dwheeler.com/secure-programs/Secure-Programs-HOWTO/protect-secrets.html.
+The page also explains the :func:`guaranteed_memset()` function used
+in the example and gives a sample implementation for it.
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_sources/changes.txt Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,5 @@
+******************
+Changes in Jansson
+******************
+
+.. include:: ../CHANGES
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_sources/conformance.txt Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,110 @@
+.. _rfc-conformance:
+
+***************
+RFC Conformance
+***************
+
+JSON is specified in :rfc:`4627`, *"The application/json Media Type
+for JavaScript Object Notation (JSON)"*.
+
+Character Encoding
+==================
+
+Jansson only supports UTF-8 encoded JSON texts. It does not support or
+auto-detect any of the other encodings mentioned in the RFC, namely
+UTF-16LE, UTF-16BE, UTF-32LE or UTF-32BE. Pure ASCII is supported, as
+it's a subset of UTF-8.
+
+Strings
+=======
+
+JSON strings are mapped to C-style null-terminated character arrays,
+and UTF-8 encoding is used internally.
+
+All Unicode codepoints U+0000 through U+10FFFF are allowed in string
+values. However, U+0000 is not allowed in object keys because of API
+restrictions.
+
+Unicode normalization or any other transformation is never performed
+on any strings (string values or object keys). When checking for
+equivalence of strings or object keys, the comparison is performed
+byte by byte between the original UTF-8 representations of the
+strings.
+
+Numbers
+=======
+
+.. _real-vs-integer:
+
+Real vs. Integer
+----------------
+
+JSON makes no distinction between real and integer numbers; Jansson
+does. Real numbers are mapped to the ``double`` type and integers to
+the ``json_int_t`` type, which is a typedef of ``long long`` or
+``long``, depending on whether ``long long`` is supported by your
+compiler or not.
+
+A JSON number is considered to be a real number if its lexical
+representation includes one of ``e``, ``E``, or ``.``; regardless if
+its actual numeric value is a true integer (e.g., all of ``1E6``,
+``3.0``, ``400E-2``, and ``3.14E3`` are mathematical integers, but
+will be treated as real values). With the ``JSON_DECODE_INT_AS_REAL``
+decoder flag set all numbers are interpreted as real.
+
+All other JSON numbers are considered integers.
+
+When encoding to JSON, real values are always represented
+with a fractional part; e.g., the ``double`` value 3.0 will be
+represented in JSON as ``3.0``, not ``3``.
+
+Overflow, Underflow & Precision
+-------------------------------
+
+Real numbers whose absolute values are too small to be represented in
+a C ``double`` will be silently estimated with 0.0. Thus, depending on
+platform, JSON numbers very close to zero such as 1E-999 may result in
+0.0.
+
+Real numbers whose absolute values are too large to be represented in
+a C ``double`` will result in an overflow error (a JSON decoding
+error). Thus, depending on platform, JSON numbers like 1E+999 or
+-1E+999 may result in a parsing error.
+
+Likewise, integer numbers whose absolute values are too large to be
+represented in the ``json_int_t`` type (see above) will result in an
+overflow error (a JSON decoding error). Thus, depending on platform,
+JSON numbers like 1000000000000000 may result in parsing error.
+
+Parsing JSON real numbers may result in a loss of precision. As long
+as overflow does not occur (i.e. a total loss of precision), the
+rounded approximate value is silently used. Thus the JSON number
+1.000000000000000005 may, depending on platform, result in the
+``double`` value 1.0.
+
+Signed zeros
+------------
+
+JSON makes no statement about what a number means; however Javascript
+(ECMAscript) does state that +0.0 and -0.0 must be treated as being
+distinct values, i.e. -0.0 |not-equal| 0.0. Jansson relies on the
+underlying floating point library in the C environment in which it is
+compiled. Therefore it is platform-dependent whether 0.0 and -0.0 will
+be distinct values. Most platforms that use the IEEE 754
+floating-point standard will support signed zeros.
+
+Note that this only applies to floating-point; neither JSON, C, or
+IEEE support the concept of signed integer zeros.
+
+.. |not-equal| unicode:: U+2260
+
+Types
+-----
+
+No support is provided in Jansson for any C numeric types other than
+``json_int_t`` and ``double``. This excludes things such as unsigned
+types, ``long double``, etc. Obviously, shorter types like ``short``,
+``int``, ``long`` (if ``json_int_t`` is ``long long``) and ``float``
+are implicitly handled via the ordinary C type coercion rules (subject
+to overflow semantics). Also, no support or hooks are provided for any
+supplemental "bignum" type add-on packages.
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_sources/gettingstarted.txt Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,227 @@
+***************
+Getting Started
+***************
+
+.. highlight:: c
+
+Compiling and Installing Jansson
+================================
+
+The Jansson source is available at
+http://www.digip.org/jansson/releases/.
+
+Unix-like systems (including MinGW)
+-----------------------------------
+
+Unpack the source tarball and change to the source directory:
+
+.. parsed-literal::
+
+ bunzip2 -c jansson-|release|.tar.bz2 | tar xf -
+ cd jansson-|release|
+
+The source uses GNU Autotools (autoconf_, automake_, libtool_), so
+compiling and installing is extremely simple::
+
+ ./configure
+ make
+ make check
+ make install
+
+To change the destination directory (``/usr/local`` by default), use
+the ``--prefix=DIR`` argument to ``./configure``. See ``./configure
+--help`` for the list of all possible installation options. (There are
+no options to customize the resulting Jansson binary.)
+
+The command ``make check`` runs the test suite distributed with
+Jansson. This step is not strictly necessary, but it may find possible
+problems that Jansson has on your platform. If any problems are found,
+please report them.
+
+If you obtained the source from a Git repository (or any other source
+control system), there's no ``./configure`` script as it's not kept in
+version control. To create the script, the build system needs to be
+bootstrapped. There are many ways to do this, but the easiest one is
+to use ``autoreconf``::
+
+ autoreconf -vi
+
+This command creates the ``./configure`` script, which can then be
+used as described above.
+
+.. _autoconf: http://www.gnu.org/software/autoconf/
+.. _automake: http://www.gnu.org/software/automake/
+.. _libtool: http://www.gnu.org/software/libtool/
+
+
+.. _build-cmake:
+
+CMake (various platforms, including Windows)
+--------------------------------------------
+
+Jansson can be built using CMake_. Create a build directory for an
+out-of-tree build, change to that directory, and run ``cmake`` (or ``ccmake``,
+``cmake-gui``, or similar) to configure the project.
+
+See the examples below for more detailed information.
+
+.. note:: In the below examples ``..`` is used as an argument for ``cmake``.
+ This is simply the path to the jansson project root directory.
+ In the example it is assumed you've created a sub-directory ``build``
+ and are using that. You could use any path you want.
+
+.. _build-cmake-unix:
+
+Unix (Make files)
+^^^^^^^^^^^^^^^^^
+Generating make files on unix:
+
+.. parsed-literal::
+
+ bunzip2 -c jansson-|release|.tar.bz2 | tar xf -
+ cd jansson-|release|
+
+ mkdir build
+ cd build
+ cmake .. # or `ccmake ..` for a GUI.
+
+Then to build::
+
+ make
+ make check
+ make install
+
+Windows (Visual Studio)
+^^^^^^^^^^^^^^^^^^^^^^^
+Creating Visual Studio project files from the command line:
+
+.. parsed-literal::
+
+ <unpack>
+ cd jansson-|release|
+
+ md build
+ cd build
+ cmake -G "Visual Studio 10" ..
+
+You will now have a *Visual Studio Solution* in your build directory.
+To run the unit tests build the ``RUN_TESTS`` project.
+
+If you prefer a GUI the ``cmake`` line in the above example can
+be replaced with::
+
+ cmake-gui ..
+
+For command line help (including a list of available generators)
+for CMake_ simply run::
+
+ cmake
+
+To list available CMake_ settings (and what they are currently set to)
+for the project, run::
+
+ cmake -LH ..
+
+Mac OSX (Xcode)
+^^^^^^^^^^^^^^^
+If you prefer using Xcode instead of make files on OSX,
+do the following. (Use the same steps as
+for :ref:`Unix <build-cmake-unix>`)::
+
+ ...
+ cmake -G "Xcode" ..
+
+Additional CMake settings
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Shared library
+""""""""""""""
+By default the CMake_ project will generate build files for building the
+static library. To build the shared version use::
+
+ ...
+ cmake -DJANSSON_BUILD_SHARED_LIBS=1 ..
+
+Changing install directory (same as autoconf --prefix)
+""""""""""""""""""""""""""""""""""""""""""""""""""""""
+Just as with the autoconf_ project you can change the destination directory
+for ``make install``. The equivalent for autoconfs ``./configure --prefix``
+in CMake_ is::
+
+ ...
+ cmake -DCMAKE_INSTALL_PREFIX:PATH=/some/other/path ..
+ make install
+
+.. _CMake: http://www.cmake.org
+
+
+Android
+-------
+
+Jansson can be built for Android platforms. Android.mk is in the
+source root directory. The configuration header file is located in the
+``android`` directory in the source distribution.
+
+
+Other Systems
+-------------
+
+On non Unix-like systems, you may be unable to run the ``./configure``
+script. In this case, follow these steps. All the files mentioned can
+be found in the ``src/`` directory.
+
+1. Create ``jansson_config.h`` (which has some platform-specific
+ parameters that are normally filled in by the ``./configure``
+ script). Edit ``jansson_config.h.in``, replacing all ``@variable@``
+ placeholders, and rename the file to ``jansson_config.h``.
+
+2. Make ``jansson.h`` and ``jansson_config.h`` available to the
+ compiler, so that they can be found when compiling programs that
+ use Jansson.
+
+3. Compile all the ``.c`` files (in the ``src/`` directory) into a
+ library file. Make the library available to the compiler, as in
+ step 2.
+
+
+Building the Documentation
+--------------------------
+
+(This subsection describes how to build the HTML documentation you are
+currently reading, so it can be safely skipped.)
+
+Documentation is in the ``doc/`` subdirectory. It's written in
+reStructuredText_ with Sphinx_ annotations. To generate the HTML
+documentation, invoke::
+
+ make html
+
+and point your browser to ``doc/_build/html/index.html``. Sphinx_ 1.0
+or newer is required to generate the documentation.
+
+.. _reStructuredText: http://docutils.sourceforge.net/rst.html
+.. _Sphinx: http://sphinx.pocoo.org/
+
+
+Compiling Programs that Use Jansson
+===================================
+
+Jansson involves one C header file, :file:`jansson.h`, so it's enough
+to put the line
+
+::
+
+ #include <jansson.h>
+
+in the beginning of every source file that uses Jansson.
+
+There's also just one library to link with, ``libjansson``. Compile and
+link the program as follows::
+
+ cc -I /usr/include/jansson -o prog prog.c -ljansson
+
+Starting from version 1.2, there's also support for pkg-config_::
+
+ cc -o prog prog.c `pkg-config --cflags --libs jansson`
+
+.. _pkg-config: http://pkg-config.freedesktop.org/
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_sources/index.txt Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,53 @@
+Jansson Documentation
+=====================
+
+This is the documentation for Jansson_ |release|, last updated |today|.
+
+Introduction
+------------
+
+Jansson_ is a C library for encoding, decoding and manipulating JSON
+data. Its main features and design principles are:
+
+- Simple and intuitive API and data model
+
+- Comprehensive documentation
+
+- No dependencies on other libraries
+
+- Full Unicode support (UTF-8)
+
+- Extensive test suite
+
+Jansson is licensed under the `MIT license`_; see LICENSE in the
+source distribution for details.
+
+Jansson is used in production and its API is stable. It works on
+numerous platforms, including numerous Unix like systems and Windows.
+It's suitable for use on any system, including desktop, server, and
+small embedded systems.
+
+
+.. _`MIT license`: http://www.opensource.org/licenses/mit-license.php
+.. _Jansson: http://www.digip.org/jansson/
+
+Contents
+--------
+
+.. toctree::
+ :maxdepth: 2
+
+ gettingstarted
+ upgrading
+ tutorial
+ conformance
+ portability
+ apiref
+ changes
+
+
+Indices and Tables
+==================
+
+* :ref:`genindex`
+* :ref:`search`
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_sources/portability.txt Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,83 @@
+***********
+Portability
+***********
+
+.. _portability-thread-safety:
+
+Thread safety
+-------------
+
+Jansson is thread safe and has no mutable global state. The only
+exceptions are the hash function seed and memory allocation functions,
+see below.
+
+There's no locking performed inside Jansson's code, so a multithreaded
+program must perform its own locking if JSON values are shared by
+multiple threads. Jansson's reference counting semantics may make this
+a bit harder than it seems, as it's possible to have a reference to a
+value that's also stored inside a list or object. Modifying the
+container (adding or removing values) may trigger concurrent access to
+such values, as containers manage the reference count of their
+contained values. Bugs involving concurrent incrementing or
+decrementing of deference counts may be hard to track.
+
+The encoding functions (:func:`json_dumps()` and friends) track
+reference loops by modifying the internal state of objects and arrays.
+For this reason, encoding functions must not be run on the same JSON
+values in two separate threads at the same time. As already noted
+above, be especially careful if two arrays or objects share their
+contained values with another array or object.
+
+If you want to make sure that two JSON value hierarchies do not
+contain shared values, use :func:`json_deep_copy()` to make copies.
+
+
+Hash function seed
+==================
+
+To prevent an attacker from intentionally causing large JSON objects
+with specially crafted keys to perform very slow, the hash function
+used by Jansson is randomized using a seed value. The seed is
+automatically generated on the first explicit or implicit call to
+:func:`json_object()`, if :func:`json_object_seed()` has not been
+called beforehand.
+
+The seed is generated by using operating system's entropy sources if
+they are available (``/dev/urandom``, ``CryptGenRandom()``). The
+initialization is done in as thread safe manner as possible, by using
+architecture specific lockless operations if provided by the platform
+or the compiler.
+
+If you're using threads, it's recommended to autoseed the hashtable
+explicitly before spawning any threads by calling
+``json_object_seed(0)`` , especially if you're unsure whether the
+initialization is thread safe on your platform.
+
+
+Memory allocation functions
+===========================
+
+Memory allocation functions should be set at most once, and only on
+program startup. See :ref:`apiref-custom-memory-allocation`.
+
+
+Locale
+------
+
+Jansson works fine under any locale.
+
+However, if the host program is multithreaded and uses ``setlocale()``
+to switch the locale in one thread while Jansson is currently encoding
+or decoding JSON data in another thread, the result may be wrong or
+the program may even crash.
+
+Jansson uses locale specific functions for certain string conversions
+in the encoder and decoder, and then converts the locale specific
+values to/from the JSON representation. This fails if the locale
+changes between the string conversion and the locale-to-JSON
+conversion. This can only happen in multithreaded programs that use
+``setlocale()``, because ``setlocale()`` switches the locale for all
+running threads, not only the thread that calls ``setlocale()``.
+
+If your program uses ``setlocale()`` as described above, consider
+using the thread-safe ``uselocale()`` instead.
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_sources/tutorial.txt Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,286 @@
+.. _tutorial:
+
+********
+Tutorial
+********
+
+.. highlight:: c
+
+In this tutorial, we create a program that fetches the latest commits
+of a repository in GitHub_ over the web. `GitHub API`_ uses JSON, so
+the result can be parsed using Jansson.
+
+To stick to the the scope of this tutorial, we will only cover the the
+parts of the program related to handling JSON data. For the best user
+experience, the full source code is available:
+:download:`github_commits.c`. To compile it (on Unix-like systems with
+gcc), use the following command::
+
+ gcc -o github_commits github_commits.c -ljansson -lcurl
+
+libcurl_ is used to communicate over the web, so it is required to
+compile the program.
+
+The command line syntax is::
+
+ github_commits USER REPOSITORY
+
+``USER`` is a GitHub user ID and ``REPOSITORY`` is the repository
+name. Please note that the GitHub API is rate limited, so if you run
+the program too many times within a short period of time, the sever
+starts to respond with an error.
+
+.. _GitHub: https://github.com/
+.. _GitHub API: http://developer.github.com/
+.. _libcurl: http://curl.haxx.se/
+
+
+.. _tutorial-github-commits-api:
+
+The GitHub Repo Commits API
+===========================
+
+The `GitHub Repo Commits API`_ is used by sending HTTP requests to
+URLs like ``https://api.github.com/repos/USER/REPOSITORY/commits``,
+where ``USER`` and ``REPOSITORY`` are the GitHub user ID and the name
+of the repository whose commits are to be listed, respectively.
+
+GitHub responds with a JSON array of the following form:
+
+.. code-block:: none
+
+ [
+ {
+ "sha": "<the commit ID>",
+ "commit": {
+ "message": "<the commit message>",
+ <more fields, not important to this tutorial...>
+ },
+ <more fields...>
+ },
+ {
+ "sha": "<the commit ID>",
+ "commit": {
+ "message": "<the commit message>",
+ <more fields...>
+ },
+ <more fields...>
+ },
+ <more commits...>
+ ]
+
+In our program, the HTTP request is sent using the following
+function::
+
+ static char *request(const char *url);
+
+It takes the URL as a parameter, preforms a HTTP GET request, and
+returns a newly allocated string that contains the response body. If
+the request fails, an error message is printed to stderr and the
+return value is *NULL*. For full details, refer to :download:`the code
+<github_commits.c>`, as the actual implementation is not important
+here.
+
+.. _GitHub Repo Commits API: http://developer.github.com/v3/repos/commits/
+
+.. _tutorial-the-program:
+
+The Program
+===========
+
+First the includes::
+
+ #include <string.h>
+ #include <jansson.h>
+
+Like all the programs using Jansson, we need to include
+:file:`jansson.h`.
+
+The following definitions are used to build the GitHub API request
+URL::
+
+ #define URL_FORMAT "https://api.github.com/repos/%s/%s/commits"
+ #define URL_SIZE 256
+
+The following function is used when formatting the result to find the
+first newline in the commit message::
+
+ /* Return the offset of the first newline in text or the length of
+ text if there's no newline */
+ static int newline_offset(const char *text)
+ {
+ const char *newline = strchr(text, '\n');
+ if(!newline)
+ return strlen(text);
+ else
+ return (int)(newline - text);
+ }
+
+The main function follows. In the beginning, we first declare a bunch
+of variables and check the command line parameters::
+
+ int main(int argc, char *argv[])
+ {
+ size_t i;
+ char *text;
+ char url[URL_SIZE];
+
+ json_t *root;
+ json_error_t error;
+
+ if(argc != 3)
+ {
+ fprintf(stderr, "usage: %s USER REPOSITORY\n\n", argv[0]);
+ fprintf(stderr, "List commits at USER's REPOSITORY.\n\n");
+ return 2;
+ }
+
+Then we build the request URL using the user and repository names
+given as command line parameters::
+
+ snprintf(url, URL_SIZE, URL_FORMAT, argv[1], argv[2]);
+
+This uses the ``URL_SIZE`` and ``URL_FORMAT`` constants defined above.
+Now we're ready to actually request the JSON data over the web::
+
+ text = request(url);
+ if(!text)
+ return 1;
+
+If an error occurs, our function ``request`` prints the error and
+returns *NULL*, so it's enough to just return 1 from the main
+function.
+
+Next we'll call :func:`json_loads()` to decode the JSON text we got
+as a response::
+
+ root = json_loads(text, 0, &error);
+ free(text);
+
+ if(!root)
+ {
+ fprintf(stderr, "error: on line %d: %s\n", error.line, error.text);
+ return 1;
+ }
+
+We don't need the JSON text anymore, so we can free the ``text``
+variable right after decoding it. If :func:`json_loads()` fails, it
+returns *NULL* and sets error information to the :type:`json_error_t`
+structure given as the second parameter. In this case, our program
+prints the error information out and returns 1 from the main function.
+
+Now we're ready to extract the data out of the decoded JSON response.
+The structure of the response JSON was explained in section
+:ref:`tutorial-github-commits-api`.
+
+We check that the returned value really is an array::
+
+ if(!json_is_array(root))
+ {
+ fprintf(stderr, "error: root is not an array\n");
+ json_decref(root);
+ return 1;
+ }
+
+Then we proceed to loop over all the commits in the array::
+
+ for(i = 0; i < json_array_size(root); i++)
+ {
+ json_t *data, *sha, *commit, *message;
+ const char *message_text;
+
+ data = json_array_get(root, i);
+ if(!json_is_object(data))
+ {
+ fprintf(stderr, "error: commit data %d is not an object\n", i + 1);
+ json_decref(root);
+ return 1;
+ }
+ ...
+
+The function :func:`json_array_size()` returns the size of a JSON
+array. First, we again declare some variables and then extract the
+i'th element of the ``root`` array using :func:`json_array_get()`.
+We also check that the resulting value is a JSON object.
+
+Next we'll extract the commit ID (a hexadecimal SHA-1 sum),
+intermediate commit info object, and the commit message from that
+object. We also do proper type checks::
+
+ sha = json_object_get(data, "sha");
+ if(!json_is_string(sha))
+ {
+ fprintf(stderr, "error: commit %d: sha is not a string\n", i + 1);
+ json_decref(root);
+ return 1;
+ }
+
+ commit = json_object_get(data, "commit");
+ if(!json_is_object(commit))
+ {
+ fprintf(stderr, "error: commit %d: commit is not an object\n", i + 1);
+ json_decref(root);
+ return 1;
+ }
+
+ message = json_object_get(commit, "message");
+ if(!json_is_string(message))
+ {
+ fprintf(stderr, "error: commit %d: message is not a string\n", i + 1);
+ json_decref(root);
+ return 1;
+ }
+ ...
+
+And finally, we'll print the first 8 characters of the commit ID and
+the first line of the commit message. A C-style string is extracted
+from a JSON string using :func:`json_string_value()`::
+
+ message_text = json_string_value(message);
+ printf("%.8s %.*s\n",
+ json_string_value(id),
+ newline_offset(message_text),
+ message_text);
+ }
+
+After sending the HTTP request, we decoded the JSON text using
+:func:`json_loads()`, remember? It returns a *new reference* to the
+JSON value it decodes. When we're finished with the value, we'll need
+to decrease the reference count using :func:`json_decref()`. This way
+Jansson can release the resources::
+
+ json_decref(root);
+ return 0;
+
+For a detailed explanation of reference counting in Jansson, see
+:ref:`apiref-reference-count` in :ref:`apiref`.
+
+The program's ready, let's test it and view the latest commits in
+Jansson's repository::
+
+ $ ./github_commits akheron jansson
+ 1581f26a Merge branch '2.3'
+ aabfd493 load: Change buffer_pos to be a size_t
+ bd72efbd load: Avoid unexpected behaviour in macro expansion
+ e8fd3e30 Document and tweak json_load_callback()
+ 873eddaf Merge pull request #60 from rogerz/contrib
+ bd2c0c73 Ignore the binary test_load_callback
+ 17a51a4b Merge branch '2.3'
+ 09c39adc Add json_load_callback to the list of exported symbols
+ cbb80baf Merge pull request #57 from rogerz/contrib
+ 040bd7b0 Add json_load_callback()
+ 2637faa4 Make test stripping locale independent
+ <...>
+
+
+Conclusion
+==========
+
+In this tutorial, we implemented a program that fetches the latest
+commits of a GitHub repository using the GitHub Repo Commits API.
+Jansson was used to decode the JSON response and to extract the commit
+data.
+
+This tutorial only covered a small part of Jansson. For example, we
+did not create or manipulate JSON values at all. Proceed to
+:ref:`apiref` to explore all features of Jansson.
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_sources/upgrading.txt Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,76 @@
+.. highlight:: c
+
+******************
+Upgrading from 1.x
+******************
+
+This chapter lists the backwards incompatible changes introduced in
+Jansson 2.0, and the steps that are needed for upgrading your code.
+
+**The incompatibilities are not dramatic.** The biggest change is that
+all decoding functions now require and extra parameter. Most programs
+can be modified to work with 2.0 by adding a ``0`` as the second
+parameter to all calls of :func:`json_loads()`, :func:`json_loadf()`
+and :func:`json_load_file()`.
+
+
+Compatibility
+=============
+
+Jansson 2.0 is backwards incompatible with the Jansson 1.x releases.
+It is ABI incompatible, i.e. all programs dynamically linking to the
+Jansson library need to be recompiled. It's also API incompatible,
+i.e. the source code of programs using Jansson 1.x may need
+modifications to make them compile against Jansson 2.0.
+
+All the 2.x releases are guaranteed to be backwards compatible for
+both ABI and API, so no recompilation or source changes are needed
+when upgrading from 2.x to 2.y.
+
+
+List of Incompatible Changes
+============================
+
+**Decoding flags**
+ For future needs, a ``flags`` parameter was added as the second
+ parameter to all decoding functions, i.e. :func:`json_loads()`,
+ :func:`json_loadf()` and :func:`json_load_file()`. All calls to
+ these functions need to be changed by adding a ``0`` as the second
+ argument. For example::
+
+ /* old code */
+ json_loads(input, &error);
+
+ /* new code */
+ json_loads(input, 0, &error);
+
+
+**Underlying type of JSON integers**
+ The underlying C type of JSON integers has been changed from
+ :type:`int` to the widest available signed integer type, i.e.
+ :type:`long long` or :type:`long`, depending on whether
+ :type:`long long` is supported on your system or not. This makes
+ the whole 64-bit integer range available on most modern systems.
+
+ ``jansson.h`` has a typedef :type:`json_int_t` to the underlying
+ integer type. :type:`int` should still be used in most cases when
+ dealing with smallish JSON integers, as the compiler handles
+ implicit type coercion. Only when the full 64-bit range is needed,
+ :type:`json_int_t` should be explicitly used.
+
+
+**Maximum encoder indentation depth**
+ The maximum argument of the ``JSON_INDENT()`` macro has been
+ changed from 255 to 31, to free up bits from the ``flags``
+ parameter of :func:`json_dumps()`, :func:`json_dumpf()` and
+ :func:`json_dump_file()`. If your code uses a bigger indentation
+ than 31, it needs to be changed.
+
+
+**Unsigned integers in API functions**
+ Version 2.0 unifies unsigned integer usage in the API. All uses of
+ :type:`unsigned int` and :type:`unsigned long` have been replaced
+ with :type:`size_t`. This includes flags, container sizes, etc.
+ This should not require source code changes, as both
+ :type:`unsigned int` and :type:`unsigned long` are usually
+ compatible with :type:`size_t`.
Binary file components/jansson/doc/html/_static/ajax-loader.gif has changed
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/basic.css Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,537 @@
+/*
+ * basic.css
+ * ~~~~~~~~~
+ *
+ * Sphinx stylesheet -- basic theme.
+ *
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+/* -- main layout ----------------------------------------------------------- */
+
+div.clearer {
+ clear: both;
+}
+
+/* -- relbar ---------------------------------------------------------------- */
+
+div.related {
+ width: 100%;
+ font-size: 90%;
+}
+
+div.related h3 {
+ display: none;
+}
+
+div.related ul {
+ margin: 0;
+ padding: 0 0 0 10px;
+ list-style: none;
+}
+
+div.related li {
+ display: inline;
+}
+
+div.related li.right {
+ float: right;
+ margin-right: 5px;
+}
+
+/* -- sidebar --------------------------------------------------------------- */
+
+div.sphinxsidebarwrapper {
+ padding: 10px 5px 0 10px;
+}
+
+div.sphinxsidebar {
+ float: left;
+ width: 230px;
+ margin-left: -100%;
+ font-size: 90%;
+}
+
+div.sphinxsidebar ul {
+ list-style: none;
+}
+
+div.sphinxsidebar ul ul,
+div.sphinxsidebar ul.want-points {
+ margin-left: 20px;
+ list-style: square;
+}
+
+div.sphinxsidebar ul ul {
+ margin-top: 0;
+ margin-bottom: 0;
+}
+
+div.sphinxsidebar form {
+ margin-top: 10px;
+}
+
+div.sphinxsidebar input {
+ border: 1px solid #98dbcc;
+ font-family: sans-serif;
+ font-size: 1em;
+}
+
+div.sphinxsidebar #searchbox input[type="text"] {
+ width: 170px;
+}
+
+div.sphinxsidebar #searchbox input[type="submit"] {
+ width: 30px;
+}
+
+img {
+ border: 0;
+ max-width: 100%;
+}
+
+/* -- search page ----------------------------------------------------------- */
+
+ul.search {
+ margin: 10px 0 0 20px;
+ padding: 0;
+}
+
+ul.search li {
+ padding: 5px 0 5px 20px;
+ background-image: url(file.png);
+ background-repeat: no-repeat;
+ background-position: 0 7px;
+}
+
+ul.search li a {
+ font-weight: bold;
+}
+
+ul.search li div.context {
+ color: #888;
+ margin: 2px 0 0 30px;
+ text-align: left;
+}
+
+ul.keywordmatches li.goodmatch a {
+ font-weight: bold;
+}
+
+/* -- index page ------------------------------------------------------------ */
+
+table.contentstable {
+ width: 90%;
+}
+
+table.contentstable p.biglink {
+ line-height: 150%;
+}
+
+a.biglink {
+ font-size: 1.3em;
+}
+
+span.linkdescr {
+ font-style: italic;
+ padding-top: 5px;
+ font-size: 90%;
+}
+
+/* -- general index --------------------------------------------------------- */
+
+table.indextable {
+ width: 100%;
+}
+
+table.indextable td {
+ text-align: left;
+ vertical-align: top;
+}
+
+table.indextable dl, table.indextable dd {
+ margin-top: 0;
+ margin-bottom: 0;
+}
+
+table.indextable tr.pcap {
+ height: 10px;
+}
+
+table.indextable tr.cap {
+ margin-top: 10px;
+ background-color: #f2f2f2;
+}
+
+img.toggler {
+ margin-right: 3px;
+ margin-top: 3px;
+ cursor: pointer;
+}
+
+div.modindex-jumpbox {
+ border-top: 1px solid #ddd;
+ border-bottom: 1px solid #ddd;
+ margin: 1em 0 1em 0;
+ padding: 0.4em;
+}
+
+div.genindex-jumpbox {
+ border-top: 1px solid #ddd;
+ border-bottom: 1px solid #ddd;
+ margin: 1em 0 1em 0;
+ padding: 0.4em;
+}
+
+/* -- general body styles --------------------------------------------------- */
+
+a.headerlink {
+ visibility: hidden;
+}
+
+h1:hover > a.headerlink,
+h2:hover > a.headerlink,
+h3:hover > a.headerlink,
+h4:hover > a.headerlink,
+h5:hover > a.headerlink,
+h6:hover > a.headerlink,
+dt:hover > a.headerlink {
+ visibility: visible;
+}
+
+div.body p.caption {
+ text-align: inherit;
+}
+
+div.body td {
+ text-align: left;
+}
+
+.field-list ul {
+ padding-left: 1em;
+}
+
+.first {
+ margin-top: 0 !important;
+}
+
+p.rubric {
+ margin-top: 30px;
+ font-weight: bold;
+}
+
+img.align-left, .figure.align-left, object.align-left {
+ clear: left;
+ float: left;
+ margin-right: 1em;
+}
+
+img.align-right, .figure.align-right, object.align-right {
+ clear: right;
+ float: right;
+ margin-left: 1em;
+}
+
+img.align-center, .figure.align-center, object.align-center {
+ display: block;
+ margin-left: auto;
+ margin-right: auto;
+}
+
+.align-left {
+ text-align: left;
+}
+
+.align-center {
+ text-align: center;
+}
+
+.align-right {
+ text-align: right;
+}
+
+/* -- sidebars -------------------------------------------------------------- */
+
+div.sidebar {
+ margin: 0 0 0.5em 1em;
+ border: 1px solid #ddb;
+ padding: 7px 7px 0 7px;
+ background-color: #ffe;
+ width: 40%;
+ float: right;
+}
+
+p.sidebar-title {
+ font-weight: bold;
+}
+
+/* -- topics ---------------------------------------------------------------- */
+
+div.topic {
+ border: 1px solid #ccc;
+ padding: 7px 7px 0 7px;
+ margin: 10px 0 10px 0;
+}
+
+p.topic-title {
+ font-size: 1.1em;
+ font-weight: bold;
+ margin-top: 10px;
+}
+
+/* -- admonitions ----------------------------------------------------------- */
+
+div.admonition {
+ margin-top: 10px;
+ margin-bottom: 10px;
+ padding: 7px;
+}
+
+div.admonition dt {
+ font-weight: bold;
+}
+
+div.admonition dl {
+ margin-bottom: 0;
+}
+
+p.admonition-title {
+ margin: 0px 10px 5px 0px;
+ font-weight: bold;
+}
+
+div.body p.centered {
+ text-align: center;
+ margin-top: 25px;
+}
+
+/* -- tables ---------------------------------------------------------------- */
+
+table.docutils {
+ border: 0;
+ border-collapse: collapse;
+}
+
+table.docutils td, table.docutils th {
+ padding: 1px 8px 1px 5px;
+ border-top: 0;
+ border-left: 0;
+ border-right: 0;
+ border-bottom: 1px solid #aaa;
+}
+
+table.field-list td, table.field-list th {
+ border: 0 !important;
+}
+
+table.footnote td, table.footnote th {
+ border: 0 !important;
+}
+
+th {
+ text-align: left;
+ padding-right: 5px;
+}
+
+table.citation {
+ border-left: solid 1px gray;
+ margin-left: 1px;
+}
+
+table.citation td {
+ border-bottom: none;
+}
+
+/* -- other body styles ----------------------------------------------------- */
+
+ol.arabic {
+ list-style: decimal;
+}
+
+ol.loweralpha {
+ list-style: lower-alpha;
+}
+
+ol.upperalpha {
+ list-style: upper-alpha;
+}
+
+ol.lowerroman {
+ list-style: lower-roman;
+}
+
+ol.upperroman {
+ list-style: upper-roman;
+}
+
+dl {
+ margin-bottom: 15px;
+}
+
+dd p {
+ margin-top: 0px;
+}
+
+dd ul, dd table {
+ margin-bottom: 10px;
+}
+
+dd {
+ margin-top: 3px;
+ margin-bottom: 10px;
+ margin-left: 30px;
+}
+
+dt:target, .highlighted {
+ background-color: #fbe54e;
+}
+
+dl.glossary dt {
+ font-weight: bold;
+ font-size: 1.1em;
+}
+
+.field-list ul {
+ margin: 0;
+ padding-left: 1em;
+}
+
+.field-list p {
+ margin: 0;
+}
+
+.optional {
+ font-size: 1.3em;
+}
+
+.versionmodified {
+ font-style: italic;
+}
+
+.system-message {
+ background-color: #fda;
+ padding: 5px;
+ border: 3px solid red;
+}
+
+.footnote:target {
+ background-color: #ffa;
+}
+
+.line-block {
+ display: block;
+ margin-top: 1em;
+ margin-bottom: 1em;
+}
+
+.line-block .line-block {
+ margin-top: 0;
+ margin-bottom: 0;
+ margin-left: 1.5em;
+}
+
+.guilabel, .menuselection {
+ font-family: sans-serif;
+}
+
+.accelerator {
+ text-decoration: underline;
+}
+
+.classifier {
+ font-style: oblique;
+}
+
+abbr, acronym {
+ border-bottom: dotted 1px;
+ cursor: help;
+}
+
+/* -- code displays --------------------------------------------------------- */
+
+pre {
+ overflow: auto;
+ overflow-y: hidden; /* fixes display issues on Chrome browsers */
+}
+
+td.linenos pre {
+ padding: 5px 0px;
+ border: 0;
+ background-color: transparent;
+ color: #aaa;
+}
+
+table.highlighttable {
+ margin-left: 0.5em;
+}
+
+table.highlighttable td {
+ padding: 0 0.5em 0 0.5em;
+}
+
+tt.descname {
+ background-color: transparent;
+ font-weight: bold;
+ font-size: 1.2em;
+}
+
+tt.descclassname {
+ background-color: transparent;
+}
+
+tt.xref, a tt {
+ background-color: transparent;
+ font-weight: bold;
+}
+
+h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
+ background-color: transparent;
+}
+
+.viewcode-link {
+ float: right;
+}
+
+.viewcode-back {
+ float: right;
+ font-family: sans-serif;
+}
+
+div.viewcode-block:target {
+ margin: -1px -10px;
+ padding: 0 10px;
+}
+
+/* -- math display ---------------------------------------------------------- */
+
+img.math {
+ vertical-align: middle;
+}
+
+div.body div.math p {
+ text-align: center;
+}
+
+span.eqno {
+ float: right;
+}
+
+/* -- printout stylesheet --------------------------------------------------- */
+
+@media print {
+ div.document,
+ div.documentwrapper,
+ div.bodywrapper {
+ margin: 0 !important;
+ width: 100%;
+ }
+
+ div.sphinxsidebar,
+ div.related,
+ div.footer,
+ #top-link {
+ display: none;
+ }
+}
\ No newline at end of file
Binary file components/jansson/doc/html/_static/comment-bright.png has changed
Binary file components/jansson/doc/html/_static/comment-close.png has changed
Binary file components/jansson/doc/html/_static/comment.png has changed
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/default.css Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,256 @@
+/*
+ * default.css_t
+ * ~~~~~~~~~~~~~
+ *
+ * Sphinx stylesheet -- default theme.
+ *
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+@import url("basic.css");
+
+/* -- page layout ----------------------------------------------------------- */
+
+body {
+ font-family: sans-serif;
+ font-size: 100%;
+ background-color: #11303d;
+ color: #000;
+ margin: 0;
+ padding: 0;
+}
+
+div.document {
+ background-color: #1c4e63;
+}
+
+div.documentwrapper {
+ float: left;
+ width: 100%;
+}
+
+div.bodywrapper {
+ margin: 0 0 0 230px;
+}
+
+div.body {
+ background-color: #ffffff;
+ color: #000000;
+ padding: 0 20px 30px 20px;
+}
+
+div.footer {
+ color: #ffffff;
+ width: 100%;
+ padding: 9px 0 9px 0;
+ text-align: center;
+ font-size: 75%;
+}
+
+div.footer a {
+ color: #ffffff;
+ text-decoration: underline;
+}
+
+div.related {
+ background-color: #133f52;
+ line-height: 30px;
+ color: #ffffff;
+}
+
+div.related a {
+ color: #ffffff;
+}
+
+div.sphinxsidebar {
+}
+
+div.sphinxsidebar h3 {
+ font-family: 'Trebuchet MS', sans-serif;
+ color: #ffffff;
+ font-size: 1.4em;
+ font-weight: normal;
+ margin: 0;
+ padding: 0;
+}
+
+div.sphinxsidebar h3 a {
+ color: #ffffff;
+}
+
+div.sphinxsidebar h4 {
+ font-family: 'Trebuchet MS', sans-serif;
+ color: #ffffff;
+ font-size: 1.3em;
+ font-weight: normal;
+ margin: 5px 0 0 0;
+ padding: 0;
+}
+
+div.sphinxsidebar p {
+ color: #ffffff;
+}
+
+div.sphinxsidebar p.topless {
+ margin: 5px 10px 10px 10px;
+}
+
+div.sphinxsidebar ul {
+ margin: 10px;
+ padding: 0;
+ color: #ffffff;
+}
+
+div.sphinxsidebar a {
+ color: #98dbcc;
+}
+
+div.sphinxsidebar input {
+ border: 1px solid #98dbcc;
+ font-family: sans-serif;
+ font-size: 1em;
+}
+
+
+
+/* -- hyperlink styles ------------------------------------------------------ */
+
+a {
+ color: #355f7c;
+ text-decoration: none;
+}
+
+a:visited {
+ color: #355f7c;
+ text-decoration: none;
+}
+
+a:hover {
+ text-decoration: underline;
+}
+
+
+
+/* -- body styles ----------------------------------------------------------- */
+
+div.body h1,
+div.body h2,
+div.body h3,
+div.body h4,
+div.body h5,
+div.body h6 {
+ font-family: 'Trebuchet MS', sans-serif;
+ background-color: #f2f2f2;
+ font-weight: normal;
+ color: #20435c;
+ border-bottom: 1px solid #ccc;
+ margin: 20px -20px 10px -20px;
+ padding: 3px 0 3px 10px;
+}
+
+div.body h1 { margin-top: 0; font-size: 200%; }
+div.body h2 { font-size: 160%; }
+div.body h3 { font-size: 140%; }
+div.body h4 { font-size: 120%; }
+div.body h5 { font-size: 110%; }
+div.body h6 { font-size: 100%; }
+
+a.headerlink {
+ color: #c60f0f;
+ font-size: 0.8em;
+ padding: 0 4px 0 4px;
+ text-decoration: none;
+}
+
+a.headerlink:hover {
+ background-color: #c60f0f;
+ color: white;
+}
+
+div.body p, div.body dd, div.body li {
+ text-align: justify;
+ line-height: 130%;
+}
+
+div.admonition p.admonition-title + p {
+ display: inline;
+}
+
+div.admonition p {
+ margin-bottom: 5px;
+}
+
+div.admonition pre {
+ margin-bottom: 5px;
+}
+
+div.admonition ul, div.admonition ol {
+ margin-bottom: 5px;
+}
+
+div.note {
+ background-color: #eee;
+ border: 1px solid #ccc;
+}
+
+div.seealso {
+ background-color: #ffc;
+ border: 1px solid #ff6;
+}
+
+div.topic {
+ background-color: #eee;
+}
+
+div.warning {
+ background-color: #ffe4e4;
+ border: 1px solid #f66;
+}
+
+p.admonition-title {
+ display: inline;
+}
+
+p.admonition-title:after {
+ content: ":";
+}
+
+pre {
+ padding: 5px;
+ background-color: #eeffcc;
+ color: #333333;
+ line-height: 120%;
+ border: 1px solid #ac9;
+ border-left: none;
+ border-right: none;
+}
+
+tt {
+ background-color: #ecf0f3;
+ padding: 0 1px 0 1px;
+ font-size: 0.95em;
+}
+
+th {
+ background-color: #ede;
+}
+
+.warning tt {
+ background: #efc2c2;
+}
+
+.note tt {
+ background: #d6d6d6;
+}
+
+.viewcode-back {
+ font-family: sans-serif;
+}
+
+div.viewcode-block:target {
+ background-color: #f4debf;
+ border-top: 1px solid #ac9;
+ border-bottom: 1px solid #ac9;
+}
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/doctools.js Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,238 @@
+/*
+ * doctools.js
+ * ~~~~~~~~~~~
+ *
+ * Sphinx JavaScript utilities for all documentation.
+ *
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+/**
+ * select a different prefix for underscore
+ */
+$u = _.noConflict();
+
+/**
+ * make the code below compatible with browsers without
+ * an installed firebug like debugger
+if (!window.console || !console.firebug) {
+ var names = ["log", "debug", "info", "warn", "error", "assert", "dir",
+ "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace",
+ "profile", "profileEnd"];
+ window.console = {};
+ for (var i = 0; i < names.length; ++i)
+ window.console[names[i]] = function() {};
+}
+ */
+
+/**
+ * small helper function to urldecode strings
+ */
+jQuery.urldecode = function(x) {
+ return decodeURIComponent(x).replace(/\+/g, ' ');
+};
+
+/**
+ * small helper function to urlencode strings
+ */
+jQuery.urlencode = encodeURIComponent;
+
+/**
+ * This function returns the parsed url parameters of the
+ * current request. Multiple values per key are supported,
+ * it will always return arrays of strings for the value parts.
+ */
+jQuery.getQueryParameters = function(s) {
+ if (typeof s == 'undefined')
+ s = document.location.search;
+ var parts = s.substr(s.indexOf('?') + 1).split('&');
+ var result = {};
+ for (var i = 0; i < parts.length; i++) {
+ var tmp = parts[i].split('=', 2);
+ var key = jQuery.urldecode(tmp[0]);
+ var value = jQuery.urldecode(tmp[1]);
+ if (key in result)
+ result[key].push(value);
+ else
+ result[key] = [value];
+ }
+ return result;
+};
+
+/**
+ * highlight a given string on a jquery object by wrapping it in
+ * span elements with the given class name.
+ */
+jQuery.fn.highlightText = function(text, className) {
+ function highlight(node) {
+ if (node.nodeType == 3) {
+ var val = node.nodeValue;
+ var pos = val.toLowerCase().indexOf(text);
+ if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) {
+ var span = document.createElement("span");
+ span.className = className;
+ span.appendChild(document.createTextNode(val.substr(pos, text.length)));
+ node.parentNode.insertBefore(span, node.parentNode.insertBefore(
+ document.createTextNode(val.substr(pos + text.length)),
+ node.nextSibling));
+ node.nodeValue = val.substr(0, pos);
+ }
+ }
+ else if (!jQuery(node).is("button, select, textarea")) {
+ jQuery.each(node.childNodes, function() {
+ highlight(this);
+ });
+ }
+ }
+ return this.each(function() {
+ highlight(this);
+ });
+};
+
+/**
+ * Small JavaScript module for the documentation.
+ */
+var Documentation = {
+
+ init : function() {
+ this.fixFirefoxAnchorBug();
+ this.highlightSearchWords();
+ this.initIndexTable();
+ },
+
+ /**
+ * i18n support
+ */
+ TRANSLATIONS : {},
+ PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; },
+ LOCALE : 'unknown',
+
+ // gettext and ngettext don't access this so that the functions
+ // can safely bound to a different name (_ = Documentation.gettext)
+ gettext : function(string) {
+ var translated = Documentation.TRANSLATIONS[string];
+ if (typeof translated == 'undefined')
+ return string;
+ return (typeof translated == 'string') ? translated : translated[0];
+ },
+
+ ngettext : function(singular, plural, n) {
+ var translated = Documentation.TRANSLATIONS[singular];
+ if (typeof translated == 'undefined')
+ return (n == 1) ? singular : plural;
+ return translated[Documentation.PLURALEXPR(n)];
+ },
+
+ addTranslations : function(catalog) {
+ for (var key in catalog.messages)
+ this.TRANSLATIONS[key] = catalog.messages[key];
+ this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')');
+ this.LOCALE = catalog.locale;
+ },
+
+ /**
+ * add context elements like header anchor links
+ */
+ addContextElements : function() {
+ $('div[id] > :header:first').each(function() {
+ $('<a class="headerlink">\u00B6</a>').
+ attr('href', '#' + this.id).
+ attr('title', _('Permalink to this headline')).
+ appendTo(this);
+ });
+ $('dt[id]').each(function() {
+ $('<a class="headerlink">\u00B6</a>').
+ attr('href', '#' + this.id).
+ attr('title', _('Permalink to this definition')).
+ appendTo(this);
+ });
+ },
+
+ /**
+ * workaround a firefox stupidity
+ */
+ fixFirefoxAnchorBug : function() {
+ if (document.location.hash && $.browser.mozilla)
+ window.setTimeout(function() {
+ document.location.href += '';
+ }, 10);
+ },
+
+ /**
+ * highlight the search words provided in the url in the text
+ */
+ highlightSearchWords : function() {
+ var params = $.getQueryParameters();
+ var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : [];
+ if (terms.length) {
+ var body = $('div.body');
+ if (!body.length) {
+ body = $('body');
+ }
+ window.setTimeout(function() {
+ $.each(terms, function() {
+ body.highlightText(this.toLowerCase(), 'highlighted');
+ });
+ }, 10);
+ $('<p class="highlight-link"><a href="javascript:Documentation.' +
+ 'hideSearchWords()">' + _('Hide Search Matches') + '</a></p>')
+ .appendTo($('#searchbox'));
+ }
+ },
+
+ /**
+ * init the domain index toggle buttons
+ */
+ initIndexTable : function() {
+ var togglers = $('img.toggler').click(function() {
+ var src = $(this).attr('src');
+ var idnum = $(this).attr('id').substr(7);
+ $('tr.cg-' + idnum).toggle();
+ if (src.substr(-9) == 'minus.png')
+ $(this).attr('src', src.substr(0, src.length-9) + 'plus.png');
+ else
+ $(this).attr('src', src.substr(0, src.length-8) + 'minus.png');
+ }).css('display', '');
+ if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) {
+ togglers.click();
+ }
+ },
+
+ /**
+ * helper function to hide the search marks again
+ */
+ hideSearchWords : function() {
+ $('#searchbox .highlight-link').fadeOut(300);
+ $('span.highlighted').removeClass('highlighted');
+ },
+
+ /**
+ * make the url absolute
+ */
+ makeURL : function(relativeURL) {
+ return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL;
+ },
+
+ /**
+ * get the current relative url
+ */
+ getCurrentURL : function() {
+ var path = document.location.pathname;
+ var parts = path.split(/\//);
+ $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() {
+ if (this == '..')
+ parts.pop();
+ });
+ var url = parts.join('/');
+ return path.substring(url.lastIndexOf('/') + 1, path.length - 1);
+ }
+};
+
+// quick alias for translations
+_ = Documentation.gettext;
+
+$(document).ready(function() {
+ Documentation.init();
+});
Binary file components/jansson/doc/html/_static/down-pressed.png has changed
Binary file components/jansson/doc/html/_static/down.png has changed
Binary file components/jansson/doc/html/_static/file.png has changed
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/jquery.js Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,2 @@
+/*! jQuery v1.8.3 jquery.com | jquery.org/license */
+(function(e,t){function _(e){var t=M[e]={};return v.each(e.split(y),function(e,n){t[n]=!0}),t}function H(e,n,r){if(r===t&&e.nodeType===1){var i="data-"+n.replace(P,"-$1").toLowerCase();r=e.getAttribute(i);if(typeof r=="string"){try{r=r==="true"?!0:r==="false"?!1:r==="null"?null:+r+""===r?+r:D.test(r)?v.parseJSON(r):r}catch(s){}v.data(e,n,r)}else r=t}return r}function B(e){var t;for(t in e){if(t==="data"&&v.isEmptyObject(e[t]))continue;if(t!=="toJSON")return!1}return!0}function et(){return!1}function tt(){return!0}function ut(e){return!e||!e.parentNode||e.parentNode.nodeType===11}function at(e,t){do e=e[t];while(e&&e.nodeType!==1);return e}function ft(e,t,n){t=t||0;if(v.isFunction(t))return v.grep(e,function(e,r){var i=!!t.call(e,r,e);return i===n});if(t.nodeType)return v.grep(e,function(e,r){return e===t===n});if(typeof t=="string"){var r=v.grep(e,function(e){return e.nodeType===1});if(it.test(t))return v.filter(t,r,!n);t=v.filter(t,r)}return v.grep(e,function(e,r){return v.inArray(e,t)>=0===n})}function lt(e){var t=ct.split("|"),n=e.createDocumentFragment();if(n.createElement)while(t.length)n.createElement(t.pop());return n}function Lt(e,t){return e.getElementsByTagName(t)[0]||e.appendChild(e.ownerDocument.createElement(t))}function At(e,t){if(t.nodeType!==1||!v.hasData(e))return;var n,r,i,s=v._data(e),o=v._data(t,s),u=s.events;if(u){delete o.handle,o.events={};for(n in u)for(r=0,i=u[n].length;r<i;r++)v.event.add(t,n,u[n][r])}o.data&&(o.data=v.extend({},o.data))}function Ot(e,t){var n;if(t.nodeType!==1)return;t.clearAttributes&&t.clearAttributes(),t.mergeAttributes&&t.mergeAttributes(e),n=t.nodeName.toLowerCase(),n==="object"?(t.parentNode&&(t.outerHTML=e.outerHTML),v.support.html5Clone&&e.innerHTML&&!v.trim(t.innerHTML)&&(t.innerHTML=e.innerHTML)):n==="input"&&Et.test(e.type)?(t.defaultChecked=t.checked=e.checked,t.value!==e.value&&(t.value=e.value)):n==="option"?t.selected=e.defaultSelected:n==="input"||n==="textarea"?t.defaultValue=e.defaultValue:n==="script"&&t.text!==e.text&&(t.text=e.text),t.removeAttribute(v.expando)}function Mt(e){return typeof e.getElementsByTagName!="undefined"?e.getElementsByTagName("*"):typeof e.querySelectorAll!="undefined"?e.querySelectorAll("*"):[]}function _t(e){Et.test(e.type)&&(e.defaultChecked=e.checked)}function Qt(e,t){if(t in e)return t;var n=t.charAt(0).toUpperCase()+t.slice(1),r=t,i=Jt.length;while(i--){t=Jt[i]+n;if(t in e)return t}return r}function Gt(e,t){return e=t||e,v.css(e,"display")==="none"||!v.contains(e.ownerDocument,e)}function Yt(e,t){var n,r,i=[],s=0,o=e.length;for(;s<o;s++){n=e[s];if(!n.style)continue;i[s]=v._data(n,"olddisplay"),t?(!i[s]&&n.style.display==="none"&&(n.style.display=""),n.style.display===""&&Gt(n)&&(i[s]=v._data(n,"olddisplay",nn(n.nodeName)))):(r=Dt(n,"display"),!i[s]&&r!=="none"&&v._data(n,"olddisplay",r))}for(s=0;s<o;s++){n=e[s];if(!n.style)continue;if(!t||n.style.display==="none"||n.style.display==="")n.style.display=t?i[s]||"":"none"}return e}function Zt(e,t,n){var r=Rt.exec(t);return r?Math.max(0,r[1]-(n||0))+(r[2]||"px"):t}function en(e,t,n,r){var i=n===(r?"border":"content")?4:t==="width"?1:0,s=0;for(;i<4;i+=2)n==="margin"&&(s+=v.css(e,n+$t[i],!0)),r?(n==="content"&&(s-=parseFloat(Dt(e,"padding"+$t[i]))||0),n!=="margin"&&(s-=parseFloat(Dt(e,"border"+$t[i]+"Width"))||0)):(s+=parseFloat(Dt(e,"padding"+$t[i]))||0,n!=="padding"&&(s+=parseFloat(Dt(e,"border"+$t[i]+"Width"))||0));return s}function tn(e,t,n){var r=t==="width"?e.offsetWidth:e.offsetHeight,i=!0,s=v.support.boxSizing&&v.css(e,"boxSizing")==="border-box";if(r<=0||r==null){r=Dt(e,t);if(r<0||r==null)r=e.style[t];if(Ut.test(r))return r;i=s&&(v.support.boxSizingReliable||r===e.style[t]),r=parseFloat(r)||0}return r+en(e,t,n||(s?"border":"content"),i)+"px"}function nn(e){if(Wt[e])return Wt[e];var t=v("<"+e+">").appendTo(i.body),n=t.css("display");t.remove();if(n==="none"||n===""){Pt=i.body.appendChild(Pt||v.extend(i.createElement("iframe"),{frameBorder:0,width:0,height:0}));if(!Ht||!Pt.createElement)Ht=(Pt.contentWindow||Pt.contentDocument).document,Ht.write("<!doctype html><html><body>"),Ht.close();t=Ht.body.appendChild(Ht.createElement(e)),n=Dt(t,"display"),i.body.removeChild(Pt)}return Wt[e]=n,n}function fn(e,t,n,r){var i;if(v.isArray(t))v.each(t,function(t,i){n||sn.test(e)?r(e,i):fn(e+"["+(typeof i=="object"?t:"")+"]",i,n,r)});else if(!n&&v.type(t)==="object")for(i in t)fn(e+"["+i+"]",t[i],n,r);else r(e,t)}function Cn(e){return function(t,n){typeof t!="string"&&(n=t,t="*");var r,i,s,o=t.toLowerCase().split(y),u=0,a=o.length;if(v.isFunction(n))for(;u<a;u++)r=o[u],s=/^\+/.test(r),s&&(r=r.substr(1)||"*"),i=e[r]=e[r]||[],i[s?"unshift":"push"](n)}}function kn(e,n,r,i,s,o){s=s||n.dataTypes[0],o=o||{},o[s]=!0;var u,a=e[s],f=0,l=a?a.length:0,c=e===Sn;for(;f<l&&(c||!u);f++)u=a[f](n,r,i),typeof u=="string"&&(!c||o[u]?u=t:(n.dataTypes.unshift(u),u=kn(e,n,r,i,u,o)));return(c||!u)&&!o["*"]&&(u=kn(e,n,r,i,"*",o)),u}function Ln(e,n){var r,i,s=v.ajaxSettings.flatOptions||{};for(r in n)n[r]!==t&&((s[r]?e:i||(i={}))[r]=n[r]);i&&v.extend(!0,e,i)}function An(e,n,r){var i,s,o,u,a=e.contents,f=e.dataTypes,l=e.responseFields;for(s in l)s in r&&(n[l[s]]=r[s]);while(f[0]==="*")f.shift(),i===t&&(i=e.mimeType||n.getResponseHeader("content-type"));if(i)for(s in a)if(a[s]&&a[s].test(i)){f.unshift(s);break}if(f[0]in r)o=f[0];else{for(s in r){if(!f[0]||e.converters[s+" "+f[0]]){o=s;break}u||(u=s)}o=o||u}if(o)return o!==f[0]&&f.unshift(o),r[o]}function On(e,t){var n,r,i,s,o=e.dataTypes.slice(),u=o[0],a={},f=0;e.dataFilter&&(t=e.dataFilter(t,e.dataType));if(o[1])for(n in e.converters)a[n.toLowerCase()]=e.converters[n];for(;i=o[++f];)if(i!=="*"){if(u!=="*"&&u!==i){n=a[u+" "+i]||a["* "+i];if(!n)for(r in a){s=r.split(" ");if(s[1]===i){n=a[u+" "+s[0]]||a["* "+s[0]];if(n){n===!0?n=a[r]:a[r]!==!0&&(i=s[0],o.splice(f--,0,i));break}}}if(n!==!0)if(n&&e["throws"])t=n(t);else try{t=n(t)}catch(l){return{state:"parsererror",error:n?l:"No conversion from "+u+" to "+i}}}u=i}return{state:"success",data:t}}function Fn(){try{return new e.XMLHttpRequest}catch(t){}}function In(){try{return new e.ActiveXObject("Microsoft.XMLHTTP")}catch(t){}}function $n(){return setTimeout(function(){qn=t},0),qn=v.now()}function Jn(e,t){v.each(t,function(t,n){var r=(Vn[t]||[]).concat(Vn["*"]),i=0,s=r.length;for(;i<s;i++)if(r[i].call(e,t,n))return})}function Kn(e,t,n){var r,i=0,s=0,o=Xn.length,u=v.Deferred().always(function(){delete a.elem}),a=function(){var t=qn||$n(),n=Math.max(0,f.startTime+f.duration-t),r=n/f.duration||0,i=1-r,s=0,o=f.tweens.length;for(;s<o;s++)f.tweens[s].run(i);return u.notifyWith(e,[f,i,n]),i<1&&o?n:(u.resolveWith(e,[f]),!1)},f=u.promise({elem:e,props:v.extend({},t),opts:v.extend(!0,{specialEasing:{}},n),originalProperties:t,originalOptions:n,startTime:qn||$n(),duration:n.duration,tweens:[],createTween:function(t,n,r){var i=v.Tween(e,f.opts,t,n,f.opts.specialEasing[t]||f.opts.easing);return f.tweens.push(i),i},stop:function(t){var n=0,r=t?f.tweens.length:0;for(;n<r;n++)f.tweens[n].run(1);return t?u.resolveWith(e,[f,t]):u.rejectWith(e,[f,t]),this}}),l=f.props;Qn(l,f.opts.specialEasing);for(;i<o;i++){r=Xn[i].call(f,e,l,f.opts);if(r)return r}return Jn(f,l),v.isFunction(f.opts.start)&&f.opts.start.call(e,f),v.fx.timer(v.extend(a,{anim:f,queue:f.opts.queue,elem:e})),f.progress(f.opts.progress).done(f.opts.done,f.opts.complete).fail(f.opts.fail).always(f.opts.always)}function Qn(e,t){var n,r,i,s,o;for(n in e){r=v.camelCase(n),i=t[r],s=e[n],v.isArray(s)&&(i=s[1],s=e[n]=s[0]),n!==r&&(e[r]=s,delete e[n]),o=v.cssHooks[r];if(o&&"expand"in o){s=o.expand(s),delete e[r];for(n in s)n in e||(e[n]=s[n],t[n]=i)}else t[r]=i}}function Gn(e,t,n){var r,i,s,o,u,a,f,l,c,h=this,p=e.style,d={},m=[],g=e.nodeType&&Gt(e);n.queue||(l=v._queueHooks(e,"fx"),l.unqueued==null&&(l.unqueued=0,c=l.empty.fire,l.empty.fire=function(){l.unqueued||c()}),l.unqueued++,h.always(function(){h.always(function(){l.unqueued--,v.queue(e,"fx").length||l.empty.fire()})})),e.nodeType===1&&("height"in t||"width"in t)&&(n.overflow=[p.overflow,p.overflowX,p.overflowY],v.css(e,"display")==="inline"&&v.css(e,"float")==="none"&&(!v.support.inlineBlockNeedsLayout||nn(e.nodeName)==="inline"?p.display="inline-block":p.zoom=1)),n.overflow&&(p.overflow="hidden",v.support.shrinkWrapBlocks||h.done(function(){p.overflow=n.overflow[0],p.overflowX=n.overflow[1],p.overflowY=n.overflow[2]}));for(r in t){s=t[r];if(Un.exec(s)){delete t[r],a=a||s==="toggle";if(s===(g?"hide":"show"))continue;m.push(r)}}o=m.length;if(o){u=v._data(e,"fxshow")||v._data(e,"fxshow",{}),"hidden"in u&&(g=u.hidden),a&&(u.hidden=!g),g?v(e).show():h.done(function(){v(e).hide()}),h.done(function(){var t;v.removeData(e,"fxshow",!0);for(t in d)v.style(e,t,d[t])});for(r=0;r<o;r++)i=m[r],f=h.createTween(i,g?u[i]:0),d[i]=u[i]||v.style(e,i),i in u||(u[i]=f.start,g&&(f.end=f.start,f.start=i==="width"||i==="height"?1:0))}}function Yn(e,t,n,r,i){return new Yn.prototype.init(e,t,n,r,i)}function Zn(e,t){var n,r={height:e},i=0;t=t?1:0;for(;i<4;i+=2-t)n=$t[i],r["margin"+n]=r["padding"+n]=e;return t&&(r.opacity=r.width=e),r}function tr(e){return v.isWindow(e)?e:e.nodeType===9?e.defaultView||e.parentWindow:!1}var n,r,i=e.document,s=e.location,o=e.navigator,u=e.jQuery,a=e.$,f=Array.prototype.push,l=Array.prototype.slice,c=Array.prototype.indexOf,h=Object.prototype.toString,p=Object.prototype.hasOwnProperty,d=String.prototype.trim,v=function(e,t){return new v.fn.init(e,t,n)},m=/[\-+]?(?:\d*\.|)\d+(?:[eE][\-+]?\d+|)/.source,g=/\S/,y=/\s+/,b=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,w=/^(?:[^#<]*(<[\w\W]+>)[^>]*$|#([\w\-]*)$)/,E=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,S=/^[\],:{}\s]*$/,x=/(?:^|:|,)(?:\s*\[)+/g,T=/\\(?:["\\\/bfnrt]|u[\da-fA-F]{4})/g,N=/"[^"\\\r\n]*"|true|false|null|-?(?:\d\d*\.|)\d+(?:[eE][\-+]?\d+|)/g,C=/^-ms-/,k=/-([\da-z])/gi,L=function(e,t){return(t+"").toUpperCase()},A=function(){i.addEventListener?(i.removeEventListener("DOMContentLoaded",A,!1),v.ready()):i.readyState==="complete"&&(i.detachEvent("onreadystatechange",A),v.ready())},O={};v.fn=v.prototype={constructor:v,init:function(e,n,r){var s,o,u,a;if(!e)return this;if(e.nodeType)return this.context=this[0]=e,this.length=1,this;if(typeof e=="string"){e.charAt(0)==="<"&&e.charAt(e.length-1)===">"&&e.length>=3?s=[null,e,null]:s=w.exec(e);if(s&&(s[1]||!n)){if(s[1])return n=n instanceof v?n[0]:n,a=n&&n.nodeType?n.ownerDocument||n:i,e=v.parseHTML(s[1],a,!0),E.test(s[1])&&v.isPlainObject(n)&&this.attr.call(e,n,!0),v.merge(this,e);o=i.getElementById(s[2]);if(o&&o.parentNode){if(o.id!==s[2])return r.find(e);this.length=1,this[0]=o}return this.context=i,this.selector=e,this}return!n||n.jquery?(n||r).find(e):this.constructor(n).find(e)}return v.isFunction(e)?r.ready(e):(e.selector!==t&&(this.selector=e.selector,this.context=e.context),v.makeArray(e,this))},selector:"",jquery:"1.8.3",length:0,size:function(){return this.length},toArray:function(){return l.call(this)},get:function(e){return e==null?this.toArray():e<0?this[this.length+e]:this[e]},pushStack:function(e,t,n){var r=v.merge(this.constructor(),e);return r.prevObject=this,r.context=this.context,t==="find"?r.selector=this.selector+(this.selector?" ":"")+n:t&&(r.selector=this.selector+"."+t+"("+n+")"),r},each:function(e,t){return v.each(this,e,t)},ready:function(e){return v.ready.promise().done(e),this},eq:function(e){return e=+e,e===-1?this.slice(e):this.slice(e,e+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(l.apply(this,arguments),"slice",l.call(arguments).join(","))},map:function(e){return this.pushStack(v.map(this,function(t,n){return e.call(t,n,t)}))},end:function(){return this.prevObject||this.constructor(null)},push:f,sort:[].sort,splice:[].splice},v.fn.init.prototype=v.fn,v.extend=v.fn.extend=function(){var e,n,r,i,s,o,u=arguments[0]||{},a=1,f=arguments.length,l=!1;typeof u=="boolean"&&(l=u,u=arguments[1]||{},a=2),typeof u!="object"&&!v.isFunction(u)&&(u={}),f===a&&(u=this,--a);for(;a<f;a++)if((e=arguments[a])!=null)for(n in e){r=u[n],i=e[n];if(u===i)continue;l&&i&&(v.isPlainObject(i)||(s=v.isArray(i)))?(s?(s=!1,o=r&&v.isArray(r)?r:[]):o=r&&v.isPlainObject(r)?r:{},u[n]=v.extend(l,o,i)):i!==t&&(u[n]=i)}return u},v.extend({noConflict:function(t){return e.$===v&&(e.$=a),t&&e.jQuery===v&&(e.jQuery=u),v},isReady:!1,readyWait:1,holdReady:function(e){e?v.readyWait++:v.ready(!0)},ready:function(e){if(e===!0?--v.readyWait:v.isReady)return;if(!i.body)return setTimeout(v.ready,1);v.isReady=!0;if(e!==!0&&--v.readyWait>0)return;r.resolveWith(i,[v]),v.fn.trigger&&v(i).trigger("ready").off("ready")},isFunction:function(e){return v.type(e)==="function"},isArray:Array.isArray||function(e){return v.type(e)==="array"},isWindow:function(e){return e!=null&&e==e.window},isNumeric:function(e){return!isNaN(parseFloat(e))&&isFinite(e)},type:function(e){return e==null?String(e):O[h.call(e)]||"object"},isPlainObject:function(e){if(!e||v.type(e)!=="object"||e.nodeType||v.isWindow(e))return!1;try{if(e.constructor&&!p.call(e,"constructor")&&!p.call(e.constructor.prototype,"isPrototypeOf"))return!1}catch(n){return!1}var r;for(r in e);return r===t||p.call(e,r)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},error:function(e){throw new Error(e)},parseHTML:function(e,t,n){var r;return!e||typeof e!="string"?null:(typeof t=="boolean"&&(n=t,t=0),t=t||i,(r=E.exec(e))?[t.createElement(r[1])]:(r=v.buildFragment([e],t,n?null:[]),v.merge([],(r.cacheable?v.clone(r.fragment):r.fragment).childNodes)))},parseJSON:function(t){if(!t||typeof t!="string")return null;t=v.trim(t);if(e.JSON&&e.JSON.parse)return e.JSON.parse(t);if(S.test(t.replace(T,"@").replace(N,"]").replace(x,"")))return(new Function("return "+t))();v.error("Invalid JSON: "+t)},parseXML:function(n){var r,i;if(!n||typeof n!="string")return null;try{e.DOMParser?(i=new DOMParser,r=i.parseFromString(n,"text/xml")):(r=new ActiveXObject("Microsoft.XMLDOM"),r.async="false",r.loadXML(n))}catch(s){r=t}return(!r||!r.documentElement||r.getElementsByTagName("parsererror").length)&&v.error("Invalid XML: "+n),r},noop:function(){},globalEval:function(t){t&&g.test(t)&&(e.execScript||function(t){e.eval.call(e,t)})(t)},camelCase:function(e){return e.replace(C,"ms-").replace(k,L)},nodeName:function(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()},each:function(e,n,r){var i,s=0,o=e.length,u=o===t||v.isFunction(e);if(r){if(u){for(i in e)if(n.apply(e[i],r)===!1)break}else for(;s<o;)if(n.apply(e[s++],r)===!1)break}else if(u){for(i in e)if(n.call(e[i],i,e[i])===!1)break}else for(;s<o;)if(n.call(e[s],s,e[s++])===!1)break;return e},trim:d&&!d.call("\ufeff\u00a0")?function(e){return e==null?"":d.call(e)}:function(e){return e==null?"":(e+"").replace(b,"")},makeArray:function(e,t){var n,r=t||[];return e!=null&&(n=v.type(e),e.length==null||n==="string"||n==="function"||n==="regexp"||v.isWindow(e)?f.call(r,e):v.merge(r,e)),r},inArray:function(e,t,n){var r;if(t){if(c)return c.call(t,e,n);r=t.length,n=n?n<0?Math.max(0,r+n):n:0;for(;n<r;n++)if(n in t&&t[n]===e)return n}return-1},merge:function(e,n){var r=n.length,i=e.length,s=0;if(typeof r=="number")for(;s<r;s++)e[i++]=n[s];else while(n[s]!==t)e[i++]=n[s++];return e.length=i,e},grep:function(e,t,n){var r,i=[],s=0,o=e.length;n=!!n;for(;s<o;s++)r=!!t(e[s],s),n!==r&&i.push(e[s]);return i},map:function(e,n,r){var i,s,o=[],u=0,a=e.length,f=e instanceof v||a!==t&&typeof a=="number"&&(a>0&&e[0]&&e[a-1]||a===0||v.isArray(e));if(f)for(;u<a;u++)i=n(e[u],u,r),i!=null&&(o[o.length]=i);else for(s in e)i=n(e[s],s,r),i!=null&&(o[o.length]=i);return o.concat.apply([],o)},guid:1,proxy:function(e,n){var r,i,s;return typeof n=="string"&&(r=e[n],n=e,e=r),v.isFunction(e)?(i=l.call(arguments,2),s=function(){return e.apply(n,i.concat(l.call(arguments)))},s.guid=e.guid=e.guid||v.guid++,s):t},access:function(e,n,r,i,s,o,u){var a,f=r==null,l=0,c=e.length;if(r&&typeof r=="object"){for(l in r)v.access(e,n,l,r[l],1,o,i);s=1}else if(i!==t){a=u===t&&v.isFunction(i),f&&(a?(a=n,n=function(e,t,n){return a.call(v(e),n)}):(n.call(e,i),n=null));if(n)for(;l<c;l++)n(e[l],r,a?i.call(e[l],l,n(e[l],r)):i,u);s=1}return s?e:f?n.call(e):c?n(e[0],r):o},now:function(){return(new Date).getTime()}}),v.ready.promise=function(t){if(!r){r=v.Deferred();if(i.readyState==="complete")setTimeout(v.ready,1);else if(i.addEventListener)i.addEventListener("DOMContentLoaded",A,!1),e.addEventListener("load",v.ready,!1);else{i.attachEvent("onreadystatechange",A),e.attachEvent("onload",v.ready);var n=!1;try{n=e.frameElement==null&&i.documentElement}catch(s){}n&&n.doScroll&&function o(){if(!v.isReady){try{n.doScroll("left")}catch(e){return setTimeout(o,50)}v.ready()}}()}}return r.promise(t)},v.each("Boolean Number String Function Array Date RegExp Object".split(" "),function(e,t){O["[object "+t+"]"]=t.toLowerCase()}),n=v(i);var M={};v.Callbacks=function(e){e=typeof e=="string"?M[e]||_(e):v.extend({},e);var n,r,i,s,o,u,a=[],f=!e.once&&[],l=function(t){n=e.memory&&t,r=!0,u=s||0,s=0,o=a.length,i=!0;for(;a&&u<o;u++)if(a[u].apply(t[0],t[1])===!1&&e.stopOnFalse){n=!1;break}i=!1,a&&(f?f.length&&l(f.shift()):n?a=[]:c.disable())},c={add:function(){if(a){var t=a.length;(function r(t){v.each(t,function(t,n){var i=v.type(n);i==="function"?(!e.unique||!c.has(n))&&a.push(n):n&&n.length&&i!=="string"&&r(n)})})(arguments),i?o=a.length:n&&(s=t,l(n))}return this},remove:function(){return a&&v.each(arguments,function(e,t){var n;while((n=v.inArray(t,a,n))>-1)a.splice(n,1),i&&(n<=o&&o--,n<=u&&u--)}),this},has:function(e){return v.inArray(e,a)>-1},empty:function(){return a=[],this},disable:function(){return a=f=n=t,this},disabled:function(){return!a},lock:function(){return f=t,n||c.disable(),this},locked:function(){return!f},fireWith:function(e,t){return t=t||[],t=[e,t.slice?t.slice():t],a&&(!r||f)&&(i?f.push(t):l(t)),this},fire:function(){return c.fireWith(this,arguments),this},fired:function(){return!!r}};return c},v.extend({Deferred:function(e){var t=[["resolve","done",v.Callbacks("once memory"),"resolved"],["reject","fail",v.Callbacks("once memory"),"rejected"],["notify","progress",v.Callbacks("memory")]],n="pending",r={state:function(){return n},always:function(){return i.done(arguments).fail(arguments),this},then:function(){var e=arguments;return v.Deferred(function(n){v.each(t,function(t,r){var s=r[0],o=e[t];i[r[1]](v.isFunction(o)?function(){var e=o.apply(this,arguments);e&&v.isFunction(e.promise)?e.promise().done(n.resolve).fail(n.reject).progress(n.notify):n[s+"With"](this===i?n:this,[e])}:n[s])}),e=null}).promise()},promise:function(e){return e!=null?v.extend(e,r):r}},i={};return r.pipe=r.then,v.each(t,function(e,s){var o=s[2],u=s[3];r[s[1]]=o.add,u&&o.add(function(){n=u},t[e^1][2].disable,t[2][2].lock),i[s[0]]=o.fire,i[s[0]+"With"]=o.fireWith}),r.promise(i),e&&e.call(i,i),i},when:function(e){var t=0,n=l.call(arguments),r=n.length,i=r!==1||e&&v.isFunction(e.promise)?r:0,s=i===1?e:v.Deferred(),o=function(e,t,n){return function(r){t[e]=this,n[e]=arguments.length>1?l.call(arguments):r,n===u?s.notifyWith(t,n):--i||s.resolveWith(t,n)}},u,a,f;if(r>1){u=new Array(r),a=new Array(r),f=new Array(r);for(;t<r;t++)n[t]&&v.isFunction(n[t].promise)?n[t].promise().done(o(t,f,n)).fail(s.reject).progress(o(t,a,u)):--i}return i||s.resolveWith(f,n),s.promise()}}),v.support=function(){var t,n,r,s,o,u,a,f,l,c,h,p=i.createElement("div");p.setAttribute("className","t"),p.innerHTML=" <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",n=p.getElementsByTagName("*"),r=p.getElementsByTagName("a")[0];if(!n||!r||!n.length)return{};s=i.createElement("select"),o=s.appendChild(i.createElement("option")),u=p.getElementsByTagName("input")[0],r.style.cssText="top:1px;float:left;opacity:.5",t={leadingWhitespace:p.firstChild.nodeType===3,tbody:!p.getElementsByTagName("tbody").length,htmlSerialize:!!p.getElementsByTagName("link").length,style:/top/.test(r.getAttribute("style")),hrefNormalized:r.getAttribute("href")==="/a",opacity:/^0.5/.test(r.style.opacity),cssFloat:!!r.style.cssFloat,checkOn:u.value==="on",optSelected:o.selected,getSetAttribute:p.className!=="t",enctype:!!i.createElement("form").enctype,html5Clone:i.createElement("nav").cloneNode(!0).outerHTML!=="<:nav></:nav>",boxModel:i.compatMode==="CSS1Compat",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0,boxSizingReliable:!0,pixelPosition:!1},u.checked=!0,t.noCloneChecked=u.cloneNode(!0).checked,s.disabled=!0,t.optDisabled=!o.disabled;try{delete p.test}catch(d){t.deleteExpando=!1}!p.addEventListener&&p.attachEvent&&p.fireEvent&&(p.attachEvent("onclick",h=function(){t.noCloneEvent=!1}),p.cloneNode(!0).fireEvent("onclick"),p.detachEvent("onclick",h)),u=i.createElement("input"),u.value="t",u.setAttribute("type","radio"),t.radioValue=u.value==="t",u.setAttribute("checked","checked"),u.setAttribute("name","t"),p.appendChild(u),a=i.createDocumentFragment(),a.appendChild(p.lastChild),t.checkClone=a.cloneNode(!0).cloneNode(!0).lastChild.checked,t.appendChecked=u.checked,a.removeChild(u),a.appendChild(p);if(p.attachEvent)for(l in{submit:!0,change:!0,focusin:!0})f="on"+l,c=f in p,c||(p.setAttribute(f,"return;"),c=typeof p[f]=="function"),t[l+"Bubbles"]=c;return v(function(){var n,r,s,o,u="padding:0;margin:0;border:0;display:block;overflow:hidden;",a=i.getElementsByTagName("body")[0];if(!a)return;n=i.createElement("div"),n.style.cssText="visibility:hidden;border:0;width:0;height:0;position:static;top:0;margin-top:1px",a.insertBefore(n,a.firstChild),r=i.createElement("div"),n.appendChild(r),r.innerHTML="<table><tr><td></td><td>t</td></tr></table>",s=r.getElementsByTagName("td"),s[0].style.cssText="padding:0;margin:0;border:0;display:none",c=s[0].offsetHeight===0,s[0].style.display="",s[1].style.display="none",t.reliableHiddenOffsets=c&&s[0].offsetHeight===0,r.innerHTML="",r.style.cssText="box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;",t.boxSizing=r.offsetWidth===4,t.doesNotIncludeMarginInBodyOffset=a.offsetTop!==1,e.getComputedStyle&&(t.pixelPosition=(e.getComputedStyle(r,null)||{}).top!=="1%",t.boxSizingReliable=(e.getComputedStyle(r,null)||{width:"4px"}).width==="4px",o=i.createElement("div"),o.style.cssText=r.style.cssText=u,o.style.marginRight=o.style.width="0",r.style.width="1px",r.appendChild(o),t.reliableMarginRight=!parseFloat((e.getComputedStyle(o,null)||{}).marginRight)),typeof r.style.zoom!="undefined"&&(r.innerHTML="",r.style.cssText=u+"width:1px;padding:1px;display:inline;zoom:1",t.inlineBlockNeedsLayout=r.offsetWidth===3,r.style.display="block",r.style.overflow="visible",r.innerHTML="<div></div>",r.firstChild.style.width="5px",t.shrinkWrapBlocks=r.offsetWidth!==3,n.style.zoom=1),a.removeChild(n),n=r=s=o=null}),a.removeChild(p),n=r=s=o=u=a=p=null,t}();var D=/(?:\{[\s\S]*\}|\[[\s\S]*\])$/,P=/([A-Z])/g;v.extend({cache:{},deletedIds:[],uuid:0,expando:"jQuery"+(v.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(e){return e=e.nodeType?v.cache[e[v.expando]]:e[v.expando],!!e&&!B(e)},data:function(e,n,r,i){if(!v.acceptData(e))return;var s,o,u=v.expando,a=typeof n=="string",f=e.nodeType,l=f?v.cache:e,c=f?e[u]:e[u]&&u;if((!c||!l[c]||!i&&!l[c].data)&&a&&r===t)return;c||(f?e[u]=c=v.deletedIds.pop()||v.guid++:c=u),l[c]||(l[c]={},f||(l[c].toJSON=v.noop));if(typeof n=="object"||typeof n=="function")i?l[c]=v.extend(l[c],n):l[c].data=v.extend(l[c].data,n);return s=l[c],i||(s.data||(s.data={}),s=s.data),r!==t&&(s[v.camelCase(n)]=r),a?(o=s[n],o==null&&(o=s[v.camelCase(n)])):o=s,o},removeData:function(e,t,n){if(!v.acceptData(e))return;var r,i,s,o=e.nodeType,u=o?v.cache:e,a=o?e[v.expando]:v.expando;if(!u[a])return;if(t){r=n?u[a]:u[a].data;if(r){v.isArray(t)||(t in r?t=[t]:(t=v.camelCase(t),t in r?t=[t]:t=t.split(" ")));for(i=0,s=t.length;i<s;i++)delete r[t[i]];if(!(n?B:v.isEmptyObject)(r))return}}if(!n){delete u[a].data;if(!B(u[a]))return}o?v.cleanData([e],!0):v.support.deleteExpando||u!=u.window?delete u[a]:u[a]=null},_data:function(e,t,n){return v.data(e,t,n,!0)},acceptData:function(e){var t=e.nodeName&&v.noData[e.nodeName.toLowerCase()];return!t||t!==!0&&e.getAttribute("classid")===t}}),v.fn.extend({data:function(e,n){var r,i,s,o,u,a=this[0],f=0,l=null;if(e===t){if(this.length){l=v.data(a);if(a.nodeType===1&&!v._data(a,"parsedAttrs")){s=a.attributes;for(u=s.length;f<u;f++)o=s[f].name,o.indexOf("data-")||(o=v.camelCase(o.substring(5)),H(a,o,l[o]));v._data(a,"parsedAttrs",!0)}}return l}return typeof e=="object"?this.each(function(){v.data(this,e)}):(r=e.split(".",2),r[1]=r[1]?"."+r[1]:"",i=r[1]+"!",v.access(this,function(n){if(n===t)return l=this.triggerHandler("getData"+i,[r[0]]),l===t&&a&&(l=v.data(a,e),l=H(a,e,l)),l===t&&r[1]?this.data(r[0]):l;r[1]=n,this.each(function(){var t=v(this);t.triggerHandler("setData"+i,r),v.data(this,e,n),t.triggerHandler("changeData"+i,r)})},null,n,arguments.length>1,null,!1))},removeData:function(e){return this.each(function(){v.removeData(this,e)})}}),v.extend({queue:function(e,t,n){var r;if(e)return t=(t||"fx")+"queue",r=v._data(e,t),n&&(!r||v.isArray(n)?r=v._data(e,t,v.makeArray(n)):r.push(n)),r||[]},dequeue:function(e,t){t=t||"fx";var n=v.queue(e,t),r=n.length,i=n.shift(),s=v._queueHooks(e,t),o=function(){v.dequeue(e,t)};i==="inprogress"&&(i=n.shift(),r--),i&&(t==="fx"&&n.unshift("inprogress"),delete s.stop,i.call(e,o,s)),!r&&s&&s.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return v._data(e,n)||v._data(e,n,{empty:v.Callbacks("once memory").add(function(){v.removeData(e,t+"queue",!0),v.removeData(e,n,!0)})})}}),v.fn.extend({queue:function(e,n){var r=2;return typeof e!="string"&&(n=e,e="fx",r--),arguments.length<r?v.queue(this[0],e):n===t?this:this.each(function(){var t=v.queue(this,e,n);v._queueHooks(this,e),e==="fx"&&t[0]!=="inprogress"&&v.dequeue(this,e)})},dequeue:function(e){return this.each(function(){v.dequeue(this,e)})},delay:function(e,t){return e=v.fx?v.fx.speeds[e]||e:e,t=t||"fx",this.queue(t,function(t,n){var r=setTimeout(t,e);n.stop=function(){clearTimeout(r)}})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,n){var r,i=1,s=v.Deferred(),o=this,u=this.length,a=function(){--i||s.resolveWith(o,[o])};typeof e!="string"&&(n=e,e=t),e=e||"fx";while(u--)r=v._data(o[u],e+"queueHooks"),r&&r.empty&&(i++,r.empty.add(a));return a(),s.promise(n)}});var j,F,I,q=/[\t\r\n]/g,R=/\r/g,U=/^(?:button|input)$/i,z=/^(?:button|input|object|select|textarea)$/i,W=/^a(?:rea|)$/i,X=/^(?:autofocus|autoplay|async|checked|controls|defer|disabled|hidden|loop|multiple|open|readonly|required|scoped|selected)$/i,V=v.support.getSetAttribute;v.fn.extend({attr:function(e,t){return v.access(this,v.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){v.removeAttr(this,e)})},prop:function(e,t){return v.access(this,v.prop,e,t,arguments.length>1)},removeProp:function(e){return e=v.propFix[e]||e,this.each(function(){try{this[e]=t,delete this[e]}catch(n){}})},addClass:function(e){var t,n,r,i,s,o,u;if(v.isFunction(e))return this.each(function(t){v(this).addClass(e.call(this,t,this.className))});if(e&&typeof e=="string"){t=e.split(y);for(n=0,r=this.length;n<r;n++){i=this[n];if(i.nodeType===1)if(!i.className&&t.length===1)i.className=e;else{s=" "+i.className+" ";for(o=0,u=t.length;o<u;o++)s.indexOf(" "+t[o]+" ")<0&&(s+=t[o]+" ");i.className=v.trim(s)}}}return this},removeClass:function(e){var n,r,i,s,o,u,a;if(v.isFunction(e))return this.each(function(t){v(this).removeClass(e.call(this,t,this.className))});if(e&&typeof e=="string"||e===t){n=(e||"").split(y);for(u=0,a=this.length;u<a;u++){i=this[u];if(i.nodeType===1&&i.className){r=(" "+i.className+" ").replace(q," ");for(s=0,o=n.length;s<o;s++)while(r.indexOf(" "+n[s]+" ")>=0)r=r.replace(" "+n[s]+" "," ");i.className=e?v.trim(r):""}}}return this},toggleClass:function(e,t){var n=typeof e,r=typeof t=="boolean";return v.isFunction(e)?this.each(function(n){v(this).toggleClass(e.call(this,n,this.className,t),t)}):this.each(function(){if(n==="string"){var i,s=0,o=v(this),u=t,a=e.split(y);while(i=a[s++])u=r?u:!o.hasClass(i),o[u?"addClass":"removeClass"](i)}else if(n==="undefined"||n==="boolean")this.className&&v._data(this,"__className__",this.className),this.className=this.className||e===!1?"":v._data(this,"__className__")||""})},hasClass:function(e){var t=" "+e+" ",n=0,r=this.length;for(;n<r;n++)if(this[n].nodeType===1&&(" "+this[n].className+" ").replace(q," ").indexOf(t)>=0)return!0;return!1},val:function(e){var n,r,i,s=this[0];if(!arguments.length){if(s)return n=v.valHooks[s.type]||v.valHooks[s.nodeName.toLowerCase()],n&&"get"in n&&(r=n.get(s,"value"))!==t?r:(r=s.value,typeof r=="string"?r.replace(R,""):r==null?"":r);return}return i=v.isFunction(e),this.each(function(r){var s,o=v(this);if(this.nodeType!==1)return;i?s=e.call(this,r,o.val()):s=e,s==null?s="":typeof s=="number"?s+="":v.isArray(s)&&(s=v.map(s,function(e){return e==null?"":e+""})),n=v.valHooks[this.type]||v.valHooks[this.nodeName.toLowerCase()];if(!n||!("set"in n)||n.set(this,s,"value")===t)this.value=s})}}),v.extend({valHooks:{option:{get:function(e){var t=e.attributes.value;return!t||t.specified?e.value:e.text}},select:{get:function(e){var t,n,r=e.options,i=e.selectedIndex,s=e.type==="select-one"||i<0,o=s?null:[],u=s?i+1:r.length,a=i<0?u:s?i:0;for(;a<u;a++){n=r[a];if((n.selected||a===i)&&(v.support.optDisabled?!n.disabled:n.getAttribute("disabled")===null)&&(!n.parentNode.disabled||!v.nodeName(n.parentNode,"optgroup"))){t=v(n).val();if(s)return t;o.push(t)}}return o},set:function(e,t){var n=v.makeArray(t);return v(e).find("option").each(function(){this.selected=v.inArray(v(this).val(),n)>=0}),n.length||(e.selectedIndex=-1),n}}},attrFn:{},attr:function(e,n,r,i){var s,o,u,a=e.nodeType;if(!e||a===3||a===8||a===2)return;if(i&&v.isFunction(v.fn[n]))return v(e)[n](r);if(typeof e.getAttribute=="undefined")return v.prop(e,n,r);u=a!==1||!v.isXMLDoc(e),u&&(n=n.toLowerCase(),o=v.attrHooks[n]||(X.test(n)?F:j));if(r!==t){if(r===null){v.removeAttr(e,n);return}return o&&"set"in o&&u&&(s=o.set(e,r,n))!==t?s:(e.setAttribute(n,r+""),r)}return o&&"get"in o&&u&&(s=o.get(e,n))!==null?s:(s=e.getAttribute(n),s===null?t:s)},removeAttr:function(e,t){var n,r,i,s,o=0;if(t&&e.nodeType===1){r=t.split(y);for(;o<r.length;o++)i=r[o],i&&(n=v.propFix[i]||i,s=X.test(i),s||v.attr(e,i,""),e.removeAttribute(V?i:n),s&&n in e&&(e[n]=!1))}},attrHooks:{type:{set:function(e,t){if(U.test(e.nodeName)&&e.parentNode)v.error("type property can't be changed");else if(!v.support.radioValue&&t==="radio"&&v.nodeName(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}},value:{get:function(e,t){return j&&v.nodeName(e,"button")?j.get(e,t):t in e?e.value:null},set:function(e,t,n){if(j&&v.nodeName(e,"button"))return j.set(e,t,n);e.value=t}}},propFix:{tabindex:"tabIndex",readonly:"readOnly","for":"htmlFor","class":"className",maxlength:"maxLength",cellspacing:"cellSpacing",cellpadding:"cellPadding",rowspan:"rowSpan",colspan:"colSpan",usemap:"useMap",frameborder:"frameBorder",contenteditable:"contentEditable"},prop:function(e,n,r){var i,s,o,u=e.nodeType;if(!e||u===3||u===8||u===2)return;return o=u!==1||!v.isXMLDoc(e),o&&(n=v.propFix[n]||n,s=v.propHooks[n]),r!==t?s&&"set"in s&&(i=s.set(e,r,n))!==t?i:e[n]=r:s&&"get"in s&&(i=s.get(e,n))!==null?i:e[n]},propHooks:{tabIndex:{get:function(e){var n=e.getAttributeNode("tabindex");return n&&n.specified?parseInt(n.value,10):z.test(e.nodeName)||W.test(e.nodeName)&&e.href?0:t}}}}),F={get:function(e,n){var r,i=v.prop(e,n);return i===!0||typeof i!="boolean"&&(r=e.getAttributeNode(n))&&r.nodeValue!==!1?n.toLowerCase():t},set:function(e,t,n){var r;return t===!1?v.removeAttr(e,n):(r=v.propFix[n]||n,r in e&&(e[r]=!0),e.setAttribute(n,n.toLowerCase())),n}},V||(I={name:!0,id:!0,coords:!0},j=v.valHooks.button={get:function(e,n){var r;return r=e.getAttributeNode(n),r&&(I[n]?r.value!=="":r.specified)?r.value:t},set:function(e,t,n){var r=e.getAttributeNode(n);return r||(r=i.createAttribute(n),e.setAttributeNode(r)),r.value=t+""}},v.each(["width","height"],function(e,t){v.attrHooks[t]=v.extend(v.attrHooks[t],{set:function(e,n){if(n==="")return e.setAttribute(t,"auto"),n}})}),v.attrHooks.contenteditable={get:j.get,set:function(e,t,n){t===""&&(t="false"),j.set(e,t,n)}}),v.support.hrefNormalized||v.each(["href","src","width","height"],function(e,n){v.attrHooks[n]=v.extend(v.attrHooks[n],{get:function(e){var r=e.getAttribute(n,2);return r===null?t:r}})}),v.support.style||(v.attrHooks.style={get:function(e){return e.style.cssText.toLowerCase()||t},set:function(e,t){return e.style.cssText=t+""}}),v.support.optSelected||(v.propHooks.selected=v.extend(v.propHooks.selected,{get:function(e){var t=e.parentNode;return t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex),null}})),v.support.enctype||(v.propFix.enctype="encoding"),v.support.checkOn||v.each(["radio","checkbox"],function(){v.valHooks[this]={get:function(e){return e.getAttribute("value")===null?"on":e.value}}}),v.each(["radio","checkbox"],function(){v.valHooks[this]=v.extend(v.valHooks[this],{set:function(e,t){if(v.isArray(t))return e.checked=v.inArray(v(e).val(),t)>=0}})});var $=/^(?:textarea|input|select)$/i,J=/^([^\.]*|)(?:\.(.+)|)$/,K=/(?:^|\s)hover(\.\S+|)\b/,Q=/^key/,G=/^(?:mouse|contextmenu)|click/,Y=/^(?:focusinfocus|focusoutblur)$/,Z=function(e){return v.event.special.hover?e:e.replace(K,"mouseenter$1 mouseleave$1")};v.event={add:function(e,n,r,i,s){var o,u,a,f,l,c,h,p,d,m,g;if(e.nodeType===3||e.nodeType===8||!n||!r||!(o=v._data(e)))return;r.handler&&(d=r,r=d.handler,s=d.selector),r.guid||(r.guid=v.guid++),a=o.events,a||(o.events=a={}),u=o.handle,u||(o.handle=u=function(e){return typeof v=="undefined"||!!e&&v.event.triggered===e.type?t:v.event.dispatch.apply(u.elem,arguments)},u.elem=e),n=v.trim(Z(n)).split(" ");for(f=0;f<n.length;f++){l=J.exec(n[f])||[],c=l[1],h=(l[2]||"").split(".").sort(),g=v.event.special[c]||{},c=(s?g.delegateType:g.bindType)||c,g=v.event.special[c]||{},p=v.extend({type:c,origType:l[1],data:i,handler:r,guid:r.guid,selector:s,needsContext:s&&v.expr.match.needsContext.test(s),namespace:h.join(".")},d),m=a[c];if(!m){m=a[c]=[],m.delegateCount=0;if(!g.setup||g.setup.call(e,i,h,u)===!1)e.addEventListener?e.addEventListener(c,u,!1):e.attachEvent&&e.attachEvent("on"+c,u)}g.add&&(g.add.call(e,p),p.handler.guid||(p.handler.guid=r.guid)),s?m.splice(m.delegateCount++,0,p):m.push(p),v.event.global[c]=!0}e=null},global:{},remove:function(e,t,n,r,i){var s,o,u,a,f,l,c,h,p,d,m,g=v.hasData(e)&&v._data(e);if(!g||!(h=g.events))return;t=v.trim(Z(t||"")).split(" ");for(s=0;s<t.length;s++){o=J.exec(t[s])||[],u=a=o[1],f=o[2];if(!u){for(u in h)v.event.remove(e,u+t[s],n,r,!0);continue}p=v.event.special[u]||{},u=(r?p.delegateType:p.bindType)||u,d=h[u]||[],l=d.length,f=f?new RegExp("(^|\\.)"+f.split(".").sort().join("\\.(?:.*\\.|)")+"(\\.|$)"):null;for(c=0;c<d.length;c++)m=d[c],(i||a===m.origType)&&(!n||n.guid===m.guid)&&(!f||f.test(m.namespace))&&(!r||r===m.selector||r==="**"&&m.selector)&&(d.splice(c--,1),m.selector&&d.delegateCount--,p.remove&&p.remove.call(e,m));d.length===0&&l!==d.length&&((!p.teardown||p.teardown.call(e,f,g.handle)===!1)&&v.removeEvent(e,u,g.handle),delete h[u])}v.isEmptyObject(h)&&(delete g.handle,v.removeData(e,"events",!0))},customEvent:{getData:!0,setData:!0,changeData:!0},trigger:function(n,r,s,o){if(!s||s.nodeType!==3&&s.nodeType!==8){var u,a,f,l,c,h,p,d,m,g,y=n.type||n,b=[];if(Y.test(y+v.event.triggered))return;y.indexOf("!")>=0&&(y=y.slice(0,-1),a=!0),y.indexOf(".")>=0&&(b=y.split("."),y=b.shift(),b.sort());if((!s||v.event.customEvent[y])&&!v.event.global[y])return;n=typeof n=="object"?n[v.expando]?n:new v.Event(y,n):new v.Event(y),n.type=y,n.isTrigger=!0,n.exclusive=a,n.namespace=b.join("."),n.namespace_re=n.namespace?new RegExp("(^|\\.)"+b.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,h=y.indexOf(":")<0?"on"+y:"";if(!s){u=v.cache;for(f in u)u[f].events&&u[f].events[y]&&v.event.trigger(n,r,u[f].handle.elem,!0);return}n.result=t,n.target||(n.target=s),r=r!=null?v.makeArray(r):[],r.unshift(n),p=v.event.special[y]||{};if(p.trigger&&p.trigger.apply(s,r)===!1)return;m=[[s,p.bindType||y]];if(!o&&!p.noBubble&&!v.isWindow(s)){g=p.delegateType||y,l=Y.test(g+y)?s:s.parentNode;for(c=s;l;l=l.parentNode)m.push([l,g]),c=l;c===(s.ownerDocument||i)&&m.push([c.defaultView||c.parentWindow||e,g])}for(f=0;f<m.length&&!n.isPropagationStopped();f++)l=m[f][0],n.type=m[f][1],d=(v._data(l,"events")||{})[n.type]&&v._data(l,"handle"),d&&d.apply(l,r),d=h&&l[h],d&&v.acceptData(l)&&d.apply&&d.apply(l,r)===!1&&n.preventDefault();return n.type=y,!o&&!n.isDefaultPrevented()&&(!p._default||p._default.apply(s.ownerDocument,r)===!1)&&(y!=="click"||!v.nodeName(s,"a"))&&v.acceptData(s)&&h&&s[y]&&(y!=="focus"&&y!=="blur"||n.target.offsetWidth!==0)&&!v.isWindow(s)&&(c=s[h],c&&(s[h]=null),v.event.triggered=y,s[y](),v.event.triggered=t,c&&(s[h]=c)),n.result}return},dispatch:function(n){n=v.event.fix(n||e.event);var r,i,s,o,u,a,f,c,h,p,d=(v._data(this,"events")||{})[n.type]||[],m=d.delegateCount,g=l.call(arguments),y=!n.exclusive&&!n.namespace,b=v.event.special[n.type]||{},w=[];g[0]=n,n.delegateTarget=this;if(b.preDispatch&&b.preDispatch.call(this,n)===!1)return;if(m&&(!n.button||n.type!=="click"))for(s=n.target;s!=this;s=s.parentNode||this)if(s.disabled!==!0||n.type!=="click"){u={},f=[];for(r=0;r<m;r++)c=d[r],h=c.selector,u[h]===t&&(u[h]=c.needsContext?v(h,this).index(s)>=0:v.find(h,this,null,[s]).length),u[h]&&f.push(c);f.length&&w.push({elem:s,matches:f})}d.length>m&&w.push({elem:this,matches:d.slice(m)});for(r=0;r<w.length&&!n.isPropagationStopped();r++){a=w[r],n.currentTarget=a.elem;for(i=0;i<a.matches.length&&!n.isImmediatePropagationStopped();i++){c=a.matches[i];if(y||!n.namespace&&!c.namespace||n.namespace_re&&n.namespace_re.test(c.namespace))n.data=c.data,n.handleObj=c,o=((v.event.special[c.origType]||{}).handle||c.handler).apply(a.elem,g),o!==t&&(n.result=o,o===!1&&(n.preventDefault(),n.stopPropagation()))}}return b.postDispatch&&b.postDispatch.call(this,n),n.result},props:"attrChange attrName relatedNode srcElement altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char charCode key keyCode".split(" "),filter:function(e,t){return e.which==null&&(e.which=t.charCode!=null?t.charCode:t.keyCode),e}},mouseHooks:{props:"button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "),filter:function(e,n){var r,s,o,u=n.button,a=n.fromElement;return e.pageX==null&&n.clientX!=null&&(r=e.target.ownerDocument||i,s=r.documentElement,o=r.body,e.pageX=n.clientX+(s&&s.scrollLeft||o&&o.scrollLeft||0)-(s&&s.clientLeft||o&&o.clientLeft||0),e.pageY=n.clientY+(s&&s.scrollTop||o&&o.scrollTop||0)-(s&&s.clientTop||o&&o.clientTop||0)),!e.relatedTarget&&a&&(e.relatedTarget=a===e.target?n.toElement:a),!e.which&&u!==t&&(e.which=u&1?1:u&2?3:u&4?2:0),e}},fix:function(e){if(e[v.expando])return e;var t,n,r=e,s=v.event.fixHooks[e.type]||{},o=s.props?this.props.concat(s.props):this.props;e=v.Event(r);for(t=o.length;t;)n=o[--t],e[n]=r[n];return e.target||(e.target=r.srcElement||i),e.target.nodeType===3&&(e.target=e.target.parentNode),e.metaKey=!!e.metaKey,s.filter?s.filter(e,r):e},special:{load:{noBubble:!0},focus:{delegateType:"focusin"},blur:{delegateType:"focusout"},beforeunload:{setup:function(e,t,n){v.isWindow(this)&&(this.onbeforeunload=n)},teardown:function(e,t){this.onbeforeunload===t&&(this.onbeforeunload=null)}}},simulate:function(e,t,n,r){var i=v.extend(new v.Event,n,{type:e,isSimulated:!0,originalEvent:{}});r?v.event.trigger(i,null,t):v.event.dispatch.call(t,i),i.isDefaultPrevented()&&n.preventDefault()}},v.event.handle=v.event.dispatch,v.removeEvent=i.removeEventListener?function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n,!1)}:function(e,t,n){var r="on"+t;e.detachEvent&&(typeof e[r]=="undefined"&&(e[r]=null),e.detachEvent(r,n))},v.Event=function(e,t){if(!(this instanceof v.Event))return new v.Event(e,t);e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||e.returnValue===!1||e.getPreventDefault&&e.getPreventDefault()?tt:et):this.type=e,t&&v.extend(this,t),this.timeStamp=e&&e.timeStamp||v.now(),this[v.expando]=!0},v.Event.prototype={preventDefault:function(){this.isDefaultPrevented=tt;var e=this.originalEvent;if(!e)return;e.preventDefault?e.preventDefault():e.returnValue=!1},stopPropagation:function(){this.isPropagationStopped=tt;var e=this.originalEvent;if(!e)return;e.stopPropagation&&e.stopPropagation(),e.cancelBubble=!0},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=tt,this.stopPropagation()},isDefaultPrevented:et,isPropagationStopped:et,isImmediatePropagationStopped:et},v.each({mouseenter:"mouseover",mouseleave:"mouseout"},function(e,t){v.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=this,i=e.relatedTarget,s=e.handleObj,o=s.selector;if(!i||i!==r&&!v.contains(r,i))e.type=s.origType,n=s.handler.apply(this,arguments),e.type=t;return n}}}),v.support.submitBubbles||(v.event.special.submit={setup:function(){if(v.nodeName(this,"form"))return!1;v.event.add(this,"click._submit keypress._submit",function(e){var n=e.target,r=v.nodeName(n,"input")||v.nodeName(n,"button")?n.form:t;r&&!v._data(r,"_submit_attached")&&(v.event.add(r,"submit._submit",function(e){e._submit_bubble=!0}),v._data(r,"_submit_attached",!0))})},postDispatch:function(e){e._submit_bubble&&(delete e._submit_bubble,this.parentNode&&!e.isTrigger&&v.event.simulate("submit",this.parentNode,e,!0))},teardown:function(){if(v.nodeName(this,"form"))return!1;v.event.remove(this,"._submit")}}),v.support.changeBubbles||(v.event.special.change={setup:function(){if($.test(this.nodeName)){if(this.type==="checkbox"||this.type==="radio")v.event.add(this,"propertychange._change",function(e){e.originalEvent.propertyName==="checked"&&(this._just_changed=!0)}),v.event.add(this,"click._change",function(e){this._just_changed&&!e.isTrigger&&(this._just_changed=!1),v.event.simulate("change",this,e,!0)});return!1}v.event.add(this,"beforeactivate._change",function(e){var t=e.target;$.test(t.nodeName)&&!v._data(t,"_change_attached")&&(v.event.add(t,"change._change",function(e){this.parentNode&&!e.isSimulated&&!e.isTrigger&&v.event.simulate("change",this.parentNode,e,!0)}),v._data(t,"_change_attached",!0))})},handle:function(e){var t=e.target;if(this!==t||e.isSimulated||e.isTrigger||t.type!=="radio"&&t.type!=="checkbox")return e.handleObj.handler.apply(this,arguments)},teardown:function(){return v.event.remove(this,"._change"),!$.test(this.nodeName)}}),v.support.focusinBubbles||v.each({focus:"focusin",blur:"focusout"},function(e,t){var n=0,r=function(e){v.event.simulate(t,e.target,v.event.fix(e),!0)};v.event.special[t]={setup:function(){n++===0&&i.addEventListener(e,r,!0)},teardown:function(){--n===0&&i.removeEventListener(e,r,!0)}}}),v.fn.extend({on:function(e,n,r,i,s){var o,u;if(typeof e=="object"){typeof n!="string"&&(r=r||n,n=t);for(u in e)this.on(u,n,r,e[u],s);return this}r==null&&i==null?(i=n,r=n=t):i==null&&(typeof n=="string"?(i=r,r=t):(i=r,r=n,n=t));if(i===!1)i=et;else if(!i)return this;return s===1&&(o=i,i=function(e){return v().off(e),o.apply(this,arguments)},i.guid=o.guid||(o.guid=v.guid++)),this.each(function(){v.event.add(this,e,i,r,n)})},one:function(e,t,n,r){return this.on(e,t,n,r,1)},off:function(e,n,r){var i,s;if(e&&e.preventDefault&&e.handleObj)return i=e.handleObj,v(e.delegateTarget).off(i.namespace?i.origType+"."+i.namespace:i.origType,i.selector,i.handler),this;if(typeof e=="object"){for(s in e)this.off(s,n,e[s]);return this}if(n===!1||typeof n=="function")r=n,n=t;return r===!1&&(r=et),this.each(function(){v.event.remove(this,e,r,n)})},bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},live:function(e,t,n){return v(this.context).on(e,this.selector,t,n),this},die:function(e,t){return v(this.context).off(e,this.selector||"**",t),this},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return arguments.length===1?this.off(e,"**"):this.off(t,e||"**",n)},trigger:function(e,t){return this.each(function(){v.event.trigger(e,t,this)})},triggerHandler:function(e,t){if(this[0])return v.event.trigger(e,t,this[0],!0)},toggle:function(e){var t=arguments,n=e.guid||v.guid++,r=0,i=function(n){var i=(v._data(this,"lastToggle"+e.guid)||0)%r;return v._data(this,"lastToggle"+e.guid,i+1),n.preventDefault(),t[i].apply(this,arguments)||!1};i.guid=n;while(r<t.length)t[r++].guid=n;return this.click(i)},hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)}}),v.each("blur focus focusin focusout load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup error contextmenu".split(" "),function(e,t){v.fn[t]=function(e,n){return n==null&&(n=e,e=null),arguments.length>0?this.on(t,null,e,n):this.trigger(t)},Q.test(t)&&(v.event.fixHooks[t]=v.event.keyHooks),G.test(t)&&(v.event.fixHooks[t]=v.event.mouseHooks)}),function(e,t){function nt(e,t,n,r){n=n||[],t=t||g;var i,s,a,f,l=t.nodeType;if(!e||typeof e!="string")return n;if(l!==1&&l!==9)return[];a=o(t);if(!a&&!r)if(i=R.exec(e))if(f=i[1]){if(l===9){s=t.getElementById(f);if(!s||!s.parentNode)return n;if(s.id===f)return n.push(s),n}else if(t.ownerDocument&&(s=t.ownerDocument.getElementById(f))&&u(t,s)&&s.id===f)return n.push(s),n}else{if(i[2])return S.apply(n,x.call(t.getElementsByTagName(e),0)),n;if((f=i[3])&&Z&&t.getElementsByClassName)return S.apply(n,x.call(t.getElementsByClassName(f),0)),n}return vt(e.replace(j,"$1"),t,n,r,a)}function rt(e){return function(t){var n=t.nodeName.toLowerCase();return n==="input"&&t.type===e}}function it(e){return function(t){var n=t.nodeName.toLowerCase();return(n==="input"||n==="button")&&t.type===e}}function st(e){return N(function(t){return t=+t,N(function(n,r){var i,s=e([],n.length,t),o=s.length;while(o--)n[i=s[o]]&&(n[i]=!(r[i]=n[i]))})})}function ot(e,t,n){if(e===t)return n;var r=e.nextSibling;while(r){if(r===t)return-1;r=r.nextSibling}return 1}function ut(e,t){var n,r,s,o,u,a,f,l=L[d][e+" "];if(l)return t?0:l.slice(0);u=e,a=[],f=i.preFilter;while(u){if(!n||(r=F.exec(u)))r&&(u=u.slice(r[0].length)||u),a.push(s=[]);n=!1;if(r=I.exec(u))s.push(n=new m(r.shift())),u=u.slice(n.length),n.type=r[0].replace(j," ");for(o in i.filter)(r=J[o].exec(u))&&(!f[o]||(r=f[o](r)))&&(s.push(n=new m(r.shift())),u=u.slice(n.length),n.type=o,n.matches=r);if(!n)break}return t?u.length:u?nt.error(e):L(e,a).slice(0)}function at(e,t,r){var i=t.dir,s=r&&t.dir==="parentNode",o=w++;return t.first?function(t,n,r){while(t=t[i])if(s||t.nodeType===1)return e(t,n,r)}:function(t,r,u){if(!u){var a,f=b+" "+o+" ",l=f+n;while(t=t[i])if(s||t.nodeType===1){if((a=t[d])===l)return t.sizset;if(typeof a=="string"&&a.indexOf(f)===0){if(t.sizset)return t}else{t[d]=l;if(e(t,r,u))return t.sizset=!0,t;t.sizset=!1}}}else while(t=t[i])if(s||t.nodeType===1)if(e(t,r,u))return t}}function ft(e){return e.length>1?function(t,n,r){var i=e.length;while(i--)if(!e[i](t,n,r))return!1;return!0}:e[0]}function lt(e,t,n,r,i){var s,o=[],u=0,a=e.length,f=t!=null;for(;u<a;u++)if(s=e[u])if(!n||n(s,r,i))o.push(s),f&&t.push(u);return o}function ct(e,t,n,r,i,s){return r&&!r[d]&&(r=ct(r)),i&&!i[d]&&(i=ct(i,s)),N(function(s,o,u,a){var f,l,c,h=[],p=[],d=o.length,v=s||dt(t||"*",u.nodeType?[u]:u,[]),m=e&&(s||!t)?lt(v,h,e,u,a):v,g=n?i||(s?e:d||r)?[]:o:m;n&&n(m,g,u,a);if(r){f=lt(g,p),r(f,[],u,a),l=f.length;while(l--)if(c=f[l])g[p[l]]=!(m[p[l]]=c)}if(s){if(i||e){if(i){f=[],l=g.length;while(l--)(c=g[l])&&f.push(m[l]=c);i(null,g=[],f,a)}l=g.length;while(l--)(c=g[l])&&(f=i?T.call(s,c):h[l])>-1&&(s[f]=!(o[f]=c))}}else g=lt(g===o?g.splice(d,g.length):g),i?i(null,o,g,a):S.apply(o,g)})}function ht(e){var t,n,r,s=e.length,o=i.relative[e[0].type],u=o||i.relative[" "],a=o?1:0,f=at(function(e){return e===t},u,!0),l=at(function(e){return T.call(t,e)>-1},u,!0),h=[function(e,n,r){return!o&&(r||n!==c)||((t=n).nodeType?f(e,n,r):l(e,n,r))}];for(;a<s;a++)if(n=i.relative[e[a].type])h=[at(ft(h),n)];else{n=i.filter[e[a].type].apply(null,e[a].matches);if(n[d]){r=++a;for(;r<s;r++)if(i.relative[e[r].type])break;return ct(a>1&&ft(h),a>1&&e.slice(0,a-1).join("").replace(j,"$1"),n,a<r&&ht(e.slice(a,r)),r<s&&ht(e=e.slice(r)),r<s&&e.join(""))}h.push(n)}return ft(h)}function pt(e,t){var r=t.length>0,s=e.length>0,o=function(u,a,f,l,h){var p,d,v,m=[],y=0,w="0",x=u&&[],T=h!=null,N=c,C=u||s&&i.find.TAG("*",h&&a.parentNode||a),k=b+=N==null?1:Math.E;T&&(c=a!==g&&a,n=o.el);for(;(p=C[w])!=null;w++){if(s&&p){for(d=0;v=e[d];d++)if(v(p,a,f)){l.push(p);break}T&&(b=k,n=++o.el)}r&&((p=!v&&p)&&y--,u&&x.push(p))}y+=w;if(r&&w!==y){for(d=0;v=t[d];d++)v(x,m,a,f);if(u){if(y>0)while(w--)!x[w]&&!m[w]&&(m[w]=E.call(l));m=lt(m)}S.apply(l,m),T&&!u&&m.length>0&&y+t.length>1&&nt.uniqueSort(l)}return T&&(b=k,c=N),x};return o.el=0,r?N(o):o}function dt(e,t,n){var r=0,i=t.length;for(;r<i;r++)nt(e,t[r],n);return n}function vt(e,t,n,r,s){var o,u,f,l,c,h=ut(e),p=h.length;if(!r&&h.length===1){u=h[0]=h[0].slice(0);if(u.length>2&&(f=u[0]).type==="ID"&&t.nodeType===9&&!s&&i.relative[u[1].type]){t=i.find.ID(f.matches[0].replace($,""),t,s)[0];if(!t)return n;e=e.slice(u.shift().length)}for(o=J.POS.test(e)?-1:u.length-1;o>=0;o--){f=u[o];if(i.relative[l=f.type])break;if(c=i.find[l])if(r=c(f.matches[0].replace($,""),z.test(u[0].type)&&t.parentNode||t,s)){u.splice(o,1),e=r.length&&u.join("");if(!e)return S.apply(n,x.call(r,0)),n;break}}}return a(e,h)(r,t,s,n,z.test(e)),n}function mt(){}var n,r,i,s,o,u,a,f,l,c,h=!0,p="undefined",d=("sizcache"+Math.random()).replace(".",""),m=String,g=e.document,y=g.documentElement,b=0,w=0,E=[].pop,S=[].push,x=[].slice,T=[].indexOf||function(e){var t=0,n=this.length;for(;t<n;t++)if(this[t]===e)return t;return-1},N=function(e,t){return e[d]=t==null||t,e},C=function(){var e={},t=[];return N(function(n,r){return t.push(n)>i.cacheLength&&delete e[t.shift()],e[n+" "]=r},e)},k=C(),L=C(),A=C(),O="[\\x20\\t\\r\\n\\f]",M="(?:\\\\.|[-\\w]|[^\\x00-\\xa0])+",_=M.replace("w","w#"),D="([*^$|!~]?=)",P="\\["+O+"*("+M+")"+O+"*(?:"+D+O+"*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|("+_+")|)|)"+O+"*\\]",H=":("+M+")(?:\\((?:(['\"])((?:\\\\.|[^\\\\])*?)\\2|([^()[\\]]*|(?:(?:"+P+")|[^:]|\\\\.)*|.*))\\)|)",B=":(even|odd|eq|gt|lt|nth|first|last)(?:\\("+O+"*((?:-\\d)?\\d*)"+O+"*\\)|)(?=[^-]|$)",j=new RegExp("^"+O+"+|((?:^|[^\\\\])(?:\\\\.)*)"+O+"+$","g"),F=new RegExp("^"+O+"*,"+O+"*"),I=new RegExp("^"+O+"*([\\x20\\t\\r\\n\\f>+~])"+O+"*"),q=new RegExp(H),R=/^(?:#([\w\-]+)|(\w+)|\.([\w\-]+))$/,U=/^:not/,z=/[\x20\t\r\n\f]*[+~]/,W=/:not\($/,X=/h\d/i,V=/input|select|textarea|button/i,$=/\\(?!\\)/g,J={ID:new RegExp("^#("+M+")"),CLASS:new RegExp("^\\.("+M+")"),NAME:new RegExp("^\\[name=['\"]?("+M+")['\"]?\\]"),TAG:new RegExp("^("+M.replace("w","w*")+")"),ATTR:new RegExp("^"+P),PSEUDO:new RegExp("^"+H),POS:new RegExp(B,"i"),CHILD:new RegExp("^:(only|nth|first|last)-child(?:\\("+O+"*(even|odd|(([+-]|)(\\d*)n|)"+O+"*(?:([+-]|)"+O+"*(\\d+)|))"+O+"*\\)|)","i"),needsContext:new RegExp("^"+O+"*[>+~]|"+B,"i")},K=function(e){var t=g.createElement("div");try{return e(t)}catch(n){return!1}finally{t=null}},Q=K(function(e){return e.appendChild(g.createComment("")),!e.getElementsByTagName("*").length}),G=K(function(e){return e.innerHTML="<a href='#'></a>",e.firstChild&&typeof e.firstChild.getAttribute!==p&&e.firstChild.getAttribute("href")==="#"}),Y=K(function(e){e.innerHTML="<select></select>";var t=typeof e.lastChild.getAttribute("multiple");return t!=="boolean"&&t!=="string"}),Z=K(function(e){return e.innerHTML="<div class='hidden e'></div><div class='hidden'></div>",!e.getElementsByClassName||!e.getElementsByClassName("e").length?!1:(e.lastChild.className="e",e.getElementsByClassName("e").length===2)}),et=K(function(e){e.id=d+0,e.innerHTML="<a name='"+d+"'></a><div name='"+d+"'></div>",y.insertBefore(e,y.firstChild);var t=g.getElementsByName&&g.getElementsByName(d).length===2+g.getElementsByName(d+0).length;return r=!g.getElementById(d),y.removeChild(e),t});try{x.call(y.childNodes,0)[0].nodeType}catch(tt){x=function(e){var t,n=[];for(;t=this[e];e++)n.push(t);return n}}nt.matches=function(e,t){return nt(e,null,null,t)},nt.matchesSelector=function(e,t){return nt(t,null,null,[e]).length>0},s=nt.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(i===1||i===9||i===11){if(typeof e.textContent=="string")return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=s(e)}else if(i===3||i===4)return e.nodeValue}else for(;t=e[r];r++)n+=s(t);return n},o=nt.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return t?t.nodeName!=="HTML":!1},u=nt.contains=y.contains?function(e,t){var n=e.nodeType===9?e.documentElement:e,r=t&&t.parentNode;return e===r||!!(r&&r.nodeType===1&&n.contains&&n.contains(r))}:y.compareDocumentPosition?function(e,t){return t&&!!(e.compareDocumentPosition(t)&16)}:function(e,t){while(t=t.parentNode)if(t===e)return!0;return!1},nt.attr=function(e,t){var n,r=o(e);return r||(t=t.toLowerCase()),(n=i.attrHandle[t])?n(e):r||Y?e.getAttribute(t):(n=e.getAttributeNode(t),n?typeof e[t]=="boolean"?e[t]?t:null:n.specified?n.value:null:null)},i=nt.selectors={cacheLength:50,createPseudo:N,match:J,attrHandle:G?{}:{href:function(e){return e.getAttribute("href",2)},type:function(e){return e.getAttribute("type")}},find:{ID:r?function(e,t,n){if(typeof t.getElementById!==p&&!n){var r=t.getElementById(e);return r&&r.parentNode?[r]:[]}}:function(e,n,r){if(typeof n.getElementById!==p&&!r){var i=n.getElementById(e);return i?i.id===e||typeof i.getAttributeNode!==p&&i.getAttributeNode("id").value===e?[i]:t:[]}},TAG:Q?function(e,t){if(typeof t.getElementsByTagName!==p)return t.getElementsByTagName(e)}:function(e,t){var n=t.getElementsByTagName(e);if(e==="*"){var r,i=[],s=0;for(;r=n[s];s++)r.nodeType===1&&i.push(r);return i}return n},NAME:et&&function(e,t){if(typeof t.getElementsByName!==p)return t.getElementsByName(name)},CLASS:Z&&function(e,t,n){if(typeof t.getElementsByClassName!==p&&!n)return t.getElementsByClassName(e)}},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace($,""),e[3]=(e[4]||e[5]||"").replace($,""),e[2]==="~="&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),e[1]==="nth"?(e[2]||nt.error(e[0]),e[3]=+(e[3]?e[4]+(e[5]||1):2*(e[2]==="even"||e[2]==="odd")),e[4]=+(e[6]+e[7]||e[2]==="odd")):e[2]&&nt.error(e[0]),e},PSEUDO:function(e){var t,n;if(J.CHILD.test(e[0]))return null;if(e[3])e[2]=e[3];else if(t=e[4])q.test(t)&&(n=ut(t,!0))&&(n=t.indexOf(")",t.length-n)-t.length)&&(t=t.slice(0,n),e[0]=e[0].slice(0,n)),e[2]=t;return e.slice(0,3)}},filter:{ID:r?function(e){return e=e.replace($,""),function(t){return t.getAttribute("id")===e}}:function(e){return e=e.replace($,""),function(t){var n=typeof t.getAttributeNode!==p&&t.getAttributeNode("id");return n&&n.value===e}},TAG:function(e){return e==="*"?function(){return!0}:(e=e.replace($,"").toLowerCase(),function(t){return t.nodeName&&t.nodeName.toLowerCase()===e})},CLASS:function(e){var t=k[d][e+" "];return t||(t=new RegExp("(^|"+O+")"+e+"("+O+"|$)"))&&k(e,function(e){return t.test(e.className||typeof e.getAttribute!==p&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r,i){var s=nt.attr(r,e);return s==null?t==="!=":t?(s+="",t==="="?s===n:t==="!="?s!==n:t==="^="?n&&s.indexOf(n)===0:t==="*="?n&&s.indexOf(n)>-1:t==="$="?n&&s.substr(s.length-n.length)===n:t==="~="?(" "+s+" ").indexOf(n)>-1:t==="|="?s===n||s.substr(0,n.length+1)===n+"-":!1):!0}},CHILD:function(e,t,n,r){return e==="nth"?function(e){var t,i,s=e.parentNode;if(n===1&&r===0)return!0;if(s){i=0;for(t=s.firstChild;t;t=t.nextSibling)if(t.nodeType===1){i++;if(e===t)break}}return i-=r,i===n||i%n===0&&i/n>=0}:function(t){var n=t;switch(e){case"only":case"first":while(n=n.previousSibling)if(n.nodeType===1)return!1;if(e==="first")return!0;n=t;case"last":while(n=n.nextSibling)if(n.nodeType===1)return!1;return!0}}},PSEUDO:function(e,t){var n,r=i.pseudos[e]||i.setFilters[e.toLowerCase()]||nt.error("unsupported pseudo: "+e);return r[d]?r(t):r.length>1?(n=[e,e,"",t],i.setFilters.hasOwnProperty(e.toLowerCase())?N(function(e,n){var i,s=r(e,t),o=s.length;while(o--)i=T.call(e,s[o]),e[i]=!(n[i]=s[o])}):function(e){return r(e,0,n)}):r}},pseudos:{not:N(function(e){var t=[],n=[],r=a(e.replace(j,"$1"));return r[d]?N(function(e,t,n,i){var s,o=r(e,null,i,[]),u=e.length;while(u--)if(s=o[u])e[u]=!(t[u]=s)}):function(e,i,s){return t[0]=e,r(t,null,s,n),!n.pop()}}),has:N(function(e){return function(t){return nt(e,t).length>0}}),contains:N(function(e){return function(t){return(t.textContent||t.innerText||s(t)).indexOf(e)>-1}}),enabled:function(e){return e.disabled===!1},disabled:function(e){return e.disabled===!0},checked:function(e){var t=e.nodeName.toLowerCase();return t==="input"&&!!e.checked||t==="option"&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},parent:function(e){return!i.pseudos.empty(e)},empty:function(e){var t;e=e.firstChild;while(e){if(e.nodeName>"@"||(t=e.nodeType)===3||t===4)return!1;e=e.nextSibling}return!0},header:function(e){return X.test(e.nodeName)},text:function(e){var t,n;return e.nodeName.toLowerCase()==="input"&&(t=e.type)==="text"&&((n=e.getAttribute("type"))==null||n.toLowerCase()===t)},radio:rt("radio"),checkbox:rt("checkbox"),file:rt("file"),password:rt("password"),image:rt("image"),submit:it("submit"),reset:it("reset"),button:function(e){var t=e.nodeName.toLowerCase();return t==="input"&&e.type==="button"||t==="button"},input:function(e){return V.test(e.nodeName)},focus:function(e){var t=e.ownerDocument;return e===t.activeElement&&(!t.hasFocus||t.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},active:function(e){return e===e.ownerDocument.activeElement},first:st(function(){return[0]}),last:st(function(e,t){return[t-1]}),eq:st(function(e,t,n){return[n<0?n+t:n]}),even:st(function(e,t){for(var n=0;n<t;n+=2)e.push(n);return e}),odd:st(function(e,t){for(var n=1;n<t;n+=2)e.push(n);return e}),lt:st(function(e,t,n){for(var r=n<0?n+t:n;--r>=0;)e.push(r);return e}),gt:st(function(e,t,n){for(var r=n<0?n+t:n;++r<t;)e.push(r);return e})}},f=y.compareDocumentPosition?function(e,t){return e===t?(l=!0,0):(!e.compareDocumentPosition||!t.compareDocumentPosition?e.compareDocumentPosition:e.compareDocumentPosition(t)&4)?-1:1}:function(e,t){if(e===t)return l=!0,0;if(e.sourceIndex&&t.sourceIndex)return e.sourceIndex-t.sourceIndex;var n,r,i=[],s=[],o=e.parentNode,u=t.parentNode,a=o;if(o===u)return ot(e,t);if(!o)return-1;if(!u)return 1;while(a)i.unshift(a),a=a.parentNode;a=u;while(a)s.unshift(a),a=a.parentNode;n=i.length,r=s.length;for(var f=0;f<n&&f<r;f++)if(i[f]!==s[f])return ot(i[f],s[f]);return f===n?ot(e,s[f],-1):ot(i[f],t,1)},[0,0].sort(f),h=!l,nt.uniqueSort=function(e){var t,n=[],r=1,i=0;l=h,e.sort(f);if(l){for(;t=e[r];r++)t===e[r-1]&&(i=n.push(r));while(i--)e.splice(n[i],1)}return e},nt.error=function(e){throw new Error("Syntax error, unrecognized expression: "+e)},a=nt.compile=function(e,t){var n,r=[],i=[],s=A[d][e+" "];if(!s){t||(t=ut(e)),n=t.length;while(n--)s=ht(t[n]),s[d]?r.push(s):i.push(s);s=A(e,pt(i,r))}return s},g.querySelectorAll&&function(){var e,t=vt,n=/'|\\/g,r=/\=[\x20\t\r\n\f]*([^'"\]]*)[\x20\t\r\n\f]*\]/g,i=[":focus"],s=[":active"],u=y.matchesSelector||y.mozMatchesSelector||y.webkitMatchesSelector||y.oMatchesSelector||y.msMatchesSelector;K(function(e){e.innerHTML="<select><option selected=''></option></select>",e.querySelectorAll("[selected]").length||i.push("\\["+O+"*(?:checked|disabled|ismap|multiple|readonly|selected|value)"),e.querySelectorAll(":checked").length||i.push(":checked")}),K(function(e){e.innerHTML="<p test=''></p>",e.querySelectorAll("[test^='']").length&&i.push("[*^$]="+O+"*(?:\"\"|'')"),e.innerHTML="<input type='hidden'/>",e.querySelectorAll(":enabled").length||i.push(":enabled",":disabled")}),i=new RegExp(i.join("|")),vt=function(e,r,s,o,u){if(!o&&!u&&!i.test(e)){var a,f,l=!0,c=d,h=r,p=r.nodeType===9&&e;if(r.nodeType===1&&r.nodeName.toLowerCase()!=="object"){a=ut(e),(l=r.getAttribute("id"))?c=l.replace(n,"\\$&"):r.setAttribute("id",c),c="[id='"+c+"'] ",f=a.length;while(f--)a[f]=c+a[f].join("");h=z.test(e)&&r.parentNode||r,p=a.join(",")}if(p)try{return S.apply(s,x.call(h.querySelectorAll(p),0)),s}catch(v){}finally{l||r.removeAttribute("id")}}return t(e,r,s,o,u)},u&&(K(function(t){e=u.call(t,"div");try{u.call(t,"[test!='']:sizzle"),s.push("!=",H)}catch(n){}}),s=new RegExp(s.join("|")),nt.matchesSelector=function(t,n){n=n.replace(r,"='$1']");if(!o(t)&&!s.test(n)&&!i.test(n))try{var a=u.call(t,n);if(a||e||t.document&&t.document.nodeType!==11)return a}catch(f){}return nt(n,null,null,[t]).length>0})}(),i.pseudos.nth=i.pseudos.eq,i.filters=mt.prototype=i.pseudos,i.setFilters=new mt,nt.attr=v.attr,v.find=nt,v.expr=nt.selectors,v.expr[":"]=v.expr.pseudos,v.unique=nt.uniqueSort,v.text=nt.getText,v.isXMLDoc=nt.isXML,v.contains=nt.contains}(e);var nt=/Until$/,rt=/^(?:parents|prev(?:Until|All))/,it=/^.[^:#\[\.,]*$/,st=v.expr.match.needsContext,ot={children:!0,contents:!0,next:!0,prev:!0};v.fn.extend({find:function(e){var t,n,r,i,s,o,u=this;if(typeof e!="string")return v(e).filter(function(){for(t=0,n=u.length;t<n;t++)if(v.contains(u[t],this))return!0});o=this.pushStack("","find",e);for(t=0,n=this.length;t<n;t++){r=o.length,v.find(e,this[t],o);if(t>0)for(i=r;i<o.length;i++)for(s=0;s<r;s++)if(o[s]===o[i]){o.splice(i--,1);break}}return o},has:function(e){var t,n=v(e,this),r=n.length;return this.filter(function(){for(t=0;t<r;t++)if(v.contains(this,n[t]))return!0})},not:function(e){return this.pushStack(ft(this,e,!1),"not",e)},filter:function(e){return this.pushStack(ft(this,e,!0),"filter",e)},is:function(e){return!!e&&(typeof e=="string"?st.test(e)?v(e,this.context).index(this[0])>=0:v.filter(e,this).length>0:this.filter(e).length>0)},closest:function(e,t){var n,r=0,i=this.length,s=[],o=st.test(e)||typeof e!="string"?v(e,t||this.context):0;for(;r<i;r++){n=this[r];while(n&&n.ownerDocument&&n!==t&&n.nodeType!==11){if(o?o.index(n)>-1:v.find.matchesSelector(n,e)){s.push(n);break}n=n.parentNode}}return s=s.length>1?v.unique(s):s,this.pushStack(s,"closest",e)},index:function(e){return e?typeof e=="string"?v.inArray(this[0],v(e)):v.inArray(e.jquery?e[0]:e,this):this[0]&&this[0].parentNode?this.prevAll().length:-1},add:function(e,t){var n=typeof e=="string"?v(e,t):v.makeArray(e&&e.nodeType?[e]:e),r=v.merge(this.get(),n);return this.pushStack(ut(n[0])||ut(r[0])?r:v.unique(r))},addBack:function(e){return this.add(e==null?this.prevObject:this.prevObject.filter(e))}}),v.fn.andSelf=v.fn.addBack,v.each({parent:function(e){var t=e.parentNode;return t&&t.nodeType!==11?t:null},parents:function(e){return v.dir(e,"parentNode")},parentsUntil:function(e,t,n){return v.dir(e,"parentNode",n)},next:function(e){return at(e,"nextSibling")},prev:function(e){return at(e,"previousSibling")},nextAll:function(e){return v.dir(e,"nextSibling")},prevAll:function(e){return v.dir(e,"previousSibling")},nextUntil:function(e,t,n){return v.dir(e,"nextSibling",n)},prevUntil:function(e,t,n){return v.dir(e,"previousSibling",n)},siblings:function(e){return v.sibling((e.parentNode||{}).firstChild,e)},children:function(e){return v.sibling(e.firstChild)},contents:function(e){return v.nodeName(e,"iframe")?e.contentDocument||e.contentWindow.document:v.merge([],e.childNodes)}},function(e,t){v.fn[e]=function(n,r){var i=v.map(this,t,n);return nt.test(e)||(r=n),r&&typeof r=="string"&&(i=v.filter(r,i)),i=this.length>1&&!ot[e]?v.unique(i):i,this.length>1&&rt.test(e)&&(i=i.reverse()),this.pushStack(i,e,l.call(arguments).join(","))}}),v.extend({filter:function(e,t,n){return n&&(e=":not("+e+")"),t.length===1?v.find.matchesSelector(t[0],e)?[t[0]]:[]:v.find.matches(e,t)},dir:function(e,n,r){var i=[],s=e[n];while(s&&s.nodeType!==9&&(r===t||s.nodeType!==1||!v(s).is(r)))s.nodeType===1&&i.push(s),s=s[n];return i},sibling:function(e,t){var n=[];for(;e;e=e.nextSibling)e.nodeType===1&&e!==t&&n.push(e);return n}});var ct="abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",ht=/ jQuery\d+="(?:null|\d+)"/g,pt=/^\s+/,dt=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,vt=/<([\w:]+)/,mt=/<tbody/i,gt=/<|&#?\w+;/,yt=/<(?:script|style|link)/i,bt=/<(?:script|object|embed|option|style)/i,wt=new RegExp("<(?:"+ct+")[\\s/>]","i"),Et=/^(?:checkbox|radio)$/,St=/checked\s*(?:[^=]|=\s*.checked.)/i,xt=/\/(java|ecma)script/i,Tt=/^\s*<!(?:\[CDATA\[|\-\-)|[\]\-]{2}>\s*$/g,Nt={option:[1,"<select multiple='multiple'>","</select>"],legend:[1,"<fieldset>","</fieldset>"],thead:[1,"<table>","</table>"],tr:[2,"<table><tbody>","</tbody></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],area:[1,"<map>","</map>"],_default:[0,"",""]},Ct=lt(i),kt=Ct.appendChild(i.createElement("div"));Nt.optgroup=Nt.option,Nt.tbody=Nt.tfoot=Nt.colgroup=Nt.caption=Nt.thead,Nt.th=Nt.td,v.support.htmlSerialize||(Nt._default=[1,"X<div>","</div>"]),v.fn.extend({text:function(e){return v.access(this,function(e){return e===t?v.text(this):this.empty().append((this[0]&&this[0].ownerDocument||i).createTextNode(e))},null,e,arguments.length)},wrapAll:function(e){if(v.isFunction(e))return this.each(function(t){v(this).wrapAll(e.call(this,t))});if(this[0]){var t=v(e,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstChild&&e.firstChild.nodeType===1)e=e.firstChild;return e}).append(this)}return this},wrapInner:function(e){return v.isFunction(e)?this.each(function(t){v(this).wrapInner(e.call(this,t))}):this.each(function(){var t=v(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=v.isFunction(e);return this.each(function(n){v(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(){return this.parent().each(function(){v.nodeName(this,"body")||v(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,!0,function(e){(this.nodeType===1||this.nodeType===11)&&this.appendChild(e)})},prepend:function(){return this.domManip(arguments,!0,function(e){(this.nodeType===1||this.nodeType===11)&&this.insertBefore(e,this.firstChild)})},before:function(){if(!ut(this[0]))return this.domManip(arguments,!1,function(e){this.parentNode.insertBefore(e,this)});if(arguments.length){var e=v.clean(arguments);return this.pushStack(v.merge(e,this),"before",this.selector)}},after:function(){if(!ut(this[0]))return this.domManip(arguments,!1,function(e){this.parentNode.insertBefore(e,this.nextSibling)});if(arguments.length){var e=v.clean(arguments);return this.pushStack(v.merge(this,e),"after",this.selector)}},remove:function(e,t){var n,r=0;for(;(n=this[r])!=null;r++)if(!e||v.filter(e,[n]).length)!t&&n.nodeType===1&&(v.cleanData(n.getElementsByTagName("*")),v.cleanData([n])),n.parentNode&&n.parentNode.removeChild(n);return this},empty:function(){var e,t=0;for(;(e=this[t])!=null;t++){e.nodeType===1&&v.cleanData(e.getElementsByTagName("*"));while(e.firstChild)e.removeChild(e.firstChild)}return this},clone:function(e,t){return e=e==null?!1:e,t=t==null?e:t,this.map(function(){return v.clone(this,e,t)})},html:function(e){return v.access(this,function(e){var n=this[0]||{},r=0,i=this.length;if(e===t)return n.nodeType===1?n.innerHTML.replace(ht,""):t;if(typeof e=="string"&&!yt.test(e)&&(v.support.htmlSerialize||!wt.test(e))&&(v.support.leadingWhitespace||!pt.test(e))&&!Nt[(vt.exec(e)||["",""])[1].toLowerCase()]){e=e.replace(dt,"<$1></$2>");try{for(;r<i;r++)n=this[r]||{},n.nodeType===1&&(v.cleanData(n.getElementsByTagName("*")),n.innerHTML=e);n=0}catch(s){}}n&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(e){return ut(this[0])?this.length?this.pushStack(v(v.isFunction(e)?e():e),"replaceWith",e):this:v.isFunction(e)?this.each(function(t){var n=v(this),r=n.html();n.replaceWith(e.call(this,t,r))}):(typeof e!="string"&&(e=v(e).detach()),this.each(function(){var t=this.nextSibling,n=this.parentNode;v(this).remove(),t?v(t).before(e):v(n).append(e)}))},detach:function(e){return this.remove(e,!0)},domManip:function(e,n,r){e=[].concat.apply([],e);var i,s,o,u,a=0,f=e[0],l=[],c=this.length;if(!v.support.checkClone&&c>1&&typeof f=="string"&&St.test(f))return this.each(function(){v(this).domManip(e,n,r)});if(v.isFunction(f))return this.each(function(i){var s=v(this);e[0]=f.call(this,i,n?s.html():t),s.domManip(e,n,r)});if(this[0]){i=v.buildFragment(e,this,l),o=i.fragment,s=o.firstChild,o.childNodes.length===1&&(o=s);if(s){n=n&&v.nodeName(s,"tr");for(u=i.cacheable||c-1;a<c;a++)r.call(n&&v.nodeName(this[a],"table")?Lt(this[a],"tbody"):this[a],a===u?o:v.clone(o,!0,!0))}o=s=null,l.length&&v.each(l,function(e,t){t.src?v.ajax?v.ajax({url:t.src,type:"GET",dataType:"script",async:!1,global:!1,"throws":!0}):v.error("no ajax"):v.globalEval((t.text||t.textContent||t.innerHTML||"").replace(Tt,"")),t.parentNode&&t.parentNode.removeChild(t)})}return this}}),v.buildFragment=function(e,n,r){var s,o,u,a=e[0];return n=n||i,n=!n.nodeType&&n[0]||n,n=n.ownerDocument||n,e.length===1&&typeof a=="string"&&a.length<512&&n===i&&a.charAt(0)==="<"&&!bt.test(a)&&(v.support.checkClone||!St.test(a))&&(v.support.html5Clone||!wt.test(a))&&(o=!0,s=v.fragments[a],u=s!==t),s||(s=n.createDocumentFragment(),v.clean(e,n,s,r),o&&(v.fragments[a]=u&&s)),{fragment:s,cacheable:o}},v.fragments={},v.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){v.fn[e]=function(n){var r,i=0,s=[],o=v(n),u=o.length,a=this.length===1&&this[0].parentNode;if((a==null||a&&a.nodeType===11&&a.childNodes.length===1)&&u===1)return o[t](this[0]),this;for(;i<u;i++)r=(i>0?this.clone(!0):this).get(),v(o[i])[t](r),s=s.concat(r);return this.pushStack(s,e,o.selector)}}),v.extend({clone:function(e,t,n){var r,i,s,o;v.support.html5Clone||v.isXMLDoc(e)||!wt.test("<"+e.nodeName+">")?o=e.cloneNode(!0):(kt.innerHTML=e.outerHTML,kt.removeChild(o=kt.firstChild));if((!v.support.noCloneEvent||!v.support.noCloneChecked)&&(e.nodeType===1||e.nodeType===11)&&!v.isXMLDoc(e)){Ot(e,o),r=Mt(e),i=Mt(o);for(s=0;r[s];++s)i[s]&&Ot(r[s],i[s])}if(t){At(e,o);if(n){r=Mt(e),i=Mt(o);for(s=0;r[s];++s)At(r[s],i[s])}}return r=i=null,o},clean:function(e,t,n,r){var s,o,u,a,f,l,c,h,p,d,m,g,y=t===i&&Ct,b=[];if(!t||typeof t.createDocumentFragment=="undefined")t=i;for(s=0;(u=e[s])!=null;s++){typeof u=="number"&&(u+="");if(!u)continue;if(typeof u=="string")if(!gt.test(u))u=t.createTextNode(u);else{y=y||lt(t),c=t.createElement("div"),y.appendChild(c),u=u.replace(dt,"<$1></$2>"),a=(vt.exec(u)||["",""])[1].toLowerCase(),f=Nt[a]||Nt._default,l=f[0],c.innerHTML=f[1]+u+f[2];while(l--)c=c.lastChild;if(!v.support.tbody){h=mt.test(u),p=a==="table"&&!h?c.firstChild&&c.firstChild.childNodes:f[1]==="<table>"&&!h?c.childNodes:[];for(o=p.length-1;o>=0;--o)v.nodeName(p[o],"tbody")&&!p[o].childNodes.length&&p[o].parentNode.removeChild(p[o])}!v.support.leadingWhitespace&&pt.test(u)&&c.insertBefore(t.createTextNode(pt.exec(u)[0]),c.firstChild),u=c.childNodes,c.parentNode.removeChild(c)}u.nodeType?b.push(u):v.merge(b,u)}c&&(u=c=y=null);if(!v.support.appendChecked)for(s=0;(u=b[s])!=null;s++)v.nodeName(u,"input")?_t(u):typeof u.getElementsByTagName!="undefined"&&v.grep(u.getElementsByTagName("input"),_t);if(n){m=function(e){if(!e.type||xt.test(e.type))return r?r.push(e.parentNode?e.parentNode.removeChild(e):e):n.appendChild(e)};for(s=0;(u=b[s])!=null;s++)if(!v.nodeName(u,"script")||!m(u))n.appendChild(u),typeof u.getElementsByTagName!="undefined"&&(g=v.grep(v.merge([],u.getElementsByTagName("script")),m),b.splice.apply(b,[s+1,0].concat(g)),s+=g.length)}return b},cleanData:function(e,t){var n,r,i,s,o=0,u=v.expando,a=v.cache,f=v.support.deleteExpando,l=v.event.special;for(;(i=e[o])!=null;o++)if(t||v.acceptData(i)){r=i[u],n=r&&a[r];if(n){if(n.events)for(s in n.events)l[s]?v.event.remove(i,s):v.removeEvent(i,s,n.handle);a[r]&&(delete a[r],f?delete i[u]:i.removeAttribute?i.removeAttribute(u):i[u]=null,v.deletedIds.push(r))}}}}),function(){var e,t;v.uaMatch=function(e){e=e.toLowerCase();var t=/(chrome)[ \/]([\w.]+)/.exec(e)||/(webkit)[ \/]([\w.]+)/.exec(e)||/(opera)(?:.*version|)[ \/]([\w.]+)/.exec(e)||/(msie) ([\w.]+)/.exec(e)||e.indexOf("compatible")<0&&/(mozilla)(?:.*? rv:([\w.]+)|)/.exec(e)||[];return{browser:t[1]||"",version:t[2]||"0"}},e=v.uaMatch(o.userAgent),t={},e.browser&&(t[e.browser]=!0,t.version=e.version),t.chrome?t.webkit=!0:t.webkit&&(t.safari=!0),v.browser=t,v.sub=function(){function e(t,n){return new e.fn.init(t,n)}v.extend(!0,e,this),e.superclass=this,e.fn=e.prototype=this(),e.fn.constructor=e,e.sub=this.sub,e.fn.init=function(r,i){return i&&i instanceof v&&!(i instanceof e)&&(i=e(i)),v.fn.init.call(this,r,i,t)},e.fn.init.prototype=e.fn;var t=e(i);return e}}();var Dt,Pt,Ht,Bt=/alpha\([^)]*\)/i,jt=/opacity=([^)]*)/,Ft=/^(top|right|bottom|left)$/,It=/^(none|table(?!-c[ea]).+)/,qt=/^margin/,Rt=new RegExp("^("+m+")(.*)$","i"),Ut=new RegExp("^("+m+")(?!px)[a-z%]+$","i"),zt=new RegExp("^([-+])=("+m+")","i"),Wt={BODY:"block"},Xt={position:"absolute",visibility:"hidden",display:"block"},Vt={letterSpacing:0,fontWeight:400},$t=["Top","Right","Bottom","Left"],Jt=["Webkit","O","Moz","ms"],Kt=v.fn.toggle;v.fn.extend({css:function(e,n){return v.access(this,function(e,n,r){return r!==t?v.style(e,n,r):v.css(e,n)},e,n,arguments.length>1)},show:function(){return Yt(this,!0)},hide:function(){return Yt(this)},toggle:function(e,t){var n=typeof e=="boolean";return v.isFunction(e)&&v.isFunction(t)?Kt.apply(this,arguments):this.each(function(){(n?e:Gt(this))?v(this).show():v(this).hide()})}}),v.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Dt(e,"opacity");return n===""?"1":n}}}},cssNumber:{fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":v.support.cssFloat?"cssFloat":"styleFloat"},style:function(e,n,r,i){if(!e||e.nodeType===3||e.nodeType===8||!e.style)return;var s,o,u,a=v.camelCase(n),f=e.style;n=v.cssProps[a]||(v.cssProps[a]=Qt(f,a)),u=v.cssHooks[n]||v.cssHooks[a];if(r===t)return u&&"get"in u&&(s=u.get(e,!1,i))!==t?s:f[n];o=typeof r,o==="string"&&(s=zt.exec(r))&&(r=(s[1]+1)*s[2]+parseFloat(v.css(e,n)),o="number");if(r==null||o==="number"&&isNaN(r))return;o==="number"&&!v.cssNumber[a]&&(r+="px");if(!u||!("set"in u)||(r=u.set(e,r,i))!==t)try{f[n]=r}catch(l){}},css:function(e,n,r,i){var s,o,u,a=v.camelCase(n);return n=v.cssProps[a]||(v.cssProps[a]=Qt(e.style,a)),u=v.cssHooks[n]||v.cssHooks[a],u&&"get"in u&&(s=u.get(e,!0,i)),s===t&&(s=Dt(e,n)),s==="normal"&&n in Vt&&(s=Vt[n]),r||i!==t?(o=parseFloat(s),r||v.isNumeric(o)?o||0:s):s},swap:function(e,t,n){var r,i,s={};for(i in t)s[i]=e.style[i],e.style[i]=t[i];r=n.call(e);for(i in t)e.style[i]=s[i];return r}}),e.getComputedStyle?Dt=function(t,n){var r,i,s,o,u=e.getComputedStyle(t,null),a=t.style;return u&&(r=u.getPropertyValue(n)||u[n],r===""&&!v.contains(t.ownerDocument,t)&&(r=v.style(t,n)),Ut.test(r)&&qt.test(n)&&(i=a.width,s=a.minWidth,o=a.maxWidth,a.minWidth=a.maxWidth=a.width=r,r=u.width,a.width=i,a.minWidth=s,a.maxWidth=o)),r}:i.documentElement.currentStyle&&(Dt=function(e,t){var n,r,i=e.currentStyle&&e.currentStyle[t],s=e.style;return i==null&&s&&s[t]&&(i=s[t]),Ut.test(i)&&!Ft.test(t)&&(n=s.left,r=e.runtimeStyle&&e.runtimeStyle.left,r&&(e.runtimeStyle.left=e.currentStyle.left),s.left=t==="fontSize"?"1em":i,i=s.pixelLeft+"px",s.left=n,r&&(e.runtimeStyle.left=r)),i===""?"auto":i}),v.each(["height","width"],function(e,t){v.cssHooks[t]={get:function(e,n,r){if(n)return e.offsetWidth===0&&It.test(Dt(e,"display"))?v.swap(e,Xt,function(){return tn(e,t,r)}):tn(e,t,r)},set:function(e,n,r){return Zt(e,n,r?en(e,t,r,v.support.boxSizing&&v.css(e,"boxSizing")==="border-box"):0)}}}),v.support.opacity||(v.cssHooks.opacity={get:function(e,t){return jt.test((t&&e.currentStyle?e.currentStyle.filter:e.style.filter)||"")?.01*parseFloat(RegExp.$1)+"":t?"1":""},set:function(e,t){var n=e.style,r=e.currentStyle,i=v.isNumeric(t)?"alpha(opacity="+t*100+")":"",s=r&&r.filter||n.filter||"";n.zoom=1;if(t>=1&&v.trim(s.replace(Bt,""))===""&&n.removeAttribute){n.removeAttribute("filter");if(r&&!r.filter)return}n.filter=Bt.test(s)?s.replace(Bt,i):s+" "+i}}),v(function(){v.support.reliableMarginRight||(v.cssHooks.marginRight={get:function(e,t){return v.swap(e,{display:"inline-block"},function(){if(t)return Dt(e,"marginRight")})}}),!v.support.pixelPosition&&v.fn.position&&v.each(["top","left"],function(e,t){v.cssHooks[t]={get:function(e,n){if(n){var r=Dt(e,t);return Ut.test(r)?v(e).position()[t]+"px":r}}}})}),v.expr&&v.expr.filters&&(v.expr.filters.hidden=function(e){return e.offsetWidth===0&&e.offsetHeight===0||!v.support.reliableHiddenOffsets&&(e.style&&e.style.display||Dt(e,"display"))==="none"},v.expr.filters.visible=function(e){return!v.expr.filters.hidden(e)}),v.each({margin:"",padding:"",border:"Width"},function(e,t){v.cssHooks[e+t]={expand:function(n){var r,i=typeof n=="string"?n.split(" "):[n],s={};for(r=0;r<4;r++)s[e+$t[r]+t]=i[r]||i[r-2]||i[0];return s}},qt.test(e)||(v.cssHooks[e+t].set=Zt)});var rn=/%20/g,sn=/\[\]$/,on=/\r?\n/g,un=/^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,an=/^(?:select|textarea)/i;v.fn.extend({serialize:function(){return v.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?v.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||an.test(this.nodeName)||un.test(this.type))}).map(function(e,t){var n=v(this).val();return n==null?null:v.isArray(n)?v.map(n,function(e,n){return{name:t.name,value:e.replace(on,"\r\n")}}):{name:t.name,value:n.replace(on,"\r\n")}}).get()}}),v.param=function(e,n){var r,i=[],s=function(e,t){t=v.isFunction(t)?t():t==null?"":t,i[i.length]=encodeURIComponent(e)+"="+encodeURIComponent(t)};n===t&&(n=v.ajaxSettings&&v.ajaxSettings.traditional);if(v.isArray(e)||e.jquery&&!v.isPlainObject(e))v.each(e,function(){s(this.name,this.value)});else for(r in e)fn(r,e[r],n,s);return i.join("&").replace(rn,"+")};var ln,cn,hn=/#.*$/,pn=/^(.*?):[ \t]*([^\r\n]*)\r?$/mg,dn=/^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/,vn=/^(?:GET|HEAD)$/,mn=/^\/\//,gn=/\?/,yn=/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,bn=/([?&])_=[^&]*/,wn=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+)|)|)/,En=v.fn.load,Sn={},xn={},Tn=["*/"]+["*"];try{cn=s.href}catch(Nn){cn=i.createElement("a"),cn.href="",cn=cn.href}ln=wn.exec(cn.toLowerCase())||[],v.fn.load=function(e,n,r){if(typeof e!="string"&&En)return En.apply(this,arguments);if(!this.length)return this;var i,s,o,u=this,a=e.indexOf(" ");return a>=0&&(i=e.slice(a,e.length),e=e.slice(0,a)),v.isFunction(n)?(r=n,n=t):n&&typeof n=="object"&&(s="POST"),v.ajax({url:e,type:s,dataType:"html",data:n,complete:function(e,t){r&&u.each(r,o||[e.responseText,t,e])}}).done(function(e){o=arguments,u.html(i?v("<div>").append(e.replace(yn,"")).find(i):e)}),this},v.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(e,t){v.fn[t]=function(e){return this.on(t,e)}}),v.each(["get","post"],function(e,n){v[n]=function(e,r,i,s){return v.isFunction(r)&&(s=s||i,i=r,r=t),v.ajax({type:n,url:e,data:r,success:i,dataType:s})}}),v.extend({getScript:function(e,n){return v.get(e,t,n,"script")},getJSON:function(e,t,n){return v.get(e,t,n,"json")},ajaxSetup:function(e,t){return t?Ln(e,v.ajaxSettings):(t=e,e=v.ajaxSettings),Ln(e,t),e},ajaxSettings:{url:cn,isLocal:dn.test(ln[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded; charset=UTF-8",processData:!0,async:!0,accepts:{xml:"application/xml, text/xml",html:"text/html",text:"text/plain",json:"application/json, text/javascript","*":Tn},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"* text":e.String,"text html":!0,"text json":v.parseJSON,"text xml":v.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:Cn(Sn),ajaxTransport:Cn(xn),ajax:function(e,n){function T(e,n,s,a){var l,y,b,w,S,T=n;if(E===2)return;E=2,u&&clearTimeout(u),o=t,i=a||"",x.readyState=e>0?4:0,s&&(w=An(c,x,s));if(e>=200&&e<300||e===304)c.ifModified&&(S=x.getResponseHeader("Last-Modified"),S&&(v.lastModified[r]=S),S=x.getResponseHeader("Etag"),S&&(v.etag[r]=S)),e===304?(T="notmodified",l=!0):(l=On(c,w),T=l.state,y=l.data,b=l.error,l=!b);else{b=T;if(!T||e)T="error",e<0&&(e=0)}x.status=e,x.statusText=(n||T)+"",l?d.resolveWith(h,[y,T,x]):d.rejectWith(h,[x,T,b]),x.statusCode(g),g=t,f&&p.trigger("ajax"+(l?"Success":"Error"),[x,c,l?y:b]),m.fireWith(h,[x,T]),f&&(p.trigger("ajaxComplete",[x,c]),--v.active||v.event.trigger("ajaxStop"))}typeof e=="object"&&(n=e,e=t),n=n||{};var r,i,s,o,u,a,f,l,c=v.ajaxSetup({},n),h=c.context||c,p=h!==c&&(h.nodeType||h instanceof v)?v(h):v.event,d=v.Deferred(),m=v.Callbacks("once memory"),g=c.statusCode||{},b={},w={},E=0,S="canceled",x={readyState:0,setRequestHeader:function(e,t){if(!E){var n=e.toLowerCase();e=w[n]=w[n]||e,b[e]=t}return this},getAllResponseHeaders:function(){return E===2?i:null},getResponseHeader:function(e){var n;if(E===2){if(!s){s={};while(n=pn.exec(i))s[n[1].toLowerCase()]=n[2]}n=s[e.toLowerCase()]}return n===t?null:n},overrideMimeType:function(e){return E||(c.mimeType=e),this},abort:function(e){return e=e||S,o&&o.abort(e),T(0,e),this}};d.promise(x),x.success=x.done,x.error=x.fail,x.complete=m.add,x.statusCode=function(e){if(e){var t;if(E<2)for(t in e)g[t]=[g[t],e[t]];else t=e[x.status],x.always(t)}return this},c.url=((e||c.url)+"").replace(hn,"").replace(mn,ln[1]+"//"),c.dataTypes=v.trim(c.dataType||"*").toLowerCase().split(y),c.crossDomain==null&&(a=wn.exec(c.url.toLowerCase()),c.crossDomain=!(!a||a[1]===ln[1]&&a[2]===ln[2]&&(a[3]||(a[1]==="http:"?80:443))==(ln[3]||(ln[1]==="http:"?80:443)))),c.data&&c.processData&&typeof c.data!="string"&&(c.data=v.param(c.data,c.traditional)),kn(Sn,c,n,x);if(E===2)return x;f=c.global,c.type=c.type.toUpperCase(),c.hasContent=!vn.test(c.type),f&&v.active++===0&&v.event.trigger("ajaxStart");if(!c.hasContent){c.data&&(c.url+=(gn.test(c.url)?"&":"?")+c.data,delete c.data),r=c.url;if(c.cache===!1){var N=v.now(),C=c.url.replace(bn,"$1_="+N);c.url=C+(C===c.url?(gn.test(c.url)?"&":"?")+"_="+N:"")}}(c.data&&c.hasContent&&c.contentType!==!1||n.contentType)&&x.setRequestHeader("Content-Type",c.contentType),c.ifModified&&(r=r||c.url,v.lastModified[r]&&x.setRequestHeader("If-Modified-Since",v.lastModified[r]),v.etag[r]&&x.setRequestHeader("If-None-Match",v.etag[r])),x.setRequestHeader("Accept",c.dataTypes[0]&&c.accepts[c.dataTypes[0]]?c.accepts[c.dataTypes[0]]+(c.dataTypes[0]!=="*"?", "+Tn+"; q=0.01":""):c.accepts["*"]);for(l in c.headers)x.setRequestHeader(l,c.headers[l]);if(!c.beforeSend||c.beforeSend.call(h,x,c)!==!1&&E!==2){S="abort";for(l in{success:1,error:1,complete:1})x[l](c[l]);o=kn(xn,c,n,x);if(!o)T(-1,"No Transport");else{x.readyState=1,f&&p.trigger("ajaxSend",[x,c]),c.async&&c.timeout>0&&(u=setTimeout(function(){x.abort("timeout")},c.timeout));try{E=1,o.send(b,T)}catch(k){if(!(E<2))throw k;T(-1,k)}}return x}return x.abort()},active:0,lastModified:{},etag:{}});var Mn=[],_n=/\?/,Dn=/(=)\?(?=&|$)|\?\?/,Pn=v.now();v.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Mn.pop()||v.expando+"_"+Pn++;return this[e]=!0,e}}),v.ajaxPrefilter("json jsonp",function(n,r,i){var s,o,u,a=n.data,f=n.url,l=n.jsonp!==!1,c=l&&Dn.test(f),h=l&&!c&&typeof a=="string"&&!(n.contentType||"").indexOf("application/x-www-form-urlencoded")&&Dn.test(a);if(n.dataTypes[0]==="jsonp"||c||h)return s=n.jsonpCallback=v.isFunction(n.jsonpCallback)?n.jsonpCallback():n.jsonpCallback,o=e[s],c?n.url=f.replace(Dn,"$1"+s):h?n.data=a.replace(Dn,"$1"+s):l&&(n.url+=(_n.test(f)?"&":"?")+n.jsonp+"="+s),n.converters["script json"]=function(){return u||v.error(s+" was not called"),u[0]},n.dataTypes[0]="json",e[s]=function(){u=arguments},i.always(function(){e[s]=o,n[s]&&(n.jsonpCallback=r.jsonpCallback,Mn.push(s)),u&&v.isFunction(o)&&o(u[0]),u=o=t}),"script"}),v.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/javascript|ecmascript/},converters:{"text script":function(e){return v.globalEval(e),e}}}),v.ajaxPrefilter("script",function(e){e.cache===t&&(e.cache=!1),e.crossDomain&&(e.type="GET",e.global=!1)}),v.ajaxTransport("script",function(e){if(e.crossDomain){var n,r=i.head||i.getElementsByTagName("head")[0]||i.documentElement;return{send:function(s,o){n=i.createElement("script"),n.async="async",e.scriptCharset&&(n.charset=e.scriptCharset),n.src=e.url,n.onload=n.onreadystatechange=function(e,i){if(i||!n.readyState||/loaded|complete/.test(n.readyState))n.onload=n.onreadystatechange=null,r&&n.parentNode&&r.removeChild(n),n=t,i||o(200,"success")},r.insertBefore(n,r.firstChild)},abort:function(){n&&n.onload(0,1)}}}});var Hn,Bn=e.ActiveXObject?function(){for(var e in Hn)Hn[e](0,1)}:!1,jn=0;v.ajaxSettings.xhr=e.ActiveXObject?function(){return!this.isLocal&&Fn()||In()}:Fn,function(e){v.extend(v.support,{ajax:!!e,cors:!!e&&"withCredentials"in e})}(v.ajaxSettings.xhr()),v.support.ajax&&v.ajaxTransport(function(n){if(!n.crossDomain||v.support.cors){var r;return{send:function(i,s){var o,u,a=n.xhr();n.username?a.open(n.type,n.url,n.async,n.username,n.password):a.open(n.type,n.url,n.async);if(n.xhrFields)for(u in n.xhrFields)a[u]=n.xhrFields[u];n.mimeType&&a.overrideMimeType&&a.overrideMimeType(n.mimeType),!n.crossDomain&&!i["X-Requested-With"]&&(i["X-Requested-With"]="XMLHttpRequest");try{for(u in i)a.setRequestHeader(u,i[u])}catch(f){}a.send(n.hasContent&&n.data||null),r=function(e,i){var u,f,l,c,h;try{if(r&&(i||a.readyState===4)){r=t,o&&(a.onreadystatechange=v.noop,Bn&&delete Hn[o]);if(i)a.readyState!==4&&a.abort();else{u=a.status,l=a.getAllResponseHeaders(),c={},h=a.responseXML,h&&h.documentElement&&(c.xml=h);try{c.text=a.responseText}catch(p){}try{f=a.statusText}catch(p){f=""}!u&&n.isLocal&&!n.crossDomain?u=c.text?200:404:u===1223&&(u=204)}}}catch(d){i||s(-1,d)}c&&s(u,f,c,l)},n.async?a.readyState===4?setTimeout(r,0):(o=++jn,Bn&&(Hn||(Hn={},v(e).unload(Bn)),Hn[o]=r),a.onreadystatechange=r):r()},abort:function(){r&&r(0,1)}}}});var qn,Rn,Un=/^(?:toggle|show|hide)$/,zn=new RegExp("^(?:([-+])=|)("+m+")([a-z%]*)$","i"),Wn=/queueHooks$/,Xn=[Gn],Vn={"*":[function(e,t){var n,r,i=this.createTween(e,t),s=zn.exec(t),o=i.cur(),u=+o||0,a=1,f=20;if(s){n=+s[2],r=s[3]||(v.cssNumber[e]?"":"px");if(r!=="px"&&u){u=v.css(i.elem,e,!0)||n||1;do a=a||".5",u/=a,v.style(i.elem,e,u+r);while(a!==(a=i.cur()/o)&&a!==1&&--f)}i.unit=r,i.start=u,i.end=s[1]?u+(s[1]+1)*n:n}return i}]};v.Animation=v.extend(Kn,{tweener:function(e,t){v.isFunction(e)?(t=e,e=["*"]):e=e.split(" ");var n,r=0,i=e.length;for(;r<i;r++)n=e[r],Vn[n]=Vn[n]||[],Vn[n].unshift(t)},prefilter:function(e,t){t?Xn.unshift(e):Xn.push(e)}}),v.Tween=Yn,Yn.prototype={constructor:Yn,init:function(e,t,n,r,i,s){this.elem=e,this.prop=n,this.easing=i||"swing",this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=s||(v.cssNumber[n]?"":"px")},cur:function(){var e=Yn.propHooks[this.prop];return e&&e.get?e.get(this):Yn.propHooks._default.get(this)},run:function(e){var t,n=Yn.propHooks[this.prop];return this.options.duration?this.pos=t=v.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):this.pos=t=e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):Yn.propHooks._default.set(this),this}},Yn.prototype.init.prototype=Yn.prototype,Yn.propHooks={_default:{get:function(e){var t;return e.elem[e.prop]==null||!!e.elem.style&&e.elem.style[e.prop]!=null?(t=v.css(e.elem,e.prop,!1,""),!t||t==="auto"?0:t):e.elem[e.prop]},set:function(e){v.fx.step[e.prop]?v.fx.step[e.prop](e):e.elem.style&&(e.elem.style[v.cssProps[e.prop]]!=null||v.cssHooks[e.prop])?v.style(e.elem,e.prop,e.now+e.unit):e.elem[e.prop]=e.now}}},Yn.propHooks.scrollTop=Yn.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},v.each(["toggle","show","hide"],function(e,t){var n=v.fn[t];v.fn[t]=function(r,i,s){return r==null||typeof r=="boolean"||!e&&v.isFunction(r)&&v.isFunction(i)?n.apply(this,arguments):this.animate(Zn(t,!0),r,i,s)}}),v.fn.extend({fadeTo:function(e,t,n,r){return this.filter(Gt).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(e,t,n,r){var i=v.isEmptyObject(e),s=v.speed(t,n,r),o=function(){var t=Kn(this,v.extend({},e),s);i&&t.stop(!0)};return i||s.queue===!1?this.each(o):this.queue(s.queue,o)},stop:function(e,n,r){var i=function(e){var t=e.stop;delete e.stop,t(r)};return typeof e!="string"&&(r=n,n=e,e=t),n&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,n=e!=null&&e+"queueHooks",s=v.timers,o=v._data(this);if(n)o[n]&&o[n].stop&&i(o[n]);else for(n in o)o[n]&&o[n].stop&&Wn.test(n)&&i(o[n]);for(n=s.length;n--;)s[n].elem===this&&(e==null||s[n].queue===e)&&(s[n].anim.stop(r),t=!1,s.splice(n,1));(t||!r)&&v.dequeue(this,e)})}}),v.each({slideDown:Zn("show"),slideUp:Zn("hide"),slideToggle:Zn("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,t){v.fn[e]=function(e,n,r){return this.animate(t,e,n,r)}}),v.speed=function(e,t,n){var r=e&&typeof e=="object"?v.extend({},e):{complete:n||!n&&t||v.isFunction(e)&&e,duration:e,easing:n&&t||t&&!v.isFunction(t)&&t};r.duration=v.fx.off?0:typeof r.duration=="number"?r.duration:r.duration in v.fx.speeds?v.fx.speeds[r.duration]:v.fx.speeds._default;if(r.queue==null||r.queue===!0)r.queue="fx";return r.old=r.complete,r.complete=function(){v.isFunction(r.old)&&r.old.call(this),r.queue&&v.dequeue(this,r.queue)},r},v.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2}},v.timers=[],v.fx=Yn.prototype.init,v.fx.tick=function(){var e,n=v.timers,r=0;qn=v.now();for(;r<n.length;r++)e=n[r],!e()&&n[r]===e&&n.splice(r--,1);n.length||v.fx.stop(),qn=t},v.fx.timer=function(e){e()&&v.timers.push(e)&&!Rn&&(Rn=setInterval(v.fx.tick,v.fx.interval))},v.fx.interval=13,v.fx.stop=function(){clearInterval(Rn),Rn=null},v.fx.speeds={slow:600,fast:200,_default:400},v.fx.step={},v.expr&&v.expr.filters&&(v.expr.filters.animated=function(e){return v.grep(v.timers,function(t){return e===t.elem}).length});var er=/^(?:body|html)$/i;v.fn.offset=function(e){if(arguments.length)return e===t?this:this.each(function(t){v.offset.setOffset(this,e,t)});var n,r,i,s,o,u,a,f={top:0,left:0},l=this[0],c=l&&l.ownerDocument;if(!c)return;return(r=c.body)===l?v.offset.bodyOffset(l):(n=c.documentElement,v.contains(n,l)?(typeof l.getBoundingClientRect!="undefined"&&(f=l.getBoundingClientRect()),i=tr(c),s=n.clientTop||r.clientTop||0,o=n.clientLeft||r.clientLeft||0,u=i.pageYOffset||n.scrollTop,a=i.pageXOffset||n.scrollLeft,{top:f.top+u-s,left:f.left+a-o}):f)},v.offset={bodyOffset:function(e){var t=e.offsetTop,n=e.offsetLeft;return v.support.doesNotIncludeMarginInBodyOffset&&(t+=parseFloat(v.css(e,"marginTop"))||0,n+=parseFloat(v.css(e,"marginLeft"))||0),{top:t,left:n}},setOffset:function(e,t,n){var r=v.css(e,"position");r==="static"&&(e.style.position="relative");var i=v(e),s=i.offset(),o=v.css(e,"top"),u=v.css(e,"left"),a=(r==="absolute"||r==="fixed")&&v.inArray("auto",[o,u])>-1,f={},l={},c,h;a?(l=i.position(),c=l.top,h=l.left):(c=parseFloat(o)||0,h=parseFloat(u)||0),v.isFunction(t)&&(t=t.call(e,n,s)),t.top!=null&&(f.top=t.top-s.top+c),t.left!=null&&(f.left=t.left-s.left+h),"using"in t?t.using.call(e,f):i.css(f)}},v.fn.extend({position:function(){if(!this[0])return;var e=this[0],t=this.offsetParent(),n=this.offset(),r=er.test(t[0].nodeName)?{top:0,left:0}:t.offset();return n.top-=parseFloat(v.css(e,"marginTop"))||0,n.left-=parseFloat(v.css(e,"marginLeft"))||0,r.top+=parseFloat(v.css(t[0],"borderTopWidth"))||0,r.left+=parseFloat(v.css(t[0],"borderLeftWidth"))||0,{top:n.top-r.top,left:n.left-r.left}},offsetParent:function(){return this.map(function(){var e=this.offsetParent||i.body;while(e&&!er.test(e.nodeName)&&v.css(e,"position")==="static")e=e.offsetParent;return e||i.body})}}),v.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,n){var r=/Y/.test(n);v.fn[e]=function(i){return v.access(this,function(e,i,s){var o=tr(e);if(s===t)return o?n in o?o[n]:o.document.documentElement[i]:e[i];o?o.scrollTo(r?v(o).scrollLeft():s,r?s:v(o).scrollTop()):e[i]=s},e,i,arguments.length,null)}}),v.each({Height:"height",Width:"width"},function(e,n){v.each({padding:"inner"+e,content:n,"":"outer"+e},function(r,i){v.fn[i]=function(i,s){var o=arguments.length&&(r||typeof i!="boolean"),u=r||(i===!0||s===!0?"margin":"border");return v.access(this,function(n,r,i){var s;return v.isWindow(n)?n.document.documentElement["client"+e]:n.nodeType===9?(s=n.documentElement,Math.max(n.body["scroll"+e],s["scroll"+e],n.body["offset"+e],s["offset"+e],s["client"+e])):i===t?v.css(n,r,i,u):v.style(n,r,i,u)},n,o?i:t,o,null)}})}),e.jQuery=e.$=v,typeof define=="function"&&define.amd&&define.amd.jQuery&&define("jquery",[],function(){return v})})(window);
\ No newline at end of file
Binary file components/jansson/doc/html/_static/minus.png has changed
Binary file components/jansson/doc/html/_static/plus.png has changed
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/pygments.css Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,62 @@
+.highlight .hll { background-color: #ffffcc }
+.highlight { background: #eeffcc; }
+.highlight .c { color: #408090; font-style: italic } /* Comment */
+.highlight .err { border: 1px solid #FF0000 } /* Error */
+.highlight .k { color: #007020; font-weight: bold } /* Keyword */
+.highlight .o { color: #666666 } /* Operator */
+.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */
+.highlight .cp { color: #007020 } /* Comment.Preproc */
+.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */
+.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */
+.highlight .gd { color: #A00000 } /* Generic.Deleted */
+.highlight .ge { font-style: italic } /* Generic.Emph */
+.highlight .gr { color: #FF0000 } /* Generic.Error */
+.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */
+.highlight .gi { color: #00A000 } /* Generic.Inserted */
+.highlight .go { color: #333333 } /* Generic.Output */
+.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */
+.highlight .gs { font-weight: bold } /* Generic.Strong */
+.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */
+.highlight .gt { color: #0044DD } /* Generic.Traceback */
+.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */
+.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */
+.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */
+.highlight .kp { color: #007020 } /* Keyword.Pseudo */
+.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */
+.highlight .kt { color: #902000 } /* Keyword.Type */
+.highlight .m { color: #208050 } /* Literal.Number */
+.highlight .s { color: #4070a0 } /* Literal.String */
+.highlight .na { color: #4070a0 } /* Name.Attribute */
+.highlight .nb { color: #007020 } /* Name.Builtin */
+.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */
+.highlight .no { color: #60add5 } /* Name.Constant */
+.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */
+.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */
+.highlight .ne { color: #007020 } /* Name.Exception */
+.highlight .nf { color: #06287e } /* Name.Function */
+.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */
+.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */
+.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */
+.highlight .nv { color: #bb60d5 } /* Name.Variable */
+.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */
+.highlight .w { color: #bbbbbb } /* Text.Whitespace */
+.highlight .mf { color: #208050 } /* Literal.Number.Float */
+.highlight .mh { color: #208050 } /* Literal.Number.Hex */
+.highlight .mi { color: #208050 } /* Literal.Number.Integer */
+.highlight .mo { color: #208050 } /* Literal.Number.Oct */
+.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */
+.highlight .sc { color: #4070a0 } /* Literal.String.Char */
+.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */
+.highlight .s2 { color: #4070a0 } /* Literal.String.Double */
+.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */
+.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */
+.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */
+.highlight .sx { color: #c65d09 } /* Literal.String.Other */
+.highlight .sr { color: #235388 } /* Literal.String.Regex */
+.highlight .s1 { color: #4070a0 } /* Literal.String.Single */
+.highlight .ss { color: #517918 } /* Literal.String.Symbol */
+.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */
+.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */
+.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */
+.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */
+.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/searchtools.js Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,622 @@
+/*
+ * searchtools.js_t
+ * ~~~~~~~~~~~~~~~~
+ *
+ * Sphinx JavaScript utilties for the full-text search.
+ *
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+
+/**
+ * Porter Stemmer
+ */
+var Stemmer = function() {
+
+ var step2list = {
+ ational: 'ate',
+ tional: 'tion',
+ enci: 'ence',
+ anci: 'ance',
+ izer: 'ize',
+ bli: 'ble',
+ alli: 'al',
+ entli: 'ent',
+ eli: 'e',
+ ousli: 'ous',
+ ization: 'ize',
+ ation: 'ate',
+ ator: 'ate',
+ alism: 'al',
+ iveness: 'ive',
+ fulness: 'ful',
+ ousness: 'ous',
+ aliti: 'al',
+ iviti: 'ive',
+ biliti: 'ble',
+ logi: 'log'
+ };
+
+ var step3list = {
+ icate: 'ic',
+ ative: '',
+ alize: 'al',
+ iciti: 'ic',
+ ical: 'ic',
+ ful: '',
+ ness: ''
+ };
+
+ var c = "[^aeiou]"; // consonant
+ var v = "[aeiouy]"; // vowel
+ var C = c + "[^aeiouy]*"; // consonant sequence
+ var V = v + "[aeiou]*"; // vowel sequence
+
+ var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0
+ var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1
+ var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1
+ var s_v = "^(" + C + ")?" + v; // vowel in stem
+
+ this.stemWord = function (w) {
+ var stem;
+ var suffix;
+ var firstch;
+ var origword = w;
+
+ if (w.length < 3)
+ return w;
+
+ var re;
+ var re2;
+ var re3;
+ var re4;
+
+ firstch = w.substr(0,1);
+ if (firstch == "y")
+ w = firstch.toUpperCase() + w.substr(1);
+
+ // Step 1a
+ re = /^(.+?)(ss|i)es$/;
+ re2 = /^(.+?)([^s])s$/;
+
+ if (re.test(w))
+ w = w.replace(re,"$1$2");
+ else if (re2.test(w))
+ w = w.replace(re2,"$1$2");
+
+ // Step 1b
+ re = /^(.+?)eed$/;
+ re2 = /^(.+?)(ed|ing)$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ re = new RegExp(mgr0);
+ if (re.test(fp[1])) {
+ re = /.$/;
+ w = w.replace(re,"");
+ }
+ }
+ else if (re2.test(w)) {
+ var fp = re2.exec(w);
+ stem = fp[1];
+ re2 = new RegExp(s_v);
+ if (re2.test(stem)) {
+ w = stem;
+ re2 = /(at|bl|iz)$/;
+ re3 = new RegExp("([^aeiouylsz])\\1$");
+ re4 = new RegExp("^" + C + v + "[^aeiouwxy]$");
+ if (re2.test(w))
+ w = w + "e";
+ else if (re3.test(w)) {
+ re = /.$/;
+ w = w.replace(re,"");
+ }
+ else if (re4.test(w))
+ w = w + "e";
+ }
+ }
+
+ // Step 1c
+ re = /^(.+?)y$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ re = new RegExp(s_v);
+ if (re.test(stem))
+ w = stem + "i";
+ }
+
+ // Step 2
+ re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ suffix = fp[2];
+ re = new RegExp(mgr0);
+ if (re.test(stem))
+ w = stem + step2list[suffix];
+ }
+
+ // Step 3
+ re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ suffix = fp[2];
+ re = new RegExp(mgr0);
+ if (re.test(stem))
+ w = stem + step3list[suffix];
+ }
+
+ // Step 4
+ re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;
+ re2 = /^(.+?)(s|t)(ion)$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ re = new RegExp(mgr1);
+ if (re.test(stem))
+ w = stem;
+ }
+ else if (re2.test(w)) {
+ var fp = re2.exec(w);
+ stem = fp[1] + fp[2];
+ re2 = new RegExp(mgr1);
+ if (re2.test(stem))
+ w = stem;
+ }
+
+ // Step 5
+ re = /^(.+?)e$/;
+ if (re.test(w)) {
+ var fp = re.exec(w);
+ stem = fp[1];
+ re = new RegExp(mgr1);
+ re2 = new RegExp(meq1);
+ re3 = new RegExp("^" + C + v + "[^aeiouwxy]$");
+ if (re.test(stem) || (re2.test(stem) && !(re3.test(stem))))
+ w = stem;
+ }
+ re = /ll$/;
+ re2 = new RegExp(mgr1);
+ if (re.test(w) && re2.test(w)) {
+ re = /.$/;
+ w = w.replace(re,"");
+ }
+
+ // and turn initial Y back to y
+ if (firstch == "y")
+ w = firstch.toLowerCase() + w.substr(1);
+ return w;
+ }
+}
+
+
+
+/**
+ * Simple result scoring code.
+ */
+var Scorer = {
+ // Implement the following function to further tweak the score for each result
+ // The function takes a result array [filename, title, anchor, descr, score]
+ // and returns the new score.
+ /*
+ score: function(result) {
+ return result[4];
+ },
+ */
+
+ // query matches the full name of an object
+ objNameMatch: 11,
+ // or matches in the last dotted part of the object name
+ objPartialMatch: 6,
+ // Additive scores depending on the priority of the object
+ objPrio: {0: 15, // used to be importantResults
+ 1: 5, // used to be objectResults
+ 2: -5}, // used to be unimportantResults
+ // Used when the priority is not in the mapping.
+ objPrioDefault: 0,
+
+ // query found in title
+ title: 15,
+ // query found in terms
+ term: 5
+};
+
+
+/**
+ * Search Module
+ */
+var Search = {
+
+ _index : null,
+ _queued_query : null,
+ _pulse_status : -1,
+
+ init : function() {
+ var params = $.getQueryParameters();
+ if (params.q) {
+ var query = params.q[0];
+ $('input[name="q"]')[0].value = query;
+ this.performSearch(query);
+ }
+ },
+
+ loadIndex : function(url) {
+ $.ajax({type: "GET", url: url, data: null,
+ dataType: "script", cache: true,
+ complete: function(jqxhr, textstatus) {
+ if (textstatus != "success") {
+ document.getElementById("searchindexloader").src = url;
+ }
+ }});
+ },
+
+ setIndex : function(index) {
+ var q;
+ this._index = index;
+ if ((q = this._queued_query) !== null) {
+ this._queued_query = null;
+ Search.query(q);
+ }
+ },
+
+ hasIndex : function() {
+ return this._index !== null;
+ },
+
+ deferQuery : function(query) {
+ this._queued_query = query;
+ },
+
+ stopPulse : function() {
+ this._pulse_status = 0;
+ },
+
+ startPulse : function() {
+ if (this._pulse_status >= 0)
+ return;
+ function pulse() {
+ var i;
+ Search._pulse_status = (Search._pulse_status + 1) % 4;
+ var dotString = '';
+ for (i = 0; i < Search._pulse_status; i++)
+ dotString += '.';
+ Search.dots.text(dotString);
+ if (Search._pulse_status > -1)
+ window.setTimeout(pulse, 500);
+ }
+ pulse();
+ },
+
+ /**
+ * perform a search for something (or wait until index is loaded)
+ */
+ performSearch : function(query) {
+ // create the required interface elements
+ this.out = $('#search-results');
+ this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out);
+ this.dots = $('<span></span>').appendTo(this.title);
+ this.status = $('<p style="display: none"></p>').appendTo(this.out);
+ this.output = $('<ul class="search"/>').appendTo(this.out);
+
+ $('#search-progress').text(_('Preparing search...'));
+ this.startPulse();
+
+ // index already loaded, the browser was quick!
+ if (this.hasIndex())
+ this.query(query);
+ else
+ this.deferQuery(query);
+ },
+
+ /**
+ * execute search (requires search index to be loaded)
+ */
+ query : function(query) {
+ var i;
+ var stopwords = ["a","and","are","as","at","be","but","by","for","if","in","into","is","it","near","no","not","of","on","or","such","that","the","their","then","there","these","they","this","to","was","will","with"];
+
+ // stem the searchterms and add them to the correct list
+ var stemmer = new Stemmer();
+ var searchterms = [];
+ var excluded = [];
+ var hlterms = [];
+ var tmp = query.split(/\s+/);
+ var objectterms = [];
+ for (i = 0; i < tmp.length; i++) {
+ if (tmp[i] !== "") {
+ objectterms.push(tmp[i].toLowerCase());
+ }
+
+ if ($u.indexOf(stopwords, tmp[i].toLowerCase()) != -1 || tmp[i].match(/^\d+$/) ||
+ tmp[i] === "") {
+ // skip this "word"
+ continue;
+ }
+ // stem the word
+ var word = stemmer.stemWord(tmp[i].toLowerCase());
+ var toAppend;
+ // select the correct list
+ if (word[0] == '-') {
+ toAppend = excluded;
+ word = word.substr(1);
+ }
+ else {
+ toAppend = searchterms;
+ hlterms.push(tmp[i].toLowerCase());
+ }
+ // only add if not already in the list
+ if (!$u.contains(toAppend, word))
+ toAppend.push(word);
+ }
+ var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" "));
+
+ // console.debug('SEARCH: searching for:');
+ // console.info('required: ', searchterms);
+ // console.info('excluded: ', excluded);
+
+ // prepare search
+ var terms = this._index.terms;
+ var titleterms = this._index.titleterms;
+
+ // array of [filename, title, anchor, descr, score]
+ var results = [];
+ $('#search-progress').empty();
+
+ // lookup as object
+ for (i = 0; i < objectterms.length; i++) {
+ var others = [].concat(objectterms.slice(0, i),
+ objectterms.slice(i+1, objectterms.length));
+ results = results.concat(this.performObjectSearch(objectterms[i], others));
+ }
+
+ // lookup as search terms in fulltext
+ results = results.concat(this.performTermsSearch(searchterms, excluded, terms, Scorer.term))
+ .concat(this.performTermsSearch(searchterms, excluded, titleterms, Scorer.title));
+
+ // let the scorer override scores with a custom scoring function
+ if (Scorer.score) {
+ for (i = 0; i < results.length; i++)
+ results[i][4] = Scorer.score(results[i]);
+ }
+
+ // now sort the results by score (in opposite order of appearance, since the
+ // display function below uses pop() to retrieve items) and then
+ // alphabetically
+ results.sort(function(a, b) {
+ var left = a[4];
+ var right = b[4];
+ if (left > right) {
+ return 1;
+ } else if (left < right) {
+ return -1;
+ } else {
+ // same score: sort alphabetically
+ left = a[1].toLowerCase();
+ right = b[1].toLowerCase();
+ return (left > right) ? -1 : ((left < right) ? 1 : 0);
+ }
+ });
+
+ // for debugging
+ //Search.lastresults = results.slice(); // a copy
+ //console.info('search results:', Search.lastresults);
+
+ // print the results
+ var resultCount = results.length;
+ function displayNextItem() {
+ // results left, load the summary and display it
+ if (results.length) {
+ var item = results.pop();
+ var listItem = $('<li style="display:none"></li>');
+ if (DOCUMENTATION_OPTIONS.FILE_SUFFIX === '') {
+ // dirhtml builder
+ var dirname = item[0] + '/';
+ if (dirname.match(/\/index\/$/)) {
+ dirname = dirname.substring(0, dirname.length-6);
+ } else if (dirname == 'index/') {
+ dirname = '';
+ }
+ listItem.append($('<a/>').attr('href',
+ DOCUMENTATION_OPTIONS.URL_ROOT + dirname +
+ highlightstring + item[2]).html(item[1]));
+ } else {
+ // normal html builders
+ listItem.append($('<a/>').attr('href',
+ item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX +
+ highlightstring + item[2]).html(item[1]));
+ }
+ if (item[3]) {
+ listItem.append($('<span> (' + item[3] + ')</span>'));
+ Search.output.append(listItem);
+ listItem.slideDown(5, function() {
+ displayNextItem();
+ });
+ } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) {
+ $.ajax({url: DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + item[0] + '.txt',
+ dataType: "text",
+ complete: function(jqxhr, textstatus) {
+ var data = jqxhr.responseText;
+ if (data !== '') {
+ listItem.append(Search.makeSearchSummary(data, searchterms, hlterms));
+ }
+ Search.output.append(listItem);
+ listItem.slideDown(5, function() {
+ displayNextItem();
+ });
+ }});
+ } else {
+ // no source available, just display title
+ Search.output.append(listItem);
+ listItem.slideDown(5, function() {
+ displayNextItem();
+ });
+ }
+ }
+ // search finished, update title and status message
+ else {
+ Search.stopPulse();
+ Search.title.text(_('Search Results'));
+ if (!resultCount)
+ Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.'));
+ else
+ Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount));
+ Search.status.fadeIn(500);
+ }
+ }
+ displayNextItem();
+ },
+
+ /**
+ * search for object names
+ */
+ performObjectSearch : function(object, otherterms) {
+ var filenames = this._index.filenames;
+ var objects = this._index.objects;
+ var objnames = this._index.objnames;
+ var titles = this._index.titles;
+
+ var i;
+ var results = [];
+
+ for (var prefix in objects) {
+ for (var name in objects[prefix]) {
+ var fullname = (prefix ? prefix + '.' : '') + name;
+ if (fullname.toLowerCase().indexOf(object) > -1) {
+ var score = 0;
+ var parts = fullname.split('.');
+ // check for different match types: exact matches of full name or
+ // "last name" (i.e. last dotted part)
+ if (fullname == object || parts[parts.length - 1] == object) {
+ score += Scorer.objNameMatch;
+ // matches in last name
+ } else if (parts[parts.length - 1].indexOf(object) > -1) {
+ score += Scorer.objPartialMatch;
+ }
+ var match = objects[prefix][name];
+ var objname = objnames[match[1]][2];
+ var title = titles[match[0]];
+ // If more than one term searched for, we require other words to be
+ // found in the name/title/description
+ if (otherterms.length > 0) {
+ var haystack = (prefix + ' ' + name + ' ' +
+ objname + ' ' + title).toLowerCase();
+ var allfound = true;
+ for (i = 0; i < otherterms.length; i++) {
+ if (haystack.indexOf(otherterms[i]) == -1) {
+ allfound = false;
+ break;
+ }
+ }
+ if (!allfound) {
+ continue;
+ }
+ }
+ var descr = objname + _(', in ') + title;
+
+ var anchor = match[3];
+ if (anchor === '')
+ anchor = fullname;
+ else if (anchor == '-')
+ anchor = objnames[match[1]][1] + '-' + fullname;
+ // add custom score for some objects according to scorer
+ if (Scorer.objPrio.hasOwnProperty(match[2])) {
+ score += Scorer.objPrio[match[2]];
+ } else {
+ score += Scorer.objPrioDefault;
+ }
+ results.push([filenames[match[0]], fullname, '#'+anchor, descr, score]);
+ }
+ }
+ }
+
+ return results;
+ },
+
+ /**
+ * search for full-text terms in the index
+ */
+ performTermsSearch : function(searchterms, excluded, terms, score) {
+ var filenames = this._index.filenames;
+ var titles = this._index.titles;
+
+ var i, j, file, files;
+ var fileMap = {};
+ var results = [];
+
+ // perform the search on the required terms
+ for (i = 0; i < searchterms.length; i++) {
+ var word = searchterms[i];
+ // no match but word was a required one
+ if ((files = terms[word]) === undefined)
+ break;
+ if (files.length === undefined) {
+ files = [files];
+ }
+ // create the mapping
+ for (j = 0; j < files.length; j++) {
+ file = files[j];
+ if (file in fileMap)
+ fileMap[file].push(word);
+ else
+ fileMap[file] = [word];
+ }
+ }
+
+ // now check if the files don't contain excluded terms
+ for (file in fileMap) {
+ var valid = true;
+
+ // check if all requirements are matched
+ if (fileMap[file].length != searchterms.length)
+ continue;
+
+ // ensure that none of the excluded terms is in the search result
+ for (i = 0; i < excluded.length; i++) {
+ if (terms[excluded[i]] == file ||
+ $u.contains(terms[excluded[i]] || [], file)) {
+ valid = false;
+ break;
+ }
+ }
+
+ // if we have still a valid result we can add it to the result list
+ if (valid) {
+ results.push([filenames[file], titles[file], '', null, score]);
+ }
+ }
+ return results;
+ },
+
+ /**
+ * helper function to return a node containing the
+ * search summary for a given text. keywords is a list
+ * of stemmed words, hlwords is the list of normal, unstemmed
+ * words. the first one is used to find the occurance, the
+ * latter for highlighting it.
+ */
+ makeSearchSummary : function(text, keywords, hlwords) {
+ var textLower = text.toLowerCase();
+ var start = 0;
+ $.each(keywords, function() {
+ var i = textLower.indexOf(this.toLowerCase());
+ if (i > -1)
+ start = i;
+ });
+ start = Math.max(start - 120, 0);
+ var excerpt = ((start > 0) ? '...' : '') +
+ $.trim(text.substr(start, 240)) +
+ ((start + 240 - text.length) ? '...' : '');
+ var rv = $('<div class="context"></div>').text(excerpt);
+ $.each(hlwords, function() {
+ rv = rv.highlightText(this, 'highlighted');
+ });
+ return rv;
+ }
+};
+
+$(document).ready(function() {
+ Search.init();
+});
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/sidebar.js Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,159 @@
+/*
+ * sidebar.js
+ * ~~~~~~~~~~
+ *
+ * This script makes the Sphinx sidebar collapsible.
+ *
+ * .sphinxsidebar contains .sphinxsidebarwrapper. This script adds
+ * in .sphixsidebar, after .sphinxsidebarwrapper, the #sidebarbutton
+ * used to collapse and expand the sidebar.
+ *
+ * When the sidebar is collapsed the .sphinxsidebarwrapper is hidden
+ * and the width of the sidebar and the margin-left of the document
+ * are decreased. When the sidebar is expanded the opposite happens.
+ * This script saves a per-browser/per-session cookie used to
+ * remember the position of the sidebar among the pages.
+ * Once the browser is closed the cookie is deleted and the position
+ * reset to the default (expanded).
+ *
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+$(function() {
+
+
+
+
+
+
+
+
+ // global elements used by the functions.
+ // the 'sidebarbutton' element is defined as global after its
+ // creation, in the add_sidebar_button function
+ var bodywrapper = $('.bodywrapper');
+ var sidebar = $('.sphinxsidebar');
+ var sidebarwrapper = $('.sphinxsidebarwrapper');
+
+ // for some reason, the document has no sidebar; do not run into errors
+ if (!sidebar.length) return;
+
+ // original margin-left of the bodywrapper and width of the sidebar
+ // with the sidebar expanded
+ var bw_margin_expanded = bodywrapper.css('margin-left');
+ var ssb_width_expanded = sidebar.width();
+
+ // margin-left of the bodywrapper and width of the sidebar
+ // with the sidebar collapsed
+ var bw_margin_collapsed = '.8em';
+ var ssb_width_collapsed = '.8em';
+
+ // colors used by the current theme
+ var dark_color = $('.related').css('background-color');
+ var light_color = $('.document').css('background-color');
+
+ function sidebar_is_collapsed() {
+ return sidebarwrapper.is(':not(:visible)');
+ }
+
+ function toggle_sidebar() {
+ if (sidebar_is_collapsed())
+ expand_sidebar();
+ else
+ collapse_sidebar();
+ }
+
+ function collapse_sidebar() {
+ sidebarwrapper.hide();
+ sidebar.css('width', ssb_width_collapsed);
+ bodywrapper.css('margin-left', bw_margin_collapsed);
+ sidebarbutton.css({
+ 'margin-left': '0',
+ 'height': bodywrapper.height()
+ });
+ sidebarbutton.find('span').text('»');
+ sidebarbutton.attr('title', _('Expand sidebar'));
+ document.cookie = 'sidebar=collapsed';
+ }
+
+ function expand_sidebar() {
+ bodywrapper.css('margin-left', bw_margin_expanded);
+ sidebar.css('width', ssb_width_expanded);
+ sidebarwrapper.show();
+ sidebarbutton.css({
+ 'margin-left': ssb_width_expanded-12,
+ 'height': bodywrapper.height()
+ });
+ sidebarbutton.find('span').text('«');
+ sidebarbutton.attr('title', _('Collapse sidebar'));
+ document.cookie = 'sidebar=expanded';
+ }
+
+ function add_sidebar_button() {
+ sidebarwrapper.css({
+ 'float': 'left',
+ 'margin-right': '0',
+ 'width': ssb_width_expanded - 28
+ });
+ // create the button
+ sidebar.append(
+ '<div id="sidebarbutton"><span>«</span></div>'
+ );
+ var sidebarbutton = $('#sidebarbutton');
+ light_color = sidebarbutton.css('background-color');
+ // find the height of the viewport to center the '<<' in the page
+ var viewport_height;
+ if (window.innerHeight)
+ viewport_height = window.innerHeight;
+ else
+ viewport_height = $(window).height();
+ sidebarbutton.find('span').css({
+ 'display': 'block',
+ 'margin-top': (viewport_height - sidebar.position().top - 20) / 2
+ });
+
+ sidebarbutton.click(toggle_sidebar);
+ sidebarbutton.attr('title', _('Collapse sidebar'));
+ sidebarbutton.css({
+ 'color': '#FFFFFF',
+ 'border-left': '1px solid ' + dark_color,
+ 'font-size': '1.2em',
+ 'cursor': 'pointer',
+ 'height': bodywrapper.height(),
+ 'padding-top': '1px',
+ 'margin-left': ssb_width_expanded - 12
+ });
+
+ sidebarbutton.hover(
+ function () {
+ $(this).css('background-color', dark_color);
+ },
+ function () {
+ $(this).css('background-color', light_color);
+ }
+ );
+ }
+
+ function set_position_from_cookie() {
+ if (!document.cookie)
+ return;
+ var items = document.cookie.split(';');
+ for(var k=0; k<items.length; k++) {
+ var key_val = items[k].split('=');
+ var key = key_val[0].replace(/ /, ""); // strip leading spaces
+ if (key == 'sidebar') {
+ var value = key_val[1];
+ if ((value == 'collapsed') && (!sidebar_is_collapsed()))
+ collapse_sidebar();
+ else if ((value == 'expanded') && (sidebar_is_collapsed()))
+ expand_sidebar();
+ }
+ }
+ }
+
+ add_sidebar_button();
+ var sidebarbutton = $('#sidebarbutton');
+ set_position_from_cookie();
+});
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/underscore.js Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,31 @@
+// Underscore.js 1.3.1
+// (c) 2009-2012 Jeremy Ashkenas, DocumentCloud Inc.
+// Underscore is freely distributable under the MIT license.
+// Portions of Underscore are inspired or borrowed from Prototype,
+// Oliver Steele's Functional, and John Resig's Micro-Templating.
+// For all details and documentation:
+// http://documentcloud.github.com/underscore
+(function(){function q(a,c,d){if(a===c)return a!==0||1/a==1/c;if(a==null||c==null)return a===c;if(a._chain)a=a._wrapped;if(c._chain)c=c._wrapped;if(a.isEqual&&b.isFunction(a.isEqual))return a.isEqual(c);if(c.isEqual&&b.isFunction(c.isEqual))return c.isEqual(a);var e=l.call(a);if(e!=l.call(c))return false;switch(e){case "[object String]":return a==String(c);case "[object Number]":return a!=+a?c!=+c:a==0?1/a==1/c:a==+c;case "[object Date]":case "[object Boolean]":return+a==+c;case "[object RegExp]":return a.source==
+c.source&&a.global==c.global&&a.multiline==c.multiline&&a.ignoreCase==c.ignoreCase}if(typeof a!="object"||typeof c!="object")return false;for(var f=d.length;f--;)if(d[f]==a)return true;d.push(a);var f=0,g=true;if(e=="[object Array]"){if(f=a.length,g=f==c.length)for(;f--;)if(!(g=f in a==f in c&&q(a[f],c[f],d)))break}else{if("constructor"in a!="constructor"in c||a.constructor!=c.constructor)return false;for(var h in a)if(b.has(a,h)&&(f++,!(g=b.has(c,h)&&q(a[h],c[h],d))))break;if(g){for(h in c)if(b.has(c,
+h)&&!f--)break;g=!f}}d.pop();return g}var r=this,G=r._,n={},k=Array.prototype,o=Object.prototype,i=k.slice,H=k.unshift,l=o.toString,I=o.hasOwnProperty,w=k.forEach,x=k.map,y=k.reduce,z=k.reduceRight,A=k.filter,B=k.every,C=k.some,p=k.indexOf,D=k.lastIndexOf,o=Array.isArray,J=Object.keys,s=Function.prototype.bind,b=function(a){return new m(a)};if(typeof exports!=="undefined"){if(typeof module!=="undefined"&&module.exports)exports=module.exports=b;exports._=b}else r._=b;b.VERSION="1.3.1";var j=b.each=
+b.forEach=function(a,c,d){if(a!=null)if(w&&a.forEach===w)a.forEach(c,d);else if(a.length===+a.length)for(var e=0,f=a.length;e<f;e++){if(e in a&&c.call(d,a[e],e,a)===n)break}else for(e in a)if(b.has(a,e)&&c.call(d,a[e],e,a)===n)break};b.map=b.collect=function(a,c,b){var e=[];if(a==null)return e;if(x&&a.map===x)return a.map(c,b);j(a,function(a,g,h){e[e.length]=c.call(b,a,g,h)});if(a.length===+a.length)e.length=a.length;return e};b.reduce=b.foldl=b.inject=function(a,c,d,e){var f=arguments.length>2;a==
+null&&(a=[]);if(y&&a.reduce===y)return e&&(c=b.bind(c,e)),f?a.reduce(c,d):a.reduce(c);j(a,function(a,b,i){f?d=c.call(e,d,a,b,i):(d=a,f=true)});if(!f)throw new TypeError("Reduce of empty array with no initial value");return d};b.reduceRight=b.foldr=function(a,c,d,e){var f=arguments.length>2;a==null&&(a=[]);if(z&&a.reduceRight===z)return e&&(c=b.bind(c,e)),f?a.reduceRight(c,d):a.reduceRight(c);var g=b.toArray(a).reverse();e&&!f&&(c=b.bind(c,e));return f?b.reduce(g,c,d,e):b.reduce(g,c)};b.find=b.detect=
+function(a,c,b){var e;E(a,function(a,g,h){if(c.call(b,a,g,h))return e=a,true});return e};b.filter=b.select=function(a,c,b){var e=[];if(a==null)return e;if(A&&a.filter===A)return a.filter(c,b);j(a,function(a,g,h){c.call(b,a,g,h)&&(e[e.length]=a)});return e};b.reject=function(a,c,b){var e=[];if(a==null)return e;j(a,function(a,g,h){c.call(b,a,g,h)||(e[e.length]=a)});return e};b.every=b.all=function(a,c,b){var e=true;if(a==null)return e;if(B&&a.every===B)return a.every(c,b);j(a,function(a,g,h){if(!(e=
+e&&c.call(b,a,g,h)))return n});return e};var E=b.some=b.any=function(a,c,d){c||(c=b.identity);var e=false;if(a==null)return e;if(C&&a.some===C)return a.some(c,d);j(a,function(a,b,h){if(e||(e=c.call(d,a,b,h)))return n});return!!e};b.include=b.contains=function(a,c){var b=false;if(a==null)return b;return p&&a.indexOf===p?a.indexOf(c)!=-1:b=E(a,function(a){return a===c})};b.invoke=function(a,c){var d=i.call(arguments,2);return b.map(a,function(a){return(b.isFunction(c)?c||a:a[c]).apply(a,d)})};b.pluck=
+function(a,c){return b.map(a,function(a){return a[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a))return Math.max.apply(Math,a);if(!c&&b.isEmpty(a))return-Infinity;var e={computed:-Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b>=e.computed&&(e={value:a,computed:b})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);if(!c&&b.isEmpty(a))return Infinity;var e={computed:Infinity};j(a,function(a,b,h){b=c?c.call(d,a,b,h):a;b<e.computed&&(e={value:a,computed:b})});
+return e.value};b.shuffle=function(a){var b=[],d;j(a,function(a,f){f==0?b[0]=a:(d=Math.floor(Math.random()*(f+1)),b[f]=b[d],b[d]=a)});return b};b.sortBy=function(a,c,d){return b.pluck(b.map(a,function(a,b,g){return{value:a,criteria:c.call(d,a,b,g)}}).sort(function(a,b){var c=a.criteria,d=b.criteria;return c<d?-1:c>d?1:0}),"value")};b.groupBy=function(a,c){var d={},e=b.isFunction(c)?c:function(a){return a[c]};j(a,function(a,b){var c=e(a,b);(d[c]||(d[c]=[])).push(a)});return d};b.sortedIndex=function(a,
+c,d){d||(d=b.identity);for(var e=0,f=a.length;e<f;){var g=e+f>>1;d(a[g])<d(c)?e=g+1:f=g}return e};b.toArray=function(a){return!a?[]:a.toArray?a.toArray():b.isArray(a)?i.call(a):b.isArguments(a)?i.call(a):b.values(a)};b.size=function(a){return b.toArray(a).length};b.first=b.head=function(a,b,d){return b!=null&&!d?i.call(a,0,b):a[0]};b.initial=function(a,b,d){return i.call(a,0,a.length-(b==null||d?1:b))};b.last=function(a,b,d){return b!=null&&!d?i.call(a,Math.max(a.length-b,0)):a[a.length-1]};b.rest=
+b.tail=function(a,b,d){return i.call(a,b==null||d?1:b)};b.compact=function(a){return b.filter(a,function(a){return!!a})};b.flatten=function(a,c){return b.reduce(a,function(a,e){if(b.isArray(e))return a.concat(c?e:b.flatten(e));a[a.length]=e;return a},[])};b.without=function(a){return b.difference(a,i.call(arguments,1))};b.uniq=b.unique=function(a,c,d){var d=d?b.map(a,d):a,e=[];b.reduce(d,function(d,g,h){if(0==h||(c===true?b.last(d)!=g:!b.include(d,g)))d[d.length]=g,e[e.length]=a[h];return d},[]);
+return e};b.union=function(){return b.uniq(b.flatten(arguments,true))};b.intersection=b.intersect=function(a){var c=i.call(arguments,1);return b.filter(b.uniq(a),function(a){return b.every(c,function(c){return b.indexOf(c,a)>=0})})};b.difference=function(a){var c=b.flatten(i.call(arguments,1));return b.filter(a,function(a){return!b.include(c,a)})};b.zip=function(){for(var a=i.call(arguments),c=b.max(b.pluck(a,"length")),d=Array(c),e=0;e<c;e++)d[e]=b.pluck(a,""+e);return d};b.indexOf=function(a,c,
+d){if(a==null)return-1;var e;if(d)return d=b.sortedIndex(a,c),a[d]===c?d:-1;if(p&&a.indexOf===p)return a.indexOf(c);for(d=0,e=a.length;d<e;d++)if(d in a&&a[d]===c)return d;return-1};b.lastIndexOf=function(a,b){if(a==null)return-1;if(D&&a.lastIndexOf===D)return a.lastIndexOf(b);for(var d=a.length;d--;)if(d in a&&a[d]===b)return d;return-1};b.range=function(a,b,d){arguments.length<=1&&(b=a||0,a=0);for(var d=arguments[2]||1,e=Math.max(Math.ceil((b-a)/d),0),f=0,g=Array(e);f<e;)g[f++]=a,a+=d;return g};
+var F=function(){};b.bind=function(a,c){var d,e;if(a.bind===s&&s)return s.apply(a,i.call(arguments,1));if(!b.isFunction(a))throw new TypeError;e=i.call(arguments,2);return d=function(){if(!(this instanceof d))return a.apply(c,e.concat(i.call(arguments)));F.prototype=a.prototype;var b=new F,g=a.apply(b,e.concat(i.call(arguments)));return Object(g)===g?g:b}};b.bindAll=function(a){var c=i.call(arguments,1);c.length==0&&(c=b.functions(a));j(c,function(c){a[c]=b.bind(a[c],a)});return a};b.memoize=function(a,
+c){var d={};c||(c=b.identity);return function(){var e=c.apply(this,arguments);return b.has(d,e)?d[e]:d[e]=a.apply(this,arguments)}};b.delay=function(a,b){var d=i.call(arguments,2);return setTimeout(function(){return a.apply(a,d)},b)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(i.call(arguments,1)))};b.throttle=function(a,c){var d,e,f,g,h,i=b.debounce(function(){h=g=false},c);return function(){d=this;e=arguments;var b;f||(f=setTimeout(function(){f=null;h&&a.apply(d,e);i()},c));g?h=true:
+a.apply(d,e);i();g=true}};b.debounce=function(a,b){var d;return function(){var e=this,f=arguments;clearTimeout(d);d=setTimeout(function(){d=null;a.apply(e,f)},b)}};b.once=function(a){var b=false,d;return function(){if(b)return d;b=true;return d=a.apply(this,arguments)}};b.wrap=function(a,b){return function(){var d=[a].concat(i.call(arguments,0));return b.apply(this,d)}};b.compose=function(){var a=arguments;return function(){for(var b=arguments,d=a.length-1;d>=0;d--)b=[a[d].apply(this,b)];return b[0]}};
+b.after=function(a,b){return a<=0?b():function(){if(--a<1)return b.apply(this,arguments)}};b.keys=J||function(a){if(a!==Object(a))throw new TypeError("Invalid object");var c=[],d;for(d in a)b.has(a,d)&&(c[c.length]=d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=b.methods=function(a){var c=[],d;for(d in a)b.isFunction(a[d])&&c.push(d);return c.sort()};b.extend=function(a){j(i.call(arguments,1),function(b){for(var d in b)a[d]=b[d]});return a};b.defaults=function(a){j(i.call(arguments,
+1),function(b){for(var d in b)a[d]==null&&(a[d]=b[d])});return a};b.clone=function(a){return!b.isObject(a)?a:b.isArray(a)?a.slice():b.extend({},a)};b.tap=function(a,b){b(a);return a};b.isEqual=function(a,b){return q(a,b,[])};b.isEmpty=function(a){if(b.isArray(a)||b.isString(a))return a.length===0;for(var c in a)if(b.has(a,c))return false;return true};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=o||function(a){return l.call(a)=="[object Array]"};b.isObject=function(a){return a===Object(a)};
+b.isArguments=function(a){return l.call(a)=="[object Arguments]"};if(!b.isArguments(arguments))b.isArguments=function(a){return!(!a||!b.has(a,"callee"))};b.isFunction=function(a){return l.call(a)=="[object Function]"};b.isString=function(a){return l.call(a)=="[object String]"};b.isNumber=function(a){return l.call(a)=="[object Number]"};b.isNaN=function(a){return a!==a};b.isBoolean=function(a){return a===true||a===false||l.call(a)=="[object Boolean]"};b.isDate=function(a){return l.call(a)=="[object Date]"};
+b.isRegExp=function(a){return l.call(a)=="[object RegExp]"};b.isNull=function(a){return a===null};b.isUndefined=function(a){return a===void 0};b.has=function(a,b){return I.call(a,b)};b.noConflict=function(){r._=G;return this};b.identity=function(a){return a};b.times=function(a,b,d){for(var e=0;e<a;e++)b.call(d,e)};b.escape=function(a){return(""+a).replace(/&/g,"&").replace(/</g,"<").replace(/>/g,">").replace(/"/g,""").replace(/'/g,"'").replace(/\//g,"/")};b.mixin=function(a){j(b.functions(a),
+function(c){K(c,b[c]=a[c])})};var L=0;b.uniqueId=function(a){var b=L++;return a?a+b:b};b.templateSettings={evaluate:/<%([\s\S]+?)%>/g,interpolate:/<%=([\s\S]+?)%>/g,escape:/<%-([\s\S]+?)%>/g};var t=/.^/,u=function(a){return a.replace(/\\\\/g,"\\").replace(/\\'/g,"'")};b.template=function(a,c){var d=b.templateSettings,d="var __p=[],print=function(){__p.push.apply(__p,arguments);};with(obj||{}){__p.push('"+a.replace(/\\/g,"\\\\").replace(/'/g,"\\'").replace(d.escape||t,function(a,b){return"',_.escape("+
+u(b)+"),'"}).replace(d.interpolate||t,function(a,b){return"',"+u(b)+",'"}).replace(d.evaluate||t,function(a,b){return"');"+u(b).replace(/[\r\n\t]/g," ")+";__p.push('"}).replace(/\r/g,"\\r").replace(/\n/g,"\\n").replace(/\t/g,"\\t")+"');}return __p.join('');",e=new Function("obj","_",d);return c?e(c,b):function(a){return e.call(this,a,b)}};b.chain=function(a){return b(a).chain()};var m=function(a){this._wrapped=a};b.prototype=m.prototype;var v=function(a,c){return c?b(a).chain():a},K=function(a,c){m.prototype[a]=
+function(){var a=i.call(arguments);H.call(a,this._wrapped);return v(c.apply(b,a),this._chain)}};b.mixin(b);j("pop,push,reverse,shift,sort,splice,unshift".split(","),function(a){var b=k[a];m.prototype[a]=function(){var d=this._wrapped;b.apply(d,arguments);var e=d.length;(a=="shift"||a=="splice")&&e===0&&delete d[0];return v(d,this._chain)}});j(["concat","join","slice"],function(a){var b=k[a];m.prototype[a]=function(){return v(b.apply(this._wrapped,arguments),this._chain)}});m.prototype.chain=function(){this._chain=
+true;return this};m.prototype.value=function(){return this._wrapped}}).call(this);
Binary file components/jansson/doc/html/_static/up-pressed.png has changed
Binary file components/jansson/doc/html/_static/up.png has changed
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/_static/websupport.js Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,808 @@
+/*
+ * websupport.js
+ * ~~~~~~~~~~~~~
+ *
+ * sphinx.websupport utilties for all documentation.
+ *
+ * :copyright: Copyright 2007-2014 by the Sphinx team, see AUTHORS.
+ * :license: BSD, see LICENSE for details.
+ *
+ */
+
+(function($) {
+ $.fn.autogrow = function() {
+ return this.each(function() {
+ var textarea = this;
+
+ $.fn.autogrow.resize(textarea);
+
+ $(textarea)
+ .focus(function() {
+ textarea.interval = setInterval(function() {
+ $.fn.autogrow.resize(textarea);
+ }, 500);
+ })
+ .blur(function() {
+ clearInterval(textarea.interval);
+ });
+ });
+ };
+
+ $.fn.autogrow.resize = function(textarea) {
+ var lineHeight = parseInt($(textarea).css('line-height'), 10);
+ var lines = textarea.value.split('\n');
+ var columns = textarea.cols;
+ var lineCount = 0;
+ $.each(lines, function() {
+ lineCount += Math.ceil(this.length / columns) || 1;
+ });
+ var height = lineHeight * (lineCount + 1);
+ $(textarea).css('height', height);
+ };
+})(jQuery);
+
+(function($) {
+ var comp, by;
+
+ function init() {
+ initEvents();
+ initComparator();
+ }
+
+ function initEvents() {
+ $('a.comment-close').live("click", function(event) {
+ event.preventDefault();
+ hide($(this).attr('id').substring(2));
+ });
+ $('a.vote').live("click", function(event) {
+ event.preventDefault();
+ handleVote($(this));
+ });
+ $('a.reply').live("click", function(event) {
+ event.preventDefault();
+ openReply($(this).attr('id').substring(2));
+ });
+ $('a.close-reply').live("click", function(event) {
+ event.preventDefault();
+ closeReply($(this).attr('id').substring(2));
+ });
+ $('a.sort-option').live("click", function(event) {
+ event.preventDefault();
+ handleReSort($(this));
+ });
+ $('a.show-proposal').live("click", function(event) {
+ event.preventDefault();
+ showProposal($(this).attr('id').substring(2));
+ });
+ $('a.hide-proposal').live("click", function(event) {
+ event.preventDefault();
+ hideProposal($(this).attr('id').substring(2));
+ });
+ $('a.show-propose-change').live("click", function(event) {
+ event.preventDefault();
+ showProposeChange($(this).attr('id').substring(2));
+ });
+ $('a.hide-propose-change').live("click", function(event) {
+ event.preventDefault();
+ hideProposeChange($(this).attr('id').substring(2));
+ });
+ $('a.accept-comment').live("click", function(event) {
+ event.preventDefault();
+ acceptComment($(this).attr('id').substring(2));
+ });
+ $('a.delete-comment').live("click", function(event) {
+ event.preventDefault();
+ deleteComment($(this).attr('id').substring(2));
+ });
+ $('a.comment-markup').live("click", function(event) {
+ event.preventDefault();
+ toggleCommentMarkupBox($(this).attr('id').substring(2));
+ });
+ }
+
+ /**
+ * Set comp, which is a comparator function used for sorting and
+ * inserting comments into the list.
+ */
+ function setComparator() {
+ // If the first three letters are "asc", sort in ascending order
+ // and remove the prefix.
+ if (by.substring(0,3) == 'asc') {
+ var i = by.substring(3);
+ comp = function(a, b) { return a[i] - b[i]; };
+ } else {
+ // Otherwise sort in descending order.
+ comp = function(a, b) { return b[by] - a[by]; };
+ }
+
+ // Reset link styles and format the selected sort option.
+ $('a.sel').attr('href', '#').removeClass('sel');
+ $('a.by' + by).removeAttr('href').addClass('sel');
+ }
+
+ /**
+ * Create a comp function. If the user has preferences stored in
+ * the sortBy cookie, use those, otherwise use the default.
+ */
+ function initComparator() {
+ by = 'rating'; // Default to sort by rating.
+ // If the sortBy cookie is set, use that instead.
+ if (document.cookie.length > 0) {
+ var start = document.cookie.indexOf('sortBy=');
+ if (start != -1) {
+ start = start + 7;
+ var end = document.cookie.indexOf(";", start);
+ if (end == -1) {
+ end = document.cookie.length;
+ by = unescape(document.cookie.substring(start, end));
+ }
+ }
+ }
+ setComparator();
+ }
+
+ /**
+ * Show a comment div.
+ */
+ function show(id) {
+ $('#ao' + id).hide();
+ $('#ah' + id).show();
+ var context = $.extend({id: id}, opts);
+ var popup = $(renderTemplate(popupTemplate, context)).hide();
+ popup.find('textarea[name="proposal"]').hide();
+ popup.find('a.by' + by).addClass('sel');
+ var form = popup.find('#cf' + id);
+ form.submit(function(event) {
+ event.preventDefault();
+ addComment(form);
+ });
+ $('#s' + id).after(popup);
+ popup.slideDown('fast', function() {
+ getComments(id);
+ });
+ }
+
+ /**
+ * Hide a comment div.
+ */
+ function hide(id) {
+ $('#ah' + id).hide();
+ $('#ao' + id).show();
+ var div = $('#sc' + id);
+ div.slideUp('fast', function() {
+ div.remove();
+ });
+ }
+
+ /**
+ * Perform an ajax request to get comments for a node
+ * and insert the comments into the comments tree.
+ */
+ function getComments(id) {
+ $.ajax({
+ type: 'GET',
+ url: opts.getCommentsURL,
+ data: {node: id},
+ success: function(data, textStatus, request) {
+ var ul = $('#cl' + id);
+ var speed = 100;
+ $('#cf' + id)
+ .find('textarea[name="proposal"]')
+ .data('source', data.source);
+
+ if (data.comments.length === 0) {
+ ul.html('<li>No comments yet.</li>');
+ ul.data('empty', true);
+ } else {
+ // If there are comments, sort them and put them in the list.
+ var comments = sortComments(data.comments);
+ speed = data.comments.length * 100;
+ appendComments(comments, ul);
+ ul.data('empty', false);
+ }
+ $('#cn' + id).slideUp(speed + 200);
+ ul.slideDown(speed);
+ },
+ error: function(request, textStatus, error) {
+ showError('Oops, there was a problem retrieving the comments.');
+ },
+ dataType: 'json'
+ });
+ }
+
+ /**
+ * Add a comment via ajax and insert the comment into the comment tree.
+ */
+ function addComment(form) {
+ var node_id = form.find('input[name="node"]').val();
+ var parent_id = form.find('input[name="parent"]').val();
+ var text = form.find('textarea[name="comment"]').val();
+ var proposal = form.find('textarea[name="proposal"]').val();
+
+ if (text == '') {
+ showError('Please enter a comment.');
+ return;
+ }
+
+ // Disable the form that is being submitted.
+ form.find('textarea,input').attr('disabled', 'disabled');
+
+ // Send the comment to the server.
+ $.ajax({
+ type: "POST",
+ url: opts.addCommentURL,
+ dataType: 'json',
+ data: {
+ node: node_id,
+ parent: parent_id,
+ text: text,
+ proposal: proposal
+ },
+ success: function(data, textStatus, error) {
+ // Reset the form.
+ if (node_id) {
+ hideProposeChange(node_id);
+ }
+ form.find('textarea')
+ .val('')
+ .add(form.find('input'))
+ .removeAttr('disabled');
+ var ul = $('#cl' + (node_id || parent_id));
+ if (ul.data('empty')) {
+ $(ul).empty();
+ ul.data('empty', false);
+ }
+ insertComment(data.comment);
+ var ao = $('#ao' + node_id);
+ ao.find('img').attr({'src': opts.commentBrightImage});
+ if (node_id) {
+ // if this was a "root" comment, remove the commenting box
+ // (the user can get it back by reopening the comment popup)
+ $('#ca' + node_id).slideUp();
+ }
+ },
+ error: function(request, textStatus, error) {
+ form.find('textarea,input').removeAttr('disabled');
+ showError('Oops, there was a problem adding the comment.');
+ }
+ });
+ }
+
+ /**
+ * Recursively append comments to the main comment list and children
+ * lists, creating the comment tree.
+ */
+ function appendComments(comments, ul) {
+ $.each(comments, function() {
+ var div = createCommentDiv(this);
+ ul.append($(document.createElement('li')).html(div));
+ appendComments(this.children, div.find('ul.comment-children'));
+ // To avoid stagnating data, don't store the comments children in data.
+ this.children = null;
+ div.data('comment', this);
+ });
+ }
+
+ /**
+ * After adding a new comment, it must be inserted in the correct
+ * location in the comment tree.
+ */
+ function insertComment(comment) {
+ var div = createCommentDiv(comment);
+
+ // To avoid stagnating data, don't store the comments children in data.
+ comment.children = null;
+ div.data('comment', comment);
+
+ var ul = $('#cl' + (comment.node || comment.parent));
+ var siblings = getChildren(ul);
+
+ var li = $(document.createElement('li'));
+ li.hide();
+
+ // Determine where in the parents children list to insert this comment.
+ for(i=0; i < siblings.length; i++) {
+ if (comp(comment, siblings[i]) <= 0) {
+ $('#cd' + siblings[i].id)
+ .parent()
+ .before(li.html(div));
+ li.slideDown('fast');
+ return;
+ }
+ }
+
+ // If we get here, this comment rates lower than all the others,
+ // or it is the only comment in the list.
+ ul.append(li.html(div));
+ li.slideDown('fast');
+ }
+
+ function acceptComment(id) {
+ $.ajax({
+ type: 'POST',
+ url: opts.acceptCommentURL,
+ data: {id: id},
+ success: function(data, textStatus, request) {
+ $('#cm' + id).fadeOut('fast');
+ $('#cd' + id).removeClass('moderate');
+ },
+ error: function(request, textStatus, error) {
+ showError('Oops, there was a problem accepting the comment.');
+ }
+ });
+ }
+
+ function deleteComment(id) {
+ $.ajax({
+ type: 'POST',
+ url: opts.deleteCommentURL,
+ data: {id: id},
+ success: function(data, textStatus, request) {
+ var div = $('#cd' + id);
+ if (data == 'delete') {
+ // Moderator mode: remove the comment and all children immediately
+ div.slideUp('fast', function() {
+ div.remove();
+ });
+ return;
+ }
+ // User mode: only mark the comment as deleted
+ div
+ .find('span.user-id:first')
+ .text('[deleted]').end()
+ .find('div.comment-text:first')
+ .text('[deleted]').end()
+ .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id +
+ ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id)
+ .remove();
+ var comment = div.data('comment');
+ comment.username = '[deleted]';
+ comment.text = '[deleted]';
+ div.data('comment', comment);
+ },
+ error: function(request, textStatus, error) {
+ showError('Oops, there was a problem deleting the comment.');
+ }
+ });
+ }
+
+ function showProposal(id) {
+ $('#sp' + id).hide();
+ $('#hp' + id).show();
+ $('#pr' + id).slideDown('fast');
+ }
+
+ function hideProposal(id) {
+ $('#hp' + id).hide();
+ $('#sp' + id).show();
+ $('#pr' + id).slideUp('fast');
+ }
+
+ function showProposeChange(id) {
+ $('#pc' + id).hide();
+ $('#hc' + id).show();
+ var textarea = $('#pt' + id);
+ textarea.val(textarea.data('source'));
+ $.fn.autogrow.resize(textarea[0]);
+ textarea.slideDown('fast');
+ }
+
+ function hideProposeChange(id) {
+ $('#hc' + id).hide();
+ $('#pc' + id).show();
+ var textarea = $('#pt' + id);
+ textarea.val('').removeAttr('disabled');
+ textarea.slideUp('fast');
+ }
+
+ function toggleCommentMarkupBox(id) {
+ $('#mb' + id).toggle();
+ }
+
+ /** Handle when the user clicks on a sort by link. */
+ function handleReSort(link) {
+ var classes = link.attr('class').split(/\s+/);
+ for (var i=0; i<classes.length; i++) {
+ if (classes[i] != 'sort-option') {
+ by = classes[i].substring(2);
+ }
+ }
+ setComparator();
+ // Save/update the sortBy cookie.
+ var expiration = new Date();
+ expiration.setDate(expiration.getDate() + 365);
+ document.cookie= 'sortBy=' + escape(by) +
+ ';expires=' + expiration.toUTCString();
+ $('ul.comment-ul').each(function(index, ul) {
+ var comments = getChildren($(ul), true);
+ comments = sortComments(comments);
+ appendComments(comments, $(ul).empty());
+ });
+ }
+
+ /**
+ * Function to process a vote when a user clicks an arrow.
+ */
+ function handleVote(link) {
+ if (!opts.voting) {
+ showError("You'll need to login to vote.");
+ return;
+ }
+
+ var id = link.attr('id');
+ if (!id) {
+ // Didn't click on one of the voting arrows.
+ return;
+ }
+ // If it is an unvote, the new vote value is 0,
+ // Otherwise it's 1 for an upvote, or -1 for a downvote.
+ var value = 0;
+ if (id.charAt(1) != 'u') {
+ value = id.charAt(0) == 'u' ? 1 : -1;
+ }
+ // The data to be sent to the server.
+ var d = {
+ comment_id: id.substring(2),
+ value: value
+ };
+
+ // Swap the vote and unvote links.
+ link.hide();
+ $('#' + id.charAt(0) + (id.charAt(1) == 'u' ? 'v' : 'u') + d.comment_id)
+ .show();
+
+ // The div the comment is displayed in.
+ var div = $('div#cd' + d.comment_id);
+ var data = div.data('comment');
+
+ // If this is not an unvote, and the other vote arrow has
+ // already been pressed, unpress it.
+ if ((d.value !== 0) && (data.vote === d.value * -1)) {
+ $('#' + (d.value == 1 ? 'd' : 'u') + 'u' + d.comment_id).hide();
+ $('#' + (d.value == 1 ? 'd' : 'u') + 'v' + d.comment_id).show();
+ }
+
+ // Update the comments rating in the local data.
+ data.rating += (data.vote === 0) ? d.value : (d.value - data.vote);
+ data.vote = d.value;
+ div.data('comment', data);
+
+ // Change the rating text.
+ div.find('.rating:first')
+ .text(data.rating + ' point' + (data.rating == 1 ? '' : 's'));
+
+ // Send the vote information to the server.
+ $.ajax({
+ type: "POST",
+ url: opts.processVoteURL,
+ data: d,
+ error: function(request, textStatus, error) {
+ showError('Oops, there was a problem casting that vote.');
+ }
+ });
+ }
+
+ /**
+ * Open a reply form used to reply to an existing comment.
+ */
+ function openReply(id) {
+ // Swap out the reply link for the hide link
+ $('#rl' + id).hide();
+ $('#cr' + id).show();
+
+ // Add the reply li to the children ul.
+ var div = $(renderTemplate(replyTemplate, {id: id})).hide();
+ $('#cl' + id)
+ .prepend(div)
+ // Setup the submit handler for the reply form.
+ .find('#rf' + id)
+ .submit(function(event) {
+ event.preventDefault();
+ addComment($('#rf' + id));
+ closeReply(id);
+ })
+ .find('input[type=button]')
+ .click(function() {
+ closeReply(id);
+ });
+ div.slideDown('fast', function() {
+ $('#rf' + id).find('textarea').focus();
+ });
+ }
+
+ /**
+ * Close the reply form opened with openReply.
+ */
+ function closeReply(id) {
+ // Remove the reply div from the DOM.
+ $('#rd' + id).slideUp('fast', function() {
+ $(this).remove();
+ });
+
+ // Swap out the hide link for the reply link
+ $('#cr' + id).hide();
+ $('#rl' + id).show();
+ }
+
+ /**
+ * Recursively sort a tree of comments using the comp comparator.
+ */
+ function sortComments(comments) {
+ comments.sort(comp);
+ $.each(comments, function() {
+ this.children = sortComments(this.children);
+ });
+ return comments;
+ }
+
+ /**
+ * Get the children comments from a ul. If recursive is true,
+ * recursively include childrens' children.
+ */
+ function getChildren(ul, recursive) {
+ var children = [];
+ ul.children().children("[id^='cd']")
+ .each(function() {
+ var comment = $(this).data('comment');
+ if (recursive)
+ comment.children = getChildren($(this).find('#cl' + comment.id), true);
+ children.push(comment);
+ });
+ return children;
+ }
+
+ /** Create a div to display a comment in. */
+ function createCommentDiv(comment) {
+ if (!comment.displayed && !opts.moderator) {
+ return $('<div class="moderate">Thank you! Your comment will show up '
+ + 'once it is has been approved by a moderator.</div>');
+ }
+ // Prettify the comment rating.
+ comment.pretty_rating = comment.rating + ' point' +
+ (comment.rating == 1 ? '' : 's');
+ // Make a class (for displaying not yet moderated comments differently)
+ comment.css_class = comment.displayed ? '' : ' moderate';
+ // Create a div for this comment.
+ var context = $.extend({}, opts, comment);
+ var div = $(renderTemplate(commentTemplate, context));
+
+ // If the user has voted on this comment, highlight the correct arrow.
+ if (comment.vote) {
+ var direction = (comment.vote == 1) ? 'u' : 'd';
+ div.find('#' + direction + 'v' + comment.id).hide();
+ div.find('#' + direction + 'u' + comment.id).show();
+ }
+
+ if (opts.moderator || comment.text != '[deleted]') {
+ div.find('a.reply').show();
+ if (comment.proposal_diff)
+ div.find('#sp' + comment.id).show();
+ if (opts.moderator && !comment.displayed)
+ div.find('#cm' + comment.id).show();
+ if (opts.moderator || (opts.username == comment.username))
+ div.find('#dc' + comment.id).show();
+ }
+ return div;
+ }
+
+ /**
+ * A simple template renderer. Placeholders such as <%id%> are replaced
+ * by context['id'] with items being escaped. Placeholders such as <#id#>
+ * are not escaped.
+ */
+ function renderTemplate(template, context) {
+ var esc = $(document.createElement('div'));
+
+ function handle(ph, escape) {
+ var cur = context;
+ $.each(ph.split('.'), function() {
+ cur = cur[this];
+ });
+ return escape ? esc.text(cur || "").html() : cur;
+ }
+
+ return template.replace(/<([%#])([\w\.]*)\1>/g, function() {
+ return handle(arguments[2], arguments[1] == '%' ? true : false);
+ });
+ }
+
+ /** Flash an error message briefly. */
+ function showError(message) {
+ $(document.createElement('div')).attr({'class': 'popup-error'})
+ .append($(document.createElement('div'))
+ .attr({'class': 'error-message'}).text(message))
+ .appendTo('body')
+ .fadeIn("slow")
+ .delay(2000)
+ .fadeOut("slow");
+ }
+
+ /** Add a link the user uses to open the comments popup. */
+ $.fn.comment = function() {
+ return this.each(function() {
+ var id = $(this).attr('id').substring(1);
+ var count = COMMENT_METADATA[id];
+ var title = count + ' comment' + (count == 1 ? '' : 's');
+ var image = count > 0 ? opts.commentBrightImage : opts.commentImage;
+ var addcls = count == 0 ? ' nocomment' : '';
+ $(this)
+ .append(
+ $(document.createElement('a')).attr({
+ href: '#',
+ 'class': 'sphinx-comment-open' + addcls,
+ id: 'ao' + id
+ })
+ .append($(document.createElement('img')).attr({
+ src: image,
+ alt: 'comment',
+ title: title
+ }))
+ .click(function(event) {
+ event.preventDefault();
+ show($(this).attr('id').substring(2));
+ })
+ )
+ .append(
+ $(document.createElement('a')).attr({
+ href: '#',
+ 'class': 'sphinx-comment-close hidden',
+ id: 'ah' + id
+ })
+ .append($(document.createElement('img')).attr({
+ src: opts.closeCommentImage,
+ alt: 'close',
+ title: 'close'
+ }))
+ .click(function(event) {
+ event.preventDefault();
+ hide($(this).attr('id').substring(2));
+ })
+ );
+ });
+ };
+
+ var opts = {
+ processVoteURL: '/_process_vote',
+ addCommentURL: '/_add_comment',
+ getCommentsURL: '/_get_comments',
+ acceptCommentURL: '/_accept_comment',
+ deleteCommentURL: '/_delete_comment',
+ commentImage: '/static/_static/comment.png',
+ closeCommentImage: '/static/_static/comment-close.png',
+ loadingImage: '/static/_static/ajax-loader.gif',
+ commentBrightImage: '/static/_static/comment-bright.png',
+ upArrow: '/static/_static/up.png',
+ downArrow: '/static/_static/down.png',
+ upArrowPressed: '/static/_static/up-pressed.png',
+ downArrowPressed: '/static/_static/down-pressed.png',
+ voting: false,
+ moderator: false
+ };
+
+ if (typeof COMMENT_OPTIONS != "undefined") {
+ opts = jQuery.extend(opts, COMMENT_OPTIONS);
+ }
+
+ var popupTemplate = '\
+ <div class="sphinx-comments" id="sc<%id%>">\
+ <p class="sort-options">\
+ Sort by:\
+ <a href="#" class="sort-option byrating">best rated</a>\
+ <a href="#" class="sort-option byascage">newest</a>\
+ <a href="#" class="sort-option byage">oldest</a>\
+ </p>\
+ <div class="comment-header">Comments</div>\
+ <div class="comment-loading" id="cn<%id%>">\
+ loading comments... <img src="<%loadingImage%>" alt="" /></div>\
+ <ul id="cl<%id%>" class="comment-ul"></ul>\
+ <div id="ca<%id%>">\
+ <p class="add-a-comment">Add a comment\
+ (<a href="#" class="comment-markup" id="ab<%id%>">markup</a>):</p>\
+ <div class="comment-markup-box" id="mb<%id%>">\
+ reStructured text markup: <i>*emph*</i>, <b>**strong**</b>, \
+ <tt>``code``</tt>, \
+ code blocks: <tt>::</tt> and an indented block after blank line</div>\
+ <form method="post" id="cf<%id%>" class="comment-form" action="">\
+ <textarea name="comment" cols="80"></textarea>\
+ <p class="propose-button">\
+ <a href="#" id="pc<%id%>" class="show-propose-change">\
+ Propose a change ▹\
+ </a>\
+ <a href="#" id="hc<%id%>" class="hide-propose-change">\
+ Propose a change ▿\
+ </a>\
+ </p>\
+ <textarea name="proposal" id="pt<%id%>" cols="80"\
+ spellcheck="false"></textarea>\
+ <input type="submit" value="Add comment" />\
+ <input type="hidden" name="node" value="<%id%>" />\
+ <input type="hidden" name="parent" value="" />\
+ </form>\
+ </div>\
+ </div>';
+
+ var commentTemplate = '\
+ <div id="cd<%id%>" class="sphinx-comment<%css_class%>">\
+ <div class="vote">\
+ <div class="arrow">\
+ <a href="#" id="uv<%id%>" class="vote" title="vote up">\
+ <img src="<%upArrow%>" />\
+ </a>\
+ <a href="#" id="uu<%id%>" class="un vote" title="vote up">\
+ <img src="<%upArrowPressed%>" />\
+ </a>\
+ </div>\
+ <div class="arrow">\
+ <a href="#" id="dv<%id%>" class="vote" title="vote down">\
+ <img src="<%downArrow%>" id="da<%id%>" />\
+ </a>\
+ <a href="#" id="du<%id%>" class="un vote" title="vote down">\
+ <img src="<%downArrowPressed%>" />\
+ </a>\
+ </div>\
+ </div>\
+ <div class="comment-content">\
+ <p class="tagline comment">\
+ <span class="user-id"><%username%></span>\
+ <span class="rating"><%pretty_rating%></span>\
+ <span class="delta"><%time.delta%></span>\
+ </p>\
+ <div class="comment-text comment"><#text#></div>\
+ <p class="comment-opts comment">\
+ <a href="#" class="reply hidden" id="rl<%id%>">reply ▹</a>\
+ <a href="#" class="close-reply" id="cr<%id%>">reply ▿</a>\
+ <a href="#" id="sp<%id%>" class="show-proposal">proposal ▹</a>\
+ <a href="#" id="hp<%id%>" class="hide-proposal">proposal ▿</a>\
+ <a href="#" id="dc<%id%>" class="delete-comment hidden">delete</a>\
+ <span id="cm<%id%>" class="moderation hidden">\
+ <a href="#" id="ac<%id%>" class="accept-comment">accept</a>\
+ </span>\
+ </p>\
+ <pre class="proposal" id="pr<%id%>">\
+<#proposal_diff#>\
+ </pre>\
+ <ul class="comment-children" id="cl<%id%>"></ul>\
+ </div>\
+ <div class="clearleft"></div>\
+ </div>\
+ </div>';
+
+ var replyTemplate = '\
+ <li>\
+ <div class="reply-div" id="rd<%id%>">\
+ <form id="rf<%id%>">\
+ <textarea name="comment" cols="80"></textarea>\
+ <input type="submit" value="Add reply" />\
+ <input type="button" value="Cancel" />\
+ <input type="hidden" name="parent" value="<%id%>" />\
+ <input type="hidden" name="node" value="" />\
+ </form>\
+ </div>\
+ </li>';
+
+ $(document).ready(function() {
+ init();
+ });
+})(jQuery);
+
+$(document).ready(function() {
+ // add comment anchors for all paragraphs that are commentable
+ $('.sphinx-has-comment').comment();
+
+ // highlight search words in search results
+ $("div.context").each(function() {
+ var params = $.getQueryParameters();
+ var terms = (params.q) ? params.q[0].split(/\s+/) : [];
+ var result = $(this);
+ $.each(terms, function() {
+ result.highlightText(this.toLowerCase(), 'highlighted');
+ });
+ });
+
+ // directly open comment window if requested
+ var anchor = document.location.hash;
+ if (anchor.substring(0, 9) == '#comment-') {
+ $('#ao' + anchor.substring(9)).click();
+ document.location.hash = '#s' + anchor.substring(9);
+ }
+});
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/apiref.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,1785 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>API Reference — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ <link rel="next" title="Changes in Jansson" href="changes.html" />
+ <link rel="prev" title="Portability" href="portability.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="changes.html" title="Changes in Jansson"
+ accesskey="N">next</a> |</li>
+ <li class="right" >
+ <a href="portability.html" title="Portability"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="api-reference">
+<span id="apiref"></span><h1>API Reference<a class="headerlink" href="#api-reference" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="preliminaries">
+<h2>Preliminaries<a class="headerlink" href="#preliminaries" title="Permalink to this headline">¶</a></h2>
+<p>All declarations are in <tt class="file docutils literal"><span class="pre">jansson.h</span></tt>, so it’s enough to</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cp">#include <jansson.h></span>
+</pre></div>
+</div>
+<p>in each source file.</p>
+<p>All constants are prefixed with <tt class="docutils literal"><span class="pre">JSON_</span></tt> (except for those describing
+the library version, prefixed with <tt class="docutils literal"><span class="pre">JANSSON_</span></tt>). Other identifiers
+are prefixed with <tt class="docutils literal"><span class="pre">json_</span></tt>. Type names are suffixed with <tt class="docutils literal"><span class="pre">_t</span></tt> and
+<tt class="docutils literal"><span class="pre">typedef</span></tt>‘d so that the <tt class="docutils literal"><span class="pre">struct</span></tt> keyword need not be used.</p>
+</div>
+<div class="section" id="library-version">
+<h2>Library Version<a class="headerlink" href="#library-version" title="Permalink to this headline">¶</a></h2>
+<p>The Jansson version is of the form <em>A.B.C</em>, where <em>A</em> is the major
+version, <em>B</em> is the minor version and <em>C</em> is the micro version. If the
+micro version is zero, it’s omitted from the version string, i.e. the
+version string is just <em>A.B</em>.</p>
+<p>When a new release only fixes bugs and doesn’t add new features or
+functionality, the micro version is incremented. When new features are
+added in a backwards compatible way, the minor version is incremented
+and the micro version is set to zero. When there are backwards
+incompatible changes, the major version is incremented and others are
+set to zero.</p>
+<p>The following preprocessor constants specify the current version of
+the library:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">JANSSON_MAJOR_VERSION</span></tt>, <tt class="docutils literal"><span class="pre">JANSSON_MINOR_VERSION</span></tt>, <tt class="docutils literal"><span class="pre">JANSSON_MICRO_VERSION</span></tt></dt>
+<dd>Integers specifying the major, minor and micro versions,
+respectively.</dd>
+<dt><tt class="docutils literal"><span class="pre">JANSSON_VERSION</span></tt></dt>
+<dd>A string representation of the current version, e.g. <tt class="docutils literal"><span class="pre">"1.2.1"</span></tt> or
+<tt class="docutils literal"><span class="pre">"1.3"</span></tt>.</dd>
+<dt><tt class="docutils literal"><span class="pre">JANSSON_VERSION_HEX</span></tt></dt>
+<dd><p class="first">A 3-byte hexadecimal representation of the version, e.g.
+<tt class="docutils literal"><span class="pre">0x010201</span></tt> for version 1.2.1 and <tt class="docutils literal"><span class="pre">0x010300</span></tt> for version 1.3.
+This is useful in numeric comparisions, e.g.:</p>
+<div class="last highlight-c"><div class="highlight"><pre><span class="cp">#if JANSSON_VERSION_HEX >= 0x010300</span>
+<span class="cm">/* Code specific to version 1.3 and above */</span>
+<span class="cp">#endif</span>
+</pre></div>
+</div>
+</dd>
+</dl>
+</div>
+<div class="section" id="value-representation">
+<h2>Value Representation<a class="headerlink" href="#value-representation" title="Permalink to this headline">¶</a></h2>
+<p>The JSON specification (<span class="target" id="index-0"></span><a class="rfc reference external" href="http://tools.ietf.org/html/rfc4627.html"><strong>RFC 4627</strong></a>) defines the following data types:
+<em>object</em>, <em>array</em>, <em>string</em>, <em>number</em>, <em>boolean</em>, and <em>null</em>. JSON
+types are used dynamically; arrays and objects can hold any other data
+type, including themselves. For this reason, Jansson’s type system is
+also dynamic in nature. There’s one C type to represent all JSON
+values, and this structure knows the type of the JSON value it holds.</p>
+<dl class="type">
+<dt id="c.json_t">
+<tt class="descname">json_t</tt><a class="headerlink" href="#c.json_t" title="Permalink to this definition">¶</a></dt>
+<dd><p>This data structure is used throughout the library to represent all
+JSON values. It always contains the type of the JSON value it holds
+and the value’s reference count. The rest depends on the type of the
+value.</p>
+</dd></dl>
+
+<p>Objects of <a class="reference internal" href="#c.json_t" title="json_t"><tt class="xref c c-type docutils literal"><span class="pre">json_t</span></tt></a> are always used through a pointer. There
+are APIs for querying the type, manipulating the reference count, and
+for constructing and manipulating values of different types.</p>
+<p>Unless noted otherwise, all API functions return an error value if an
+error occurs. Depending on the function’s signature, the error value
+is either <em>NULL</em> or -1. Invalid arguments or invalid input are
+apparent sources for errors. Memory allocation and I/O operations may
+also cause errors.</p>
+<div class="section" id="type">
+<h3>Type<a class="headerlink" href="#type" title="Permalink to this headline">¶</a></h3>
+<p>The type of a JSON value is queried and tested using the following
+functions:</p>
+<dl class="type">
+<dt id="c.json_type">
+enum <tt class="descname">json_type</tt><a class="headerlink" href="#c.json_type" title="Permalink to this definition">¶</a></dt>
+<dd><p>The type of a JSON value. The following members are defined:</p>
+<table border="1" class="docutils">
+<colgroup>
+<col width="100%" />
+</colgroup>
+<tbody valign="top">
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">JSON_OBJECT</span></tt></td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">JSON_ARRAY</span></tt></td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">JSON_STRING</span></tt></td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">JSON_INTEGER</span></tt></td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">JSON_REAL</span></tt></td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">JSON_TRUE</span></tt></td>
+</tr>
+<tr class="row-odd"><td><tt class="docutils literal"><span class="pre">JSON_FALSE</span></tt></td>
+</tr>
+<tr class="row-even"><td><tt class="docutils literal"><span class="pre">JSON_NULL</span></tt></td>
+</tr>
+</tbody>
+</table>
+<p>These correspond to JSON object, array, string, number, boolean and
+null. A number is represented by either a value of the type
+<tt class="docutils literal"><span class="pre">JSON_INTEGER</span></tt> or of the type <tt class="docutils literal"><span class="pre">JSON_REAL</span></tt>. A true boolean value
+is represented by a value of the type <tt class="docutils literal"><span class="pre">JSON_TRUE</span></tt> and false by a
+value of the type <tt class="docutils literal"><span class="pre">JSON_FALSE</span></tt>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_typeof">
+int <tt class="descname">json_typeof</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_typeof" title="Permalink to this definition">¶</a></dt>
+<dd><p>Return the type of the JSON value (a <a class="reference internal" href="#c.json_type" title="json_type"><tt class="xref c c-type docutils literal"><span class="pre">json_type</span></tt></a> cast to
+<tt class="xref c c-type docutils literal"><span class="pre">int</span></tt>). <em>json</em> MUST NOT be <em>NULL</em>. This function is actually
+implemented as a macro for speed.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_is_object">
+<tt class="descname">json_is_object</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_object" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_is_array">
+<tt class="descname">json_is_array</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_array" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_is_string">
+<tt class="descname">json_is_string</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_string" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_is_integer">
+<tt class="descname">json_is_integer</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_integer" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_is_real">
+<tt class="descname">json_is_real</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_real" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_is_true">
+<tt class="descname">json_is_true</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_true" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_is_false">
+<tt class="descname">json_is_false</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_false" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_is_null">
+<tt class="descname">json_is_null</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_null" title="Permalink to this definition">¶</a></dt>
+<dd><p>These functions (actually macros) return true (non-zero) for values
+of the given type, and false (zero) for values of other types and
+for <em>NULL</em>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_is_number">
+<tt class="descname">json_is_number</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_number" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns true for values of types <tt class="docutils literal"><span class="pre">JSON_INTEGER</span></tt> and
+<tt class="docutils literal"><span class="pre">JSON_REAL</span></tt>, and false for other types and for <em>NULL</em>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_is_boolean">
+<tt class="descname">json_is_boolean</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_is_boolean" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns true for types <tt class="docutils literal"><span class="pre">JSON_TRUE</span></tt> and <tt class="docutils literal"><span class="pre">JSON_FALSE</span></tt>, and false
+for values of other types and for <em>NULL</em>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_boolean_value">
+<tt class="descname">json_boolean_value</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_boolean_value" title="Permalink to this definition">¶</a></dt>
+<dd><p>Alias of <a class="reference internal" href="#c.json_is_true" title="json_is_true"><tt class="xref c c-func docutils literal"><span class="pre">json_is_true()</span></tt></a>, i.e. returns 1 for <tt class="docutils literal"><span class="pre">JSON_TRUE</span></tt>
+and 0 otherwise.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.7.</span></p>
+</div>
+</dd></dl>
+
+</div>
+<div class="section" id="reference-count">
+<span id="apiref-reference-count"></span><h3>Reference Count<a class="headerlink" href="#reference-count" title="Permalink to this headline">¶</a></h3>
+<p>The reference count is used to track whether a value is still in use
+or not. When a value is created, it’s reference count is set to 1. If
+a reference to a value is kept (e.g. a value is stored somewhere for
+later use), its reference count is incremented, and when the value is
+no longer needed, the reference count is decremented. When the
+reference count drops to zero, there are no references left, and the
+value can be destroyed.</p>
+<p>The following functions are used to manipulate the reference count.</p>
+<dl class="function">
+<dt id="c.json_incref">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_incref</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_incref" title="Permalink to this definition">¶</a></dt>
+<dd><p>Increment the reference count of <em>json</em> if it’s not <em>NULL</em>.
+Returns <em>json</em>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_decref">
+void <tt class="descname">json_decref</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_decref" title="Permalink to this definition">¶</a></dt>
+<dd><p>Decrement the reference count of <em>json</em>. As soon as a call to
+<a class="reference internal" href="#c.json_decref" title="json_decref"><tt class="xref c c-func docutils literal"><span class="pre">json_decref()</span></tt></a> drops the reference count to zero, the value
+is destroyed and it can no longer be used.</p>
+</dd></dl>
+
+<p>Functions creating new JSON values set the reference count to 1. These
+functions are said to return a <strong>new reference</strong>. Other functions
+returning (existing) JSON values do not normally increase the
+reference count. These functions are said to return a <strong>borrowed
+reference</strong>. So, if the user will hold a reference to a value returned
+as a borrowed reference, he must call <a class="reference internal" href="#c.json_incref" title="json_incref"><tt class="xref c c-func docutils literal"><span class="pre">json_incref()</span></tt></a>. As soon as
+the value is no longer needed, <a class="reference internal" href="#c.json_decref" title="json_decref"><tt class="xref c c-func docutils literal"><span class="pre">json_decref()</span></tt></a> should be called
+to release the reference.</p>
+<p>Normally, all functions accepting a JSON value as an argument will
+manage the reference, i.e. increase and decrease the reference count
+as needed. However, some functions <strong>steal</strong> the reference, i.e. they
+have the same result as if the user called <a class="reference internal" href="#c.json_decref" title="json_decref"><tt class="xref c c-func docutils literal"><span class="pre">json_decref()</span></tt></a> on
+the argument right after calling the function. These functions are
+suffixed with <tt class="docutils literal"><span class="pre">_new</span></tt> or have <tt class="docutils literal"><span class="pre">_new_</span></tt> somewhere in their name.</p>
+<p>For example, the following code creates a new JSON array and appends
+an integer to it:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="kt">json_t</span> <span class="o">*</span><span class="n">array</span><span class="p">,</span> <span class="o">*</span><span class="n">integer</span><span class="p">;</span>
+
+<span class="n">array</span> <span class="o">=</span> <span class="n">json_array</span><span class="p">();</span>
+<span class="n">integer</span> <span class="o">=</span> <span class="n">json_integer</span><span class="p">(</span><span class="mi">42</span><span class="p">);</span>
+
+<span class="n">json_array_append</span><span class="p">(</span><span class="n">array</span><span class="p">,</span> <span class="n">integer</span><span class="p">);</span>
+<span class="n">json_decref</span><span class="p">(</span><span class="n">integer</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Note how the caller has to release the reference to the integer value
+by calling <a class="reference internal" href="#c.json_decref" title="json_decref"><tt class="xref c c-func docutils literal"><span class="pre">json_decref()</span></tt></a>. By using a reference stealing
+function <a class="reference internal" href="#c.json_array_append_new" title="json_array_append_new"><tt class="xref c c-func docutils literal"><span class="pre">json_array_append_new()</span></tt></a> instead of
+<a class="reference internal" href="#c.json_array_append" title="json_array_append"><tt class="xref c c-func docutils literal"><span class="pre">json_array_append()</span></tt></a>, the code becomes much simpler:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="kt">json_t</span> <span class="o">*</span><span class="n">array</span> <span class="o">=</span> <span class="n">json_array</span><span class="p">();</span>
+<span class="n">json_array_append_new</span><span class="p">(</span><span class="n">array</span><span class="p">,</span> <span class="n">json_integer</span><span class="p">(</span><span class="mi">42</span><span class="p">));</span>
+</pre></div>
+</div>
+<p>In this case, the user doesn’t have to explicitly release the
+reference to the integer value, as <a class="reference internal" href="#c.json_array_append_new" title="json_array_append_new"><tt class="xref c c-func docutils literal"><span class="pre">json_array_append_new()</span></tt></a>
+steals the reference when appending the value to the array.</p>
+<p>In the following sections it is clearly documented whether a function
+will return a new or borrowed reference or steal a reference to its
+argument.</p>
+</div>
+<div class="section" id="circular-references">
+<h3>Circular References<a class="headerlink" href="#circular-references" title="Permalink to this headline">¶</a></h3>
+<p>A circular reference is created when an object or an array is,
+directly or indirectly, inserted inside itself. The direct case is
+simple:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="kt">json_t</span> <span class="o">*</span><span class="n">obj</span> <span class="o">=</span> <span class="n">json_object</span><span class="p">();</span>
+<span class="n">json_object_set</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="s">"foo"</span><span class="p">,</span> <span class="n">obj</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Jansson will refuse to do this, and <a class="reference internal" href="#c.json_object_set" title="json_object_set"><tt class="xref c c-func docutils literal"><span class="pre">json_object_set()</span></tt></a> (and
+all the other such functions for objects and arrays) will return with
+an error status. The indirect case is the dangerous one:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="kt">json_t</span> <span class="o">*</span><span class="n">arr1</span> <span class="o">=</span> <span class="n">json_array</span><span class="p">(),</span> <span class="o">*</span><span class="n">arr2</span> <span class="o">=</span> <span class="n">json_array</span><span class="p">();</span>
+<span class="n">json_array_append</span><span class="p">(</span><span class="n">arr1</span><span class="p">,</span> <span class="n">arr2</span><span class="p">);</span>
+<span class="n">json_array_append</span><span class="p">(</span><span class="n">arr2</span><span class="p">,</span> <span class="n">arr1</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>In this example, the array <tt class="docutils literal"><span class="pre">arr2</span></tt> is contained in the array
+<tt class="docutils literal"><span class="pre">arr1</span></tt>, and vice versa. Jansson cannot check for this kind of
+indirect circular references without a performance hit, so it’s up to
+the user to avoid them.</p>
+<p>If a circular reference is created, the memory consumed by the values
+cannot be freed by <a class="reference internal" href="#c.json_decref" title="json_decref"><tt class="xref c c-func docutils literal"><span class="pre">json_decref()</span></tt></a>. The reference counts never
+drops to zero because the values are keeping the references to each
+other. Moreover, trying to encode the values with any of the encoding
+functions will fail. The encoder detects circular references and
+returns an error status.</p>
+</div>
+</div>
+<div class="section" id="true-false-and-null">
+<h2>True, False and Null<a class="headerlink" href="#true-false-and-null" title="Permalink to this headline">¶</a></h2>
+<p>These three values are implemented as singletons, so the returned
+pointers won’t change between invocations of these functions.</p>
+<dl class="function">
+<dt id="c.json_true">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_true</tt><big>(</big>void<big>)</big><a class="headerlink" href="#c.json_true" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns the JSON true value.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_false">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_false</tt><big>(</big>void<big>)</big><a class="headerlink" href="#c.json_false" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns the JSON false value.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_boolean">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_boolean</tt><big>(</big>val<big>)</big><a class="headerlink" href="#c.json_boolean" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns JSON false if <tt class="docutils literal"><span class="pre">val</span></tt> is zero, and JSON true otherwise.
+This is a macro, and equivalent to <tt class="docutils literal"><span class="pre">val</span> <span class="pre">?</span> <span class="pre">json_true()</span> <span class="pre">:</span>
+<span class="pre">json_false()</span></tt>.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.4.</span></p>
+</div>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_null">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_null</tt><big>(</big>void<big>)</big><a class="headerlink" href="#c.json_null" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns the JSON null value.</p>
+</dd></dl>
+
+</div>
+<div class="section" id="string">
+<h2>String<a class="headerlink" href="#string" title="Permalink to this headline">¶</a></h2>
+<p>Jansson uses UTF-8 as the character encoding. All JSON strings must be
+valid UTF-8 (or ASCII, as it’s a subset of UTF-8). All Unicode
+codepoints U+0000 through U+10FFFF are allowed, but you must use
+length-aware functions if you wish to embed NUL bytes in strings.</p>
+<dl class="function">
+<dt id="c.json_string">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_string</tt><big>(</big>const char<em> *value</em><big>)</big><a class="headerlink" href="#c.json_string" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns a new JSON string, or <em>NULL</em> on error. <em>value</em> must be a
+valid null terminated UTF-8 encoded Unicode string.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_stringn">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_stringn</tt><big>(</big>const char<em> *value</em>, size_t<em> len</em><big>)</big><a class="headerlink" href="#c.json_stringn" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Like <a class="reference internal" href="#c.json_string" title="json_string"><tt class="xref c c-func docutils literal"><span class="pre">json_string()</span></tt></a>, but with explicit length, so <em>value</em> may
+contain null characters or not be null terminated.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_string_nocheck">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_string_nocheck</tt><big>(</big>const char<em> *value</em><big>)</big><a class="headerlink" href="#c.json_string_nocheck" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Like <a class="reference internal" href="#c.json_string" title="json_string"><tt class="xref c c-func docutils literal"><span class="pre">json_string()</span></tt></a>, but doesn’t check that <em>value</em> is valid
+UTF-8. Use this function only if you are certain that this really
+is the case (e.g. you have already checked it by other means).</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_stringn_nocheck">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_stringn_nocheck</tt><big>(</big>const char<em> *value</em>, size_t<em> len</em><big>)</big><a class="headerlink" href="#c.json_stringn_nocheck" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Like <a class="reference internal" href="#c.json_string_nocheck" title="json_string_nocheck"><tt class="xref c c-func docutils literal"><span class="pre">json_string_nocheck()</span></tt></a>, but with explicit length, so
+<em>value</em> may contain null characters or not be null terminated.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_string_value">
+const char *<tt class="descname">json_string_value</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *string</em><big>)</big><a class="headerlink" href="#c.json_string_value" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the associated value of <em>string</em> as a null terminated UTF-8
+encoded string, or <em>NULL</em> if <em>string</em> is not a JSON string.</p>
+<p>The retuned value is read-only and must not be modified or freed by
+the user. It is valid as long as <em>string</em> exists, i.e. as long as
+its reference count has not dropped to zero.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_string_length">
+size_t <tt class="descname">json_string_length</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *string</em><big>)</big><a class="headerlink" href="#c.json_string_length" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the length of <em>string</em> in its UTF-8 presentation, or zero
+if <em>string</em> is not a JSON string.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_string_set">
+int <tt class="descname">json_string_set</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *string</em>, const char<em> *value</em><big>)</big><a class="headerlink" href="#c.json_string_set" title="Permalink to this definition">¶</a></dt>
+<dd><p>Sets the associated value of <em>string</em> to <em>value</em>. <em>value</em> must be a
+valid UTF-8 encoded Unicode string. Returns 0 on success and -1 on
+error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_string_setn">
+int <tt class="descname">json_string_setn</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *string</em>, const char<em> *value</em>, size_t<em> len</em><big>)</big><a class="headerlink" href="#c.json_string_setn" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_string_set" title="json_string_set"><tt class="xref c c-func docutils literal"><span class="pre">json_string_set()</span></tt></a>, but with explicit length, so <em>value</em>
+may contain null characters or not be null terminated.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_string_set_nocheck">
+int <tt class="descname">json_string_set_nocheck</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *string</em>, const char<em> *value</em><big>)</big><a class="headerlink" href="#c.json_string_set_nocheck" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_string_set" title="json_string_set"><tt class="xref c c-func docutils literal"><span class="pre">json_string_set()</span></tt></a>, but doesn’t check that <em>value</em> is
+valid UTF-8. Use this function only if you are certain that this
+really is the case (e.g. you have already checked it by other
+means).</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_string_setn_nocheck">
+int <tt class="descname">json_string_setn_nocheck</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *string</em>, const char<em> *value</em>, size_t<em> len</em><big>)</big><a class="headerlink" href="#c.json_string_setn_nocheck" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_string_set_nocheck" title="json_string_set_nocheck"><tt class="xref c c-func docutils literal"><span class="pre">json_string_set_nocheck()</span></tt></a>, but with explicit length,
+so <em>value</em> may contain null characters or not be null terminated.</p>
+</dd></dl>
+
+</div>
+<div class="section" id="number">
+<h2>Number<a class="headerlink" href="#number" title="Permalink to this headline">¶</a></h2>
+<p>The JSON specification only contains one numeric type, “number”. The C
+programming language has distinct types for integer and floating-point
+numbers, so for practical reasons Jansson also has distinct types for
+the two. They are called “integer” and “real”, respectively. For more
+information, see <a class="reference internal" href="conformance.html#rfc-conformance"><em>RFC Conformance</em></a>.</p>
+<dl class="type">
+<dt id="c.json_int_t">
+<tt class="descname">json_int_t</tt><a class="headerlink" href="#c.json_int_t" title="Permalink to this definition">¶</a></dt>
+<dd><p>This is the C type that is used to store JSON integer values. It
+represents the widest integer type available on your system. In
+practice it’s just a typedef of <tt class="docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt> if your compiler
+supports it, otherwise <tt class="docutils literal"><span class="pre">long</span></tt>.</p>
+<p>Usually, you can safely use plain <tt class="docutils literal"><span class="pre">int</span></tt> in place of
+<tt class="docutils literal"><span class="pre">json_int_t</span></tt>, and the implicit C integer conversion handles the
+rest. Only when you know that you need the full 64-bit range, you
+should use <tt class="docutils literal"><span class="pre">json_int_t</span></tt> explicitly.</p>
+</dd></dl>
+
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">JSON_INTEGER_IS_LONG_LONG</span></tt></dt>
+<dd><p class="first">This is a preprocessor variable that holds the value 1 if
+<a class="reference internal" href="#c.json_int_t" title="json_int_t"><tt class="xref c c-type docutils literal"><span class="pre">json_int_t</span></tt></a> is <tt class="docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt>, and 0 if it’s <tt class="docutils literal"><span class="pre">long</span></tt>. It
+can be used as follows:</p>
+<div class="last highlight-c"><div class="highlight"><pre><span class="cp">#if JSON_INTEGER_IS_LONG_LONG</span>
+<span class="cm">/* Code specific for long long */</span>
+<span class="cp">#else</span>
+<span class="cm">/* Code specific for long */</span>
+<span class="cp">#endif</span>
+</pre></div>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_INTEGER_FORMAT</span></tt></dt>
+<dd><p class="first">This is a macro that expands to a <tt class="xref c c-func docutils literal"><span class="pre">printf()</span></tt> conversion
+specifier that corresponds to <a class="reference internal" href="#c.json_int_t" title="json_int_t"><tt class="xref c c-type docutils literal"><span class="pre">json_int_t</span></tt></a>, without the
+leading <tt class="docutils literal"><span class="pre">%</span></tt> sign, i.e. either <tt class="docutils literal"><span class="pre">"lld"</span></tt> or <tt class="docutils literal"><span class="pre">"ld"</span></tt>. This macro
+is required because the actual type of <a class="reference internal" href="#c.json_int_t" title="json_int_t"><tt class="xref c c-type docutils literal"><span class="pre">json_int_t</span></tt></a> can be
+either <tt class="docutils literal"><span class="pre">long</span></tt> or <tt class="docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt>, and <tt class="xref c c-func docutils literal"><span class="pre">printf()</span></tt> reuiqres
+different length modifiers for the two.</p>
+<p>Example:</p>
+<div class="last highlight-c"><div class="highlight"><pre><span class="kt">json_int_t</span> <span class="n">x</span> <span class="o">=</span> <span class="mi">123123123</span><span class="p">;</span>
+<span class="n">printf</span><span class="p">(</span><span class="s">"x is %"</span> <span class="n">JSON_INTEGER_FORMAT</span> <span class="s">"</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">x</span><span class="p">);</span>
+</pre></div>
+</div>
+</dd>
+</dl>
+<dl class="function">
+<dt id="c.json_integer">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_integer</tt><big>(</big><a class="reference internal" href="#c.json_int_t" title="json_int_t">json_int_t</a><em> value</em><big>)</big><a class="headerlink" href="#c.json_integer" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns a new JSON integer, or <em>NULL</em> on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_integer_value">
+<a class="reference internal" href="#c.json_int_t" title="json_int_t">json_int_t</a> <tt class="descname">json_integer_value</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *integer</em><big>)</big><a class="headerlink" href="#c.json_integer_value" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the associated value of <em>integer</em>, or 0 if <em>json</em> is not a
+JSON integer.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_integer_set">
+int <tt class="descname">json_integer_set</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *integer</em>, <a class="reference internal" href="#c.json_int_t" title="json_int_t">json_int_t</a><em> value</em><big>)</big><a class="headerlink" href="#c.json_integer_set" title="Permalink to this definition">¶</a></dt>
+<dd><p>Sets the associated value of <em>integer</em> to <em>value</em>. Returns 0 on
+success and -1 if <em>integer</em> is not a JSON integer.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_real">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_real</tt><big>(</big>double<em> value</em><big>)</big><a class="headerlink" href="#c.json_real" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns a new JSON real, or <em>NULL</em> on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_real_value">
+double <tt class="descname">json_real_value</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *real</em><big>)</big><a class="headerlink" href="#c.json_real_value" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the associated value of <em>real</em>, or 0.0 if <em>real</em> is not a
+JSON real.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_real_set">
+int <tt class="descname">json_real_set</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *real</em>, double<em> value</em><big>)</big><a class="headerlink" href="#c.json_real_set" title="Permalink to this definition">¶</a></dt>
+<dd><p>Sets the associated value of <em>real</em> to <em>value</em>. Returns 0 on
+success and -1 if <em>real</em> is not a JSON real.</p>
+</dd></dl>
+
+<p>In addition to the functions above, there’s a common query function
+for integers and reals:</p>
+<dl class="function">
+<dt id="c.json_number_value">
+double <tt class="descname">json_number_value</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em><big>)</big><a class="headerlink" href="#c.json_number_value" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the associated value of the JSON integer or JSON real
+<em>json</em>, cast to double regardless of the actual type. If <em>json</em> is
+neither JSON real nor JSON integer, 0.0 is returned.</p>
+</dd></dl>
+
+</div>
+<div class="section" id="array">
+<h2>Array<a class="headerlink" href="#array" title="Permalink to this headline">¶</a></h2>
+<p>A JSON array is an ordered collection of other JSON values.</p>
+<dl class="function">
+<dt id="c.json_array">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_array</tt><big>(</big>void<big>)</big><a class="headerlink" href="#c.json_array" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns a new JSON array, or <em>NULL</em> on error. Initially, the array
+is empty.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_size">
+size_t <tt class="descname">json_array_size</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em><big>)</big><a class="headerlink" href="#c.json_array_size" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the number of elements in <em>array</em>, or 0 if <em>array</em> is NULL
+or not a JSON array.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_get">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_array_get</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, size_t<em> index</em><big>)</big><a class="headerlink" href="#c.json_array_get" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: Borrowed reference.</em><p>Returns the element in <em>array</em> at position <em>index</em>. The valid range
+for <em>index</em> is from 0 to the return value of
+<a class="reference internal" href="#c.json_array_size" title="json_array_size"><tt class="xref c c-func docutils literal"><span class="pre">json_array_size()</span></tt></a> minus 1. If <em>array</em> is not a JSON array,
+if <em>array</em> is <em>NULL</em>, or if <em>index</em> is out of range, <em>NULL</em> is
+returned.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_set">
+int <tt class="descname">json_array_set</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, size_t<em> index</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_array_set" title="Permalink to this definition">¶</a></dt>
+<dd><p>Replaces the element in <em>array</em> at position <em>index</em> with <em>value</em>.
+The valid range for <em>index</em> is from 0 to the return value of
+<a class="reference internal" href="#c.json_array_size" title="json_array_size"><tt class="xref c c-func docutils literal"><span class="pre">json_array_size()</span></tt></a> minus 1. Returns 0 on success and -1 on
+error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_set_new">
+int <tt class="descname">json_array_set_new</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, size_t<em> index</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_array_set_new" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_array_set" title="json_array_set"><tt class="xref c c-func docutils literal"><span class="pre">json_array_set()</span></tt></a> but steals the reference to <em>value</em>.
+This is useful when <em>value</em> is newly created and not used after
+the call.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_append">
+int <tt class="descname">json_array_append</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_array_append" title="Permalink to this definition">¶</a></dt>
+<dd><p>Appends <em>value</em> to the end of <em>array</em>, growing the size of <em>array</em>
+by 1. Returns 0 on success and -1 on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_append_new">
+int <tt class="descname">json_array_append_new</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_array_append_new" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_array_append" title="json_array_append"><tt class="xref c c-func docutils literal"><span class="pre">json_array_append()</span></tt></a> but steals the reference to
+<em>value</em>. This is useful when <em>value</em> is newly created and not used
+after the call.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_insert">
+int <tt class="descname">json_array_insert</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, size_t<em> index</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_array_insert" title="Permalink to this definition">¶</a></dt>
+<dd><p>Inserts <em>value</em> to <em>array</em> at position <em>index</em>, shifting the
+elements at <em>index</em> and after it one position towards the end of
+the array. Returns 0 on success and -1 on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_insert_new">
+int <tt class="descname">json_array_insert_new</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, size_t<em> index</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_array_insert_new" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_array_insert" title="json_array_insert"><tt class="xref c c-func docutils literal"><span class="pre">json_array_insert()</span></tt></a> but steals the reference to
+<em>value</em>. This is useful when <em>value</em> is newly created and not used
+after the call.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_remove">
+int <tt class="descname">json_array_remove</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, size_t<em> index</em><big>)</big><a class="headerlink" href="#c.json_array_remove" title="Permalink to this definition">¶</a></dt>
+<dd><p>Removes the element in <em>array</em> at position <em>index</em>, shifting the
+elements after <em>index</em> one position towards the start of the array.
+Returns 0 on success and -1 on error. The reference count of the
+removed value is decremented.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_clear">
+int <tt class="descname">json_array_clear</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em><big>)</big><a class="headerlink" href="#c.json_array_clear" title="Permalink to this definition">¶</a></dt>
+<dd><p>Removes all elements from <em>array</em>. Returns 0 on sucess and -1 on
+error. The reference count of all removed values are decremented.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_array_extend">
+int <tt class="descname">json_array_extend</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *array</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *other_array</em><big>)</big><a class="headerlink" href="#c.json_array_extend" title="Permalink to this definition">¶</a></dt>
+<dd><p>Appends all elements in <em>other_array</em> to the end of <em>array</em>.
+Returns 0 on success and -1 on error.</p>
+</dd></dl>
+
+<p>The following macro can be used to iterate through all elements
+in an array.</p>
+<dl class="function">
+<dt id="c.json_array_foreach">
+<tt class="descname">json_array_foreach</tt><big>(</big>array, index, value<big>)</big><a class="headerlink" href="#c.json_array_foreach" title="Permalink to this definition">¶</a></dt>
+<dd><p>Iterate over every element of <tt class="docutils literal"><span class="pre">array</span></tt>, running the block
+of code that follows each time with the proper values set to
+variables <tt class="docutils literal"><span class="pre">index</span></tt> and <tt class="docutils literal"><span class="pre">value</span></tt>, of types <tt class="xref c c-type docutils literal"><span class="pre">size_t</span></tt> and
+<a class="reference internal" href="#c.json_t" title="json_t"><tt class="xref c c-type docutils literal"><span class="pre">json_t</span> <span class="pre">*</span></tt></a> respectively. Example:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cm">/* array is a JSON array */</span>
+<span class="kt">size_t</span> <span class="n">index</span><span class="p">;</span>
+<span class="kt">json_t</span> <span class="o">*</span><span class="n">value</span><span class="p">;</span>
+
+<span class="n">json_array_foreach</span><span class="p">(</span><span class="n">array</span><span class="p">,</span> <span class="n">index</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> <span class="p">{</span>
+ <span class="cm">/* block of code that uses index and value */</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>The items are returned in increasing index order.</p>
+<p>This macro expands to an ordinary <tt class="docutils literal"><span class="pre">for</span></tt> statement upon
+preprocessing, so its performance is equivalent to that of
+hand-written code using the array access functions.
+The main advantage of this macro is that it abstracts
+away the complexity, and makes for shorter, more
+concise code.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.5.</span></p>
+</div>
+</dd></dl>
+
+</div>
+<div class="section" id="object">
+<h2>Object<a class="headerlink" href="#object" title="Permalink to this headline">¶</a></h2>
+<p>A JSON object is a dictionary of key-value pairs, where the key is a
+Unicode string and the value is any JSON value.</p>
+<p>Even though NUL bytes are allowed in string values, they are not
+allowed in object keys.</p>
+<dl class="function">
+<dt id="c.json_object">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_object</tt><big>(</big>void<big>)</big><a class="headerlink" href="#c.json_object" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns a new JSON object, or <em>NULL</em> on error. Initially, the
+object is empty.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_size">
+size_t <tt class="descname">json_object_size</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em><big>)</big><a class="headerlink" href="#c.json_object_size" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the number of elements in <em>object</em>, or 0 if <em>object</em> is not
+a JSON object.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_get">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_object_get</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, const char<em> *key</em><big>)</big><a class="headerlink" href="#c.json_object_get" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: Borrowed reference.</em><p>Get a value corresponding to <em>key</em> from <em>object</em>. Returns <em>NULL</em> if
+<em>key</em> is not found and on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_set">
+int <tt class="descname">json_object_set</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, const char<em> *key</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_object_set" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the value of <em>key</em> to <em>value</em> in <em>object</em>. <em>key</em> must be a
+valid null terminated UTF-8 encoded Unicode string. If there
+already is a value for <em>key</em>, it is replaced by the new value.
+Returns 0 on success and -1 on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_set_nocheck">
+int <tt class="descname">json_object_set_nocheck</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, const char<em> *key</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_object_set_nocheck" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_object_set" title="json_object_set"><tt class="xref c c-func docutils literal"><span class="pre">json_object_set()</span></tt></a>, but doesn’t check that <em>key</em> is
+valid UTF-8. Use this function only if you are certain that this
+really is the case (e.g. you have already checked it by other
+means).</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_set_new">
+int <tt class="descname">json_object_set_new</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, const char<em> *key</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_object_set_new" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_object_set" title="json_object_set"><tt class="xref c c-func docutils literal"><span class="pre">json_object_set()</span></tt></a> but steals the reference to
+<em>value</em>. This is useful when <em>value</em> is newly created and not used
+after the call.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_set_new_nocheck">
+int <tt class="descname">json_object_set_new_nocheck</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, const char<em> *key</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_object_set_new_nocheck" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_object_set_new" title="json_object_set_new"><tt class="xref c c-func docutils literal"><span class="pre">json_object_set_new()</span></tt></a>, but doesn’t check that <em>key</em> is
+valid UTF-8. Use this function only if you are certain that this
+really is the case (e.g. you have already checked it by other
+means).</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_del">
+int <tt class="descname">json_object_del</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, const char<em> *key</em><big>)</big><a class="headerlink" href="#c.json_object_del" title="Permalink to this definition">¶</a></dt>
+<dd><p>Delete <em>key</em> from <em>object</em> if it exists. Returns 0 on success, or
+-1 if <em>key</em> was not found. The reference count of the removed value
+is decremented.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_clear">
+int <tt class="descname">json_object_clear</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em><big>)</big><a class="headerlink" href="#c.json_object_clear" title="Permalink to this definition">¶</a></dt>
+<dd><p>Remove all elements from <em>object</em>. Returns 0 on success and -1 if
+<em>object</em> is not a JSON object. The reference count of all removed
+values are decremented.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_update">
+int <tt class="descname">json_object_update</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *other</em><big>)</big><a class="headerlink" href="#c.json_object_update" title="Permalink to this definition">¶</a></dt>
+<dd><p>Update <em>object</em> with the key-value pairs from <em>other</em>, overwriting
+existing keys. Returns 0 on success or -1 on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_update_existing">
+int <tt class="descname">json_object_update_existing</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *other</em><big>)</big><a class="headerlink" href="#c.json_object_update_existing" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_object_update" title="json_object_update"><tt class="xref c c-func docutils literal"><span class="pre">json_object_update()</span></tt></a>, but only the values of existing
+keys are updated. No new keys are created. Returns 0 on success or
+-1 on error.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.3.</span></p>
+</div>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_update_missing">
+int <tt class="descname">json_object_update_missing</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *other</em><big>)</big><a class="headerlink" href="#c.json_object_update_missing" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_object_update" title="json_object_update"><tt class="xref c c-func docutils literal"><span class="pre">json_object_update()</span></tt></a>, but only new keys are created.
+The value of any existing key is not changed. Returns 0 on success
+or -1 on error.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.3.</span></p>
+</div>
+</dd></dl>
+
+<p>The following macro can be used to iterate through all key-value pairs
+in an object.</p>
+<dl class="function">
+<dt id="c.json_object_foreach">
+<tt class="descname">json_object_foreach</tt><big>(</big>object, key, value<big>)</big><a class="headerlink" href="#c.json_object_foreach" title="Permalink to this definition">¶</a></dt>
+<dd><p>Iterate over every key-value pair of <tt class="docutils literal"><span class="pre">object</span></tt>, running the block
+of code that follows each time with the proper values set to
+variables <tt class="docutils literal"><span class="pre">key</span></tt> and <tt class="docutils literal"><span class="pre">value</span></tt>, of types <tt class="xref c c-type docutils literal"><span class="pre">const</span> <span class="pre">char</span> <span class="pre">*</span></tt> and
+<a class="reference internal" href="#c.json_t" title="json_t"><tt class="xref c c-type docutils literal"><span class="pre">json_t</span> <span class="pre">*</span></tt></a> respectively. Example:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cm">/* obj is a JSON object */</span>
+<span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">key</span><span class="p">;</span>
+<span class="kt">json_t</span> <span class="o">*</span><span class="n">value</span><span class="p">;</span>
+
+<span class="n">json_object_foreach</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span> <span class="p">{</span>
+ <span class="cm">/* block of code that uses key and value */</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>The items are not returned in any particular order.</p>
+<p>This macro expands to an ordinary <tt class="docutils literal"><span class="pre">for</span></tt> statement upon
+preprocessing, so its performance is equivalent to that of
+hand-written iteration code using the object iteration protocol
+(see below). The main advantage of this macro is that it abstracts
+away the complexity behind iteration, and makes for shorter, more
+concise code.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.3.</span></p>
+</div>
+</dd></dl>
+
+<p>The following functions implement an iteration protocol for objects,
+allowing to iterate through all key-value pairs in an object. The
+items are not returned in any particular order, as this would require
+sorting due to the internal hashtable implementation.</p>
+<dl class="function">
+<dt id="c.json_object_iter">
+void *<tt class="descname">json_object_iter</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em><big>)</big><a class="headerlink" href="#c.json_object_iter" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns an opaque iterator which can be used to iterate over all
+key-value pairs in <em>object</em>, or <em>NULL</em> if <em>object</em> is empty.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_iter_at">
+void *<tt class="descname">json_object_iter_at</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, const char<em> *key</em><big>)</big><a class="headerlink" href="#c.json_object_iter_at" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_object_iter" title="json_object_iter"><tt class="xref c c-func docutils literal"><span class="pre">json_object_iter()</span></tt></a>, but returns an iterator to the
+key-value pair in <em>object</em> whose key is equal to <em>key</em>, or NULL if
+<em>key</em> is not found in <em>object</em>. Iterating forward to the end of
+<em>object</em> only yields all key-value pairs of the object if <em>key</em>
+happens to be the first key in the underlying hash table.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_iter_next">
+void *<tt class="descname">json_object_iter_next</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, void<em> *iter</em><big>)</big><a class="headerlink" href="#c.json_object_iter_next" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns an iterator pointing to the next key-value pair in <em>object</em>
+after <em>iter</em>, or <em>NULL</em> if the whole object has been iterated
+through.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_iter_key">
+const char *<tt class="descname">json_object_iter_key</tt><big>(</big>void<em> *iter</em><big>)</big><a class="headerlink" href="#c.json_object_iter_key" title="Permalink to this definition">¶</a></dt>
+<dd><p>Extract the associated key from <em>iter</em>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_iter_value">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_object_iter_value</tt><big>(</big>void<em> *iter</em><big>)</big><a class="headerlink" href="#c.json_object_iter_value" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: Borrowed reference.</em><p>Extract the associated value from <em>iter</em>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_iter_set">
+int <tt class="descname">json_object_iter_set</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, void<em> *iter</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_object_iter_set" title="Permalink to this definition">¶</a></dt>
+<dd><p>Set the value of the key-value pair in <em>object</em>, that is pointed to
+by <em>iter</em>, to <em>value</em>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_iter_set_new">
+int <tt class="descname">json_object_iter_set_new</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *object</em>, void<em> *iter</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_object_iter_set_new" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_object_iter_set" title="json_object_iter_set"><tt class="xref c c-func docutils literal"><span class="pre">json_object_iter_set()</span></tt></a>, but steals the reference to
+<em>value</em>. This is useful when <em>value</em> is newly created and not used
+after the call.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_object_key_to_iter">
+void *<tt class="descname">json_object_key_to_iter</tt><big>(</big>const char<em> *key</em><big>)</big><a class="headerlink" href="#c.json_object_key_to_iter" title="Permalink to this definition">¶</a></dt>
+<dd><p>Like <a class="reference internal" href="#c.json_object_iter_at" title="json_object_iter_at"><tt class="xref c c-func docutils literal"><span class="pre">json_object_iter_at()</span></tt></a>, but much faster. Only works for
+values returned by <a class="reference internal" href="#c.json_object_iter_key" title="json_object_iter_key"><tt class="xref c c-func docutils literal"><span class="pre">json_object_iter_key()</span></tt></a>. Using other keys
+will lead to segfaults. This function is used internally to
+implement <a class="reference internal" href="#c.json_object_foreach" title="json_object_foreach"><tt class="xref c c-func docutils literal"><span class="pre">json_object_foreach()</span></tt></a>.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.3.</span></p>
+</div>
+</dd></dl>
+
+<p>The iteration protocol can be used for example as follows:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cm">/* obj is a JSON object */</span>
+<span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">key</span><span class="p">;</span>
+<span class="kt">json_t</span> <span class="o">*</span><span class="n">value</span><span class="p">;</span>
+
+<span class="kt">void</span> <span class="o">*</span><span class="n">iter</span> <span class="o">=</span> <span class="n">json_object_iter</span><span class="p">(</span><span class="n">obj</span><span class="p">);</span>
+<span class="k">while</span><span class="p">(</span><span class="n">iter</span><span class="p">)</span>
+<span class="p">{</span>
+ <span class="n">key</span> <span class="o">=</span> <span class="n">json_object_iter_key</span><span class="p">(</span><span class="n">iter</span><span class="p">);</span>
+ <span class="n">value</span> <span class="o">=</span> <span class="n">json_object_iter_value</span><span class="p">(</span><span class="n">iter</span><span class="p">);</span>
+ <span class="cm">/* use key and value ... */</span>
+ <span class="n">iter</span> <span class="o">=</span> <span class="n">json_object_iter_next</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">iter</span><span class="p">);</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<dl class="function">
+<dt id="c.json_object_seed">
+void <tt class="descname">json_object_seed</tt><big>(</big>size_t<em> seed</em><big>)</big><a class="headerlink" href="#c.json_object_seed" title="Permalink to this definition">¶</a></dt>
+<dd><p>Seed the hash function used in Jansson’s hashtable implementation.
+The seed is used to randomize the hash function so that an
+attacker cannot control its output.</p>
+<p>If <em>seed</em> is 0, Jansson generates the seed itselfy by reading
+random data from the operating system’s entropy sources. If no
+entropy sources are available, falls back to using a combination
+of the current timestamp (with microsecond precision if possible)
+and the process ID.</p>
+<p>If called at all, this function must be called before any calls to
+<a class="reference internal" href="#c.json_object" title="json_object"><tt class="xref c c-func docutils literal"><span class="pre">json_object()</span></tt></a>, either explicit or implicit. If this
+function is not called by the user, the first call to
+<a class="reference internal" href="#c.json_object" title="json_object"><tt class="xref c c-func docutils literal"><span class="pre">json_object()</span></tt></a> (either explicit or implicit) seeds the hash
+function. See <a class="reference internal" href="portability.html#portability-thread-safety"><em>Thread safety</em></a> for notes on thread
+safety.</p>
+<p>If repeatable results are required, for e.g. unit tests, the hash
+function can be “unrandomized” by calling <a class="reference internal" href="#c.json_object_seed" title="json_object_seed"><tt class="xref c c-func docutils literal"><span class="pre">json_object_seed()</span></tt></a>
+with a constant value on program startup, e.g.
+<tt class="docutils literal"><span class="pre">json_object_seed(1)</span></tt>.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.6.</span></p>
+</div>
+</dd></dl>
+
+</div>
+<div class="section" id="error-reporting">
+<h2>Error reporting<a class="headerlink" href="#error-reporting" title="Permalink to this headline">¶</a></h2>
+<p>Jansson uses a single struct type to pass error information to the
+user. See sections <a class="reference internal" href="#apiref-decoding"><em>Decoding</em></a>, <a class="reference internal" href="#apiref-pack"><em>Building Values</em></a> and
+<a class="reference internal" href="#apiref-unpack"><em>Parsing and Validating Values</em></a> for functions that pass error information using
+this struct.</p>
+<dl class="type">
+<dt id="c.json_error_t">
+<tt class="descname">json_error_t</tt><a class="headerlink" href="#c.json_error_t" title="Permalink to this definition">¶</a></dt>
+<dd><dl class="member">
+<dt>
+<tt class="descname">char text[]</tt></dt>
+<dd><p>The error message (in UTF-8), or an empty string if a message is
+not available.</p>
+</dd></dl>
+
+<dl class="member">
+<dt>
+<tt class="descname">char source[]</tt></dt>
+<dd><p>Source of the error. This can be (a part of) the file name or a
+special identifier in angle brackers (e.g. <tt class="docutils literal"><span class="pre"><string></span></tt>).</p>
+</dd></dl>
+
+<dl class="member">
+<dt id="c.json_error_t.line">
+int <tt class="descname">line</tt><a class="headerlink" href="#c.json_error_t.line" title="Permalink to this definition">¶</a></dt>
+<dd><p>The line number on which the error occurred.</p>
+</dd></dl>
+
+<dl class="member">
+<dt id="c.json_error_t.column">
+int <tt class="descname">column</tt><a class="headerlink" href="#c.json_error_t.column" title="Permalink to this definition">¶</a></dt>
+<dd><p>The column on which the error occurred. Note that this is the
+<em>character column</em>, not the byte column, i.e. a multibyte UTF-8
+character counts as one column.</p>
+</dd></dl>
+
+<dl class="member">
+<dt id="c.json_error_t.position">
+size_t <tt class="descname">position</tt><a class="headerlink" href="#c.json_error_t.position" title="Permalink to this definition">¶</a></dt>
+<dd><p>The position in bytes from the start of the input. This is
+useful for debugging Unicode encoding problems.</p>
+</dd></dl>
+
+</dd></dl>
+
+<p>The normal use of <a class="reference internal" href="#c.json_error_t" title="json_error_t"><tt class="xref c c-type docutils literal"><span class="pre">json_error_t</span></tt></a> is to allocate it on the stack,
+and pass a pointer to a function. Example:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
+ <span class="kt">json_t</span> <span class="o">*</span><span class="n">json</span><span class="p">;</span>
+ <span class="kt">json_error_t</span> <span class="n">error</span><span class="p">;</span>
+
+ <span class="n">json</span> <span class="o">=</span> <span class="n">json_load_file</span><span class="p">(</span><span class="s">"/path/to/file.json"</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="o">&</span><span class="n">error</span><span class="p">);</span>
+ <span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">json</span><span class="p">)</span> <span class="p">{</span>
+ <span class="cm">/* the error variable contains error information */</span>
+ <span class="p">}</span>
+ <span class="p">...</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Also note that if the call succeeded (<tt class="docutils literal"><span class="pre">json</span> <span class="pre">!=</span> <span class="pre">NULL</span></tt> in the above
+example), the contents of <tt class="docutils literal"><span class="pre">error</span></tt> are generally left unspecified.
+The decoding functions write to the <tt class="docutils literal"><span class="pre">position</span></tt> member also on
+success. See <a class="reference internal" href="#apiref-decoding"><em>Decoding</em></a> for more info.</p>
+<p>All functions also accept <em>NULL</em> as the <a class="reference internal" href="#c.json_error_t" title="json_error_t"><tt class="xref c c-type docutils literal"><span class="pre">json_error_t</span></tt></a> pointer,
+in which case no error information is returned to the caller.</p>
+</div>
+<div class="section" id="encoding">
+<h2>Encoding<a class="headerlink" href="#encoding" title="Permalink to this headline">¶</a></h2>
+<p>This sections describes the functions that can be used to encode
+values to JSON. By default, only objects and arrays can be encoded
+directly, since they are the only valid <em>root</em> values of a JSON text.
+To encode any JSON value, use the <tt class="docutils literal"><span class="pre">JSON_ENCODE_ANY</span></tt> flag (see
+below).</p>
+<p>By default, the output has no newlines, and spaces are used between
+array and object elements for a readable output. This behavior can be
+altered by using the <tt class="docutils literal"><span class="pre">JSON_INDENT</span></tt> and <tt class="docutils literal"><span class="pre">JSON_COMPACT</span></tt> flags
+described below. A newline is never appended to the end of the encoded
+JSON data.</p>
+<p>Each function takes a <em>flags</em> parameter that controls some aspects of
+how the data is encoded. Its default value is 0. The following macros
+can be ORed together to obtain <em>flags</em>.</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">JSON_INDENT(n)</span></tt></dt>
+<dd><p class="first">Pretty-print the result, using newlines between array and object
+items, and indenting with <em>n</em> spaces. The valid range for <em>n</em> is
+between 0 and 31 (inclusive), other values result in an undefined
+output. If <tt class="docutils literal"><span class="pre">JSON_INDENT</span></tt> is not used or <em>n</em> is 0, no newlines are
+inserted between array and object items.</p>
+<p>The <tt class="docutils literal"><span class="pre">JSON_MAX_INDENT</span></tt> constant defines the maximum indentation
+that can be used, and its value is 31.</p>
+<div class="last versionchanged">
+<p><span class="versionmodified">Changed in version 2.7: </span>Added <tt class="docutils literal"><span class="pre">JSON_MAX_INDENT</span></tt>.</p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_COMPACT</span></tt></dt>
+<dd>This flag enables a compact representation, i.e. sets the separator
+between array and object items to <tt class="docutils literal"><span class="pre">","</span></tt> and between object keys
+and values to <tt class="docutils literal"><span class="pre">":"</span></tt>. Without this flag, the corresponding
+separators are <tt class="docutils literal"><span class="pre">",</span> <span class="pre">"</span></tt> and <tt class="docutils literal"><span class="pre">":</span> <span class="pre">"</span></tt> for more readable output.</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_ENSURE_ASCII</span></tt></dt>
+<dd>If this flag is used, the output is guaranteed to consist only of
+ASCII characters. This is achived by escaping all Unicode
+characters outside the ASCII range.</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_SORT_KEYS</span></tt></dt>
+<dd>If this flag is used, all the objects in output are sorted by key.
+This is useful e.g. if two JSON texts are diffed or visually
+compared.</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_PRESERVE_ORDER</span></tt></dt>
+<dd>If this flag is used, object keys in the output are sorted into the
+same order in which they were first inserted to the object. For
+example, decoding a JSON text and then encoding with this flag
+preserves the order of object keys.</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_ENCODE_ANY</span></tt></dt>
+<dd><p class="first">Specifying this flag makes it possible to encode any JSON value on
+its own. Without it, only objects and arrays can be passed as the
+<em>root</em> value to the encoding functions.</p>
+<p><strong>Note:</strong> Encoding any value may be useful in some scenarios, but
+it’s generally discouraged as it violates strict compatiblity with
+<span class="target" id="index-1"></span><a class="rfc reference external" href="http://tools.ietf.org/html/rfc4627.html"><strong>RFC 4627</strong></a>. If you use this flag, don’t expect interoperatibility
+with other JSON systems.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.1.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_ESCAPE_SLASH</span></tt></dt>
+<dd><p class="first">Escape the <tt class="docutils literal"><span class="pre">/</span></tt> characters in strings with <tt class="docutils literal"><span class="pre">\/</span></tt>.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.4.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_REAL_PRECISION(n)</span></tt></dt>
+<dd><p class="first">Output all real numbers with at most <em>n</em> digits of precision. The
+valid range for <em>n</em> is between 0 and 31 (inclusive), and other
+values result in an undefined behavior.</p>
+<p>By default, the precision is 17, to correctly and losslessly encode
+all IEEE 754 double precision floating point numbers.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.7.</span></p>
+</div>
+</dd>
+</dl>
+<p>The following functions perform the actual JSON encoding. The result
+is in UTF-8.</p>
+<dl class="function">
+<dt id="c.json_dumps">
+char *<tt class="descname">json_dumps</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *root</em>, size_t<em> flags</em><big>)</big><a class="headerlink" href="#c.json_dumps" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns the JSON representation of <em>root</em> as a string, or <em>NULL</em> on
+error. <em>flags</em> is described above. The return value must be freed
+by the caller using <tt class="xref c c-func docutils literal"><span class="pre">free()</span></tt>.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_dumpf">
+int <tt class="descname">json_dumpf</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *root</em>, FILE<em> *output</em>, size_t<em> flags</em><big>)</big><a class="headerlink" href="#c.json_dumpf" title="Permalink to this definition">¶</a></dt>
+<dd><p>Write the JSON representation of <em>root</em> to the stream <em>output</em>.
+<em>flags</em> is described above. Returns 0 on success and -1 on error.
+If an error occurs, something may have already been written to
+<em>output</em>. In this case, the output is undefined and most likely not
+valid JSON.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_dump_file">
+int <tt class="descname">json_dump_file</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em>, const char<em> *path</em>, size_t<em> flags</em><big>)</big><a class="headerlink" href="#c.json_dump_file" title="Permalink to this definition">¶</a></dt>
+<dd><p>Write the JSON representation of <em>root</em> to the file <em>path</em>. If
+<em>path</em> already exists, it is overwritten. <em>flags</em> is described
+above. Returns 0 on success and -1 on error.</p>
+</dd></dl>
+
+<dl class="type">
+<dt id="c.json_dump_callback_t">
+<tt class="descname">json_dump_callback_t</tt><a class="headerlink" href="#c.json_dump_callback_t" title="Permalink to this definition">¶</a></dt>
+<dd><p>A typedef for a function that’s called by
+<a class="reference internal" href="#c.json_dump_callback" title="json_dump_callback"><tt class="xref c c-func docutils literal"><span class="pre">json_dump_callback()</span></tt></a>:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="k">typedef</span> <span class="nf">int</span> <span class="p">(</span><span class="o">*</span><span class="kt">json_dump_callback_t</span><span class="p">)(</span><span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">buffer</span><span class="p">,</span> <span class="kt">size_t</span> <span class="n">size</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">data</span><span class="p">);</span>
+</pre></div>
+</div>
+<p><em>buffer</em> points to a buffer containing a chunk of output, <em>size</em> is
+the length of the buffer, and <em>data</em> is the corresponding
+<a class="reference internal" href="#c.json_dump_callback" title="json_dump_callback"><tt class="xref c c-func docutils literal"><span class="pre">json_dump_callback()</span></tt></a> argument passed through.</p>
+<p>On error, the function should return -1 to stop the encoding
+process. On success, it should return 0.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.2.</span></p>
+</div>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_dump_callback">
+int <tt class="descname">json_dump_callback</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *json</em>, <a class="reference internal" href="#c.json_dump_callback_t" title="json_dump_callback_t">json_dump_callback_t</a><em> callback</em>, void<em> *data</em>, size_t<em> flags</em><big>)</big><a class="headerlink" href="#c.json_dump_callback" title="Permalink to this definition">¶</a></dt>
+<dd><p>Call <em>callback</em> repeatedly, passing a chunk of the JSON
+representation of <em>root</em> each time. <em>flags</em> is described above.
+Returns 0 on success and -1 on error.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.2.</span></p>
+</div>
+</dd></dl>
+
+</div>
+<div class="section" id="decoding">
+<span id="apiref-decoding"></span><h2>Decoding<a class="headerlink" href="#decoding" title="Permalink to this headline">¶</a></h2>
+<p>This sections describes the functions that can be used to decode JSON
+text to the Jansson representation of JSON data. The JSON
+specification requires that a JSON text is either a serialized array
+or object, and this requirement is also enforced with the following
+functions. In other words, the top level value in the JSON text being
+decoded must be either array or object. To decode any JSON value, use
+the <tt class="docutils literal"><span class="pre">JSON_DECODE_ANY</span></tt> flag (see below).</p>
+<p>See <a class="reference internal" href="conformance.html#rfc-conformance"><em>RFC Conformance</em></a> for a discussion on Jansson’s conformance
+to the JSON specification. It explains many design decisions that
+affect especially the behavior of the decoder.</p>
+<p>Each function takes a <em>flags</em> parameter that can be used to control
+the behavior of the decoder. Its default value is 0. The following
+macros can be ORed together to obtain <em>flags</em>.</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">JSON_REJECT_DUPLICATES</span></tt></dt>
+<dd><p class="first">Issue a decoding error if any JSON object in the input text
+contains duplicate keys. Without this flag, the value of the last
+occurence of each key ends up in the result. Key equivalence is
+checked byte-by-byte, without special Unicode comparison
+algorithms.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.1.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_DECODE_ANY</span></tt></dt>
+<dd><p class="first">By default, the decoder expects an array or object as the input.
+With this flag enabled, the decoder accepts any valid JSON value.</p>
+<p><strong>Note:</strong> Decoding any value may be useful in some scenarios, but
+it’s generally discouraged as it violates strict compatiblity with
+<span class="target" id="index-2"></span><a class="rfc reference external" href="http://tools.ietf.org/html/rfc4627.html"><strong>RFC 4627</strong></a>. If you use this flag, don’t expect interoperatibility
+with other JSON systems.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.3.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_DISABLE_EOF_CHECK</span></tt></dt>
+<dd><p class="first">By default, the decoder expects that its whole input constitutes a
+valid JSON text, and issues an error if there’s extra data after
+the otherwise valid JSON input. With this flag enabled, the decoder
+stops after decoding a valid JSON array or object, and thus allows
+extra data after the JSON text.</p>
+<p>Normally, reading will stop when the last <tt class="docutils literal"><span class="pre">]</span></tt> or <tt class="docutils literal"><span class="pre">}</span></tt> in the
+JSON input is encountered. If both <tt class="docutils literal"><span class="pre">JSON_DISABLE_EOF_CHECK</span></tt> and
+<tt class="docutils literal"><span class="pre">JSON_DECODE_ANY</span></tt> flags are used, the decoder may read one extra
+UTF-8 code unit (up to 4 bytes of input). For example, decoding
+<tt class="docutils literal"><span class="pre">4true</span></tt> correctly decodes the integer 4, but also reads the
+<tt class="docutils literal"><span class="pre">t</span></tt>. For this reason, if reading multiple consecutive values that
+are not arrays or objects, they should be separated by at least one
+whitespace character.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.1.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_DECODE_INT_AS_REAL</span></tt></dt>
+<dd><p class="first">JSON defines only one number type. Jansson distinguishes between
+ints and reals. For more information see <a class="reference internal" href="conformance.html#real-vs-integer"><em>Real vs. Integer</em></a>.
+With this flag enabled the decoder interprets all numbers as real
+values. Integers that do not have an exact double representation
+will silently result in a loss of precision. Integers that cause
+a double overflow will cause an error.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.5.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_ALLOW_NUL</span></tt></dt>
+<dd><p class="first">Allow <tt class="docutils literal"><span class="pre">\u0000</span></tt> escape inside string values. This is a safety
+measure; If you know your input can contain NUL bytes, use this
+flag. If you don’t use this flag, you don’t have to worry about NUL
+bytes inside strings unless you explicitly create themselves by
+using e.g. <a class="reference internal" href="#c.json_stringn" title="json_stringn"><tt class="xref c c-func docutils literal"><span class="pre">json_stringn()</span></tt></a> or <tt class="docutils literal"><span class="pre">s#</span></tt> format specifier for
+<a class="reference internal" href="#c.json_pack" title="json_pack"><tt class="xref c c-func docutils literal"><span class="pre">json_pack()</span></tt></a>.</p>
+<p>Object keys cannot have embedded NUL bytes even if this flag is
+used.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.6.</span></p>
+</div>
+</dd>
+</dl>
+<p>Each function also takes an optional <a class="reference internal" href="#c.json_error_t" title="json_error_t"><tt class="xref c c-type docutils literal"><span class="pre">json_error_t</span></tt></a> parameter
+that is filled with error information if decoding fails. It’s also
+updated on success; the number of bytes of input read is written to
+its <tt class="docutils literal"><span class="pre">position</span></tt> field. This is especially useful when using
+<tt class="docutils literal"><span class="pre">JSON_DISABLE_EOF_CHECK</span></tt> to read multiple consecutive JSON texts.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.3: </span>Number of bytes of input read is written to the <tt class="docutils literal"><span class="pre">position</span></tt> field
+of the <a class="reference internal" href="#c.json_error_t" title="json_error_t"><tt class="xref c c-type docutils literal"><span class="pre">json_error_t</span></tt></a> structure.</p>
+</div>
+<p>If no error or position information is needed, you can pass <em>NULL</em>.</p>
+<p>The following functions perform the actual JSON decoding.</p>
+<dl class="function">
+<dt id="c.json_loads">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_loads</tt><big>(</big>const char<em> *input</em>, size_t<em> flags</em>, <a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em><big>)</big><a class="headerlink" href="#c.json_loads" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Decodes the JSON string <em>input</em> and returns the array or object it
+contains, or <em>NULL</em> on error, in which case <em>error</em> is filled with
+information about the error. <em>flags</em> is described above.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_loadb">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_loadb</tt><big>(</big>const char<em> *buffer</em>, size_t<em> buflen</em>, size_t<em> flags</em>, <a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em><big>)</big><a class="headerlink" href="#c.json_loadb" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Decodes the JSON string <em>buffer</em>, whose length is <em>buflen</em>, and
+returns the array or object it contains, or <em>NULL</em> on error, in
+which case <em>error</em> is filled with information about the error. This
+is similar to <a class="reference internal" href="#c.json_loads" title="json_loads"><tt class="xref c c-func docutils literal"><span class="pre">json_loads()</span></tt></a> except that the string doesn’t
+need to be null-terminated. <em>flags</em> is described above.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.1.</span></p>
+</div>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_loadf">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_loadf</tt><big>(</big>FILE<em> *input</em>, size_t<em> flags</em>, <a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em><big>)</big><a class="headerlink" href="#c.json_loadf" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Decodes the JSON text in stream <em>input</em> and returns the array or
+object it contains, or <em>NULL</em> on error, in which case <em>error</em> is
+filled with information about the error. <em>flags</em> is described
+above.</p>
+<p>This function will start reading the input from whatever position
+the input file was, without attempting to seek first. If an error
+occurs, the file position will be left indeterminate. On success,
+the file position will be at EOF, unless <tt class="docutils literal"><span class="pre">JSON_DISABLE_EOF_CHECK</span></tt>
+flag was used. In this case, the file position will be at the first
+character after the last <tt class="docutils literal"><span class="pre">]</span></tt> or <tt class="docutils literal"><span class="pre">}</span></tt> in the JSON input. This
+allows calling <a class="reference internal" href="#c.json_loadf" title="json_loadf"><tt class="xref c c-func docutils literal"><span class="pre">json_loadf()</span></tt></a> on the same <tt class="docutils literal"><span class="pre">FILE</span></tt> object
+multiple times, if the input consists of consecutive JSON texts,
+possibly separated by whitespace.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_load_file">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_load_file</tt><big>(</big>const char<em> *path</em>, size_t<em> flags</em>, <a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em><big>)</big><a class="headerlink" href="#c.json_load_file" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Decodes the JSON text in file <em>path</em> and returns the array or
+object it contains, or <em>NULL</em> on error, in which case <em>error</em> is
+filled with information about the error. <em>flags</em> is described
+above.</p>
+</dd></dl>
+
+<dl class="type">
+<dt id="c.json_load_callback_t">
+<tt class="descname">json_load_callback_t</tt><a class="headerlink" href="#c.json_load_callback_t" title="Permalink to this definition">¶</a></dt>
+<dd><p>A typedef for a function that’s called by
+<a class="reference internal" href="#c.json_load_callback" title="json_load_callback"><tt class="xref c c-func docutils literal"><span class="pre">json_load_callback()</span></tt></a> to read a chunk of input data:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="k">typedef</span> <span class="nf">size_t</span> <span class="p">(</span><span class="o">*</span><span class="kt">json_load_callback_t</span><span class="p">)(</span><span class="kt">void</span> <span class="o">*</span><span class="n">buffer</span><span class="p">,</span> <span class="kt">size_t</span> <span class="n">buflen</span><span class="p">,</span> <span class="kt">void</span> <span class="o">*</span><span class="n">data</span><span class="p">);</span>
+</pre></div>
+</div>
+<p><em>buffer</em> points to a buffer of <em>buflen</em> bytes, and <em>data</em> is the
+corresponding <a class="reference internal" href="#c.json_load_callback" title="json_load_callback"><tt class="xref c c-func docutils literal"><span class="pre">json_load_callback()</span></tt></a> argument passed through.</p>
+<p>On success, the function should return the number of bytes read; a
+returned value of 0 indicates that no data was read and that the
+end of file has been reached. On error, the function should return
+<tt class="docutils literal"><span class="pre">(size_t)-1</span></tt> to abort the decoding process.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.4.</span></p>
+</div>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_load_callback">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_load_callback</tt><big>(</big><a class="reference internal" href="#c.json_load_callback_t" title="json_load_callback_t">json_load_callback_t</a><em> callback</em>, void<em> *data</em>, size_t<em> flags</em>, <a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em><big>)</big><a class="headerlink" href="#c.json_load_callback" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Decodes the JSON text produced by repeated calls to <em>callback</em>, and
+returns the array or object it contains, or <em>NULL</em> on error, in
+which case <em>error</em> is filled with information about the error.
+<em>data</em> is passed through to <em>callback</em> on each call. <em>flags</em> is
+described above.</p>
+<div class="versionadded">
+<p><span class="versionmodified">New in version 2.4.</span></p>
+</div>
+</dd></dl>
+
+</div>
+<div class="section" id="building-values">
+<span id="apiref-pack"></span><h2>Building Values<a class="headerlink" href="#building-values" title="Permalink to this headline">¶</a></h2>
+<p>This section describes functions that help to create, or <em>pack</em>,
+complex JSON values, especially nested objects and arrays. Value
+building is based on a <em>format string</em> that is used to tell the
+functions about the expected arguments.</p>
+<p>For example, the format string <tt class="docutils literal"><span class="pre">"i"</span></tt> specifies a single integer
+value, while the format string <tt class="docutils literal"><span class="pre">"[ssb]"</span></tt> or the equivalent <tt class="docutils literal"><span class="pre">"[s,</span> <span class="pre">s,</span>
+<span class="pre">b]"</span></tt> specifies an array value with two strings and a boolean as its
+items:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cm">/* Create the JSON integer 42 */</span>
+<span class="n">json_pack</span><span class="p">(</span><span class="s">"i"</span><span class="p">,</span> <span class="mi">42</span><span class="p">);</span>
+
+<span class="cm">/* Create the JSON array ["foo", "bar", true] */</span>
+<span class="n">json_pack</span><span class="p">(</span><span class="s">"[ssb]"</span><span class="p">,</span> <span class="s">"foo"</span><span class="p">,</span> <span class="s">"bar"</span><span class="p">,</span> <span class="mi">1</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Here’s the full list of format specifiers. The type in parentheses
+denotes the resulting JSON type, and the type in brackets (if any)
+denotes the C type that is expected as the corresponding argument or
+arguments.</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">s</span></tt> (string) [const char *]</dt>
+<dd>Convert a NULL terminated UTF-8 string to a JSON string.</dd>
+<dt><tt class="docutils literal"><span class="pre">s#</span></tt> (string) [const char *, int]</dt>
+<dd><p class="first">Convert a UTF-8 buffer of a given length to a JSON string.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.5.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">s%</span></tt> (string) [const char *, size_t]</dt>
+<dd><p class="first">Like <tt class="docutils literal"><span class="pre">s#</span></tt> but the length argument is of type <tt class="xref c c-type docutils literal"><span class="pre">size_t</span></tt>.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.6.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">+</span></tt> [const char *]</dt>
+<dd><p class="first">Like <tt class="docutils literal"><span class="pre">s</span></tt>, but concatenate to the previous string. Only valid
+after <tt class="docutils literal"><span class="pre">s</span></tt>, <tt class="docutils literal"><span class="pre">s#</span></tt>, <tt class="docutils literal"><span class="pre">+</span></tt> or <tt class="docutils literal"><span class="pre">+#</span></tt>.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.5.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">+#</span></tt> [const char *, int]</dt>
+<dd><p class="first">Like <tt class="docutils literal"><span class="pre">s#</span></tt>, but concatenate to the previous string. Only valid
+after <tt class="docutils literal"><span class="pre">s</span></tt>, <tt class="docutils literal"><span class="pre">s#</span></tt>, <tt class="docutils literal"><span class="pre">+</span></tt> or <tt class="docutils literal"><span class="pre">+#</span></tt>.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.5.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">+%</span></tt> (string) [const char *, size_t]</dt>
+<dd><p class="first">Like <tt class="docutils literal"><span class="pre">+#</span></tt> but the length argument is of type <tt class="xref c c-type docutils literal"><span class="pre">size_t</span></tt>.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.6.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">n</span></tt> (null)</dt>
+<dd>Output a JSON null value. No argument is consumed.</dd>
+<dt><tt class="docutils literal"><span class="pre">b</span></tt> (boolean) [int]</dt>
+<dd>Convert a C <tt class="xref c c-type docutils literal"><span class="pre">int</span></tt> to JSON boolean value. Zero is converted
+to <tt class="docutils literal"><span class="pre">false</span></tt> and non-zero to <tt class="docutils literal"><span class="pre">true</span></tt>.</dd>
+<dt><tt class="docutils literal"><span class="pre">i</span></tt> (integer) [int]</dt>
+<dd>Convert a C <tt class="xref c c-type docutils literal"><span class="pre">int</span></tt> to JSON integer.</dd>
+<dt><tt class="docutils literal"><span class="pre">I</span></tt> (integer) [json_int_t]</dt>
+<dd>Convert a C <a class="reference internal" href="#c.json_int_t" title="json_int_t"><tt class="xref c c-type docutils literal"><span class="pre">json_int_t</span></tt></a> to JSON integer.</dd>
+<dt><tt class="docutils literal"><span class="pre">f</span></tt> (real) [double]</dt>
+<dd>Convert a C <tt class="xref c c-type docutils literal"><span class="pre">double</span></tt> to JSON real.</dd>
+<dt><tt class="docutils literal"><span class="pre">o</span></tt> (any value) [json_t *]</dt>
+<dd>Output any given JSON value as-is. If the value is added to an
+array or object, the reference to the value passed to <tt class="docutils literal"><span class="pre">o</span></tt> is
+stolen by the container.</dd>
+<dt><tt class="docutils literal"><span class="pre">O</span></tt> (any value) [json_t *]</dt>
+<dd>Like <tt class="docutils literal"><span class="pre">o</span></tt>, but the argument’s reference count is incremented.
+This is useful if you pack into an array or object and want to
+keep the reference for the JSON value consumed by <tt class="docutils literal"><span class="pre">O</span></tt> to
+yourself.</dd>
+<dt><tt class="docutils literal"><span class="pre">[fmt]</span></tt> (array)</dt>
+<dd>Build an array with contents from the inner format string. <tt class="docutils literal"><span class="pre">fmt</span></tt>
+may contain objects and arrays, i.e. recursive value building is
+supported.</dd>
+<dt><tt class="docutils literal"><span class="pre">{fmt}</span></tt> (object)</dt>
+<dd>Build an object with contents from the inner format string
+<tt class="docutils literal"><span class="pre">fmt</span></tt>. The first, third, etc. format specifier represent a key,
+and must be a string (see <tt class="docutils literal"><span class="pre">s</span></tt>, <tt class="docutils literal"><span class="pre">s#</span></tt>, <tt class="docutils literal"><span class="pre">+</span></tt> and <tt class="docutils literal"><span class="pre">+#</span></tt> above),
+as object keys are always strings. The second, fourth, etc. format
+specifier represent a value. Any value may be an object or array,
+i.e. recursive value building is supported.</dd>
+</dl>
+<p>Whitespace, <tt class="docutils literal"><span class="pre">:</span></tt> and <tt class="docutils literal"><span class="pre">,</span></tt> are ignored.</p>
+<p>The following functions compose the value building API:</p>
+<dl class="function">
+<dt id="c.json_pack">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_pack</tt><big>(</big>const char<em> *fmt</em>, ...<big>)</big><a class="headerlink" href="#c.json_pack" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Build a new JSON value according to the format string <em>fmt</em>. For
+each format specifier (except for <tt class="docutils literal"><span class="pre">{}[]n</span></tt>), one or more arguments
+are consumed and used to build the corresponding value. Returns
+<em>NULL</em> on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_pack_ex">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_pack_ex</tt><big>(</big><a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em>, size_t<em> flags</em>, const char<em> *fmt</em>, ...<big>)</big><a class="headerlink" href="#c.json_pack_ex" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_vpack_ex">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_vpack_ex</tt><big>(</big><a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em>, size_t<em> flags</em>, const char<em> *fmt</em>, va_list<em> ap</em><big>)</big><a class="headerlink" href="#c.json_vpack_ex" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Like <a class="reference internal" href="#c.json_pack" title="json_pack"><tt class="xref c c-func docutils literal"><span class="pre">json_pack()</span></tt></a>, but an in the case of an error, an error
+message is written to <em>error</em>, if it’s not <em>NULL</em>. The <em>flags</em>
+parameter is currently unused and should be set to 0.</p>
+<p>As only the errors in format string (and out-of-memory errors) can
+be caught by the packer, these two functions are most likely only
+useful for debugging format strings.</p>
+</dd></dl>
+
+<p>More examples:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cm">/* Build an empty JSON object */</span>
+<span class="n">json_pack</span><span class="p">(</span><span class="s">"{}"</span><span class="p">);</span>
+
+<span class="cm">/* Build the JSON object {"foo": 42, "bar": 7} */</span>
+<span class="n">json_pack</span><span class="p">(</span><span class="s">"{sisi}"</span><span class="p">,</span> <span class="s">"foo"</span><span class="p">,</span> <span class="mi">42</span><span class="p">,</span> <span class="s">"bar"</span><span class="p">,</span> <span class="mi">7</span><span class="p">);</span>
+
+<span class="cm">/* Like above, ':', ',' and whitespace are ignored */</span>
+<span class="n">json_pack</span><span class="p">(</span><span class="s">"{s:i, s:i}"</span><span class="p">,</span> <span class="s">"foo"</span><span class="p">,</span> <span class="mi">42</span><span class="p">,</span> <span class="s">"bar"</span><span class="p">,</span> <span class="mi">7</span><span class="p">);</span>
+
+<span class="cm">/* Build the JSON array [[1, 2], {"cool": true}] */</span>
+<span class="n">json_pack</span><span class="p">(</span><span class="s">"[[i,i],{s:b}]"</span><span class="p">,</span> <span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="s">"cool"</span><span class="p">,</span> <span class="mi">1</span><span class="p">);</span>
+
+<span class="cm">/* Build a string from a non-NUL terminated buffer */</span>
+<span class="kt">char</span> <span class="n">buffer</span><span class="p">[</span><span class="mi">4</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="sc">'t'</span><span class="p">,</span> <span class="sc">'e'</span><span class="p">,</span> <span class="sc">'s'</span><span class="p">,</span> <span class="sc">'t'</span><span class="p">};</span>
+<span class="n">json_pack</span><span class="p">(</span><span class="s">"s#"</span><span class="p">,</span> <span class="n">buffer</span><span class="p">,</span> <span class="mi">4</span><span class="p">);</span>
+
+<span class="cm">/* Concatentate strings together to build the JSON string "foobarbaz" */</span>
+<span class="n">json_pack</span><span class="p">(</span><span class="s">"s++"</span><span class="p">,</span> <span class="s">"foo"</span><span class="p">,</span> <span class="s">"bar"</span><span class="p">,</span> <span class="s">"baz"</span><span class="p">);</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="parsing-and-validating-values">
+<span id="apiref-unpack"></span><h2>Parsing and Validating Values<a class="headerlink" href="#parsing-and-validating-values" title="Permalink to this headline">¶</a></h2>
+<p>This section describes functions that help to validate complex values
+and extract, or <em>unpack</em>, data from them. Like <a class="reference internal" href="#apiref-pack"><em>building values</em></a>, this is also based on format strings.</p>
+<p>While a JSON value is unpacked, the type specified in the format
+string is checked to match that of the JSON value. This is the
+validation part of the process. In addition to this, the unpacking
+functions can also check that all items of arrays and objects are
+unpacked. This check be enabled with the format specifier <tt class="docutils literal"><span class="pre">!</span></tt> or by
+using the flag <tt class="docutils literal"><span class="pre">JSON_STRICT</span></tt>. See below for details.</p>
+<p>Here’s the full list of format specifiers. The type in parentheses
+denotes the JSON type, and the type in brackets (if any) denotes the C
+type whose address should be passed.</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">s</span></tt> (string) [const char *]</dt>
+<dd>Convert a JSON string to a pointer to a NULL terminated UTF-8
+string. The resulting string is extracted by using
+<a class="reference internal" href="#c.json_string_value" title="json_string_value"><tt class="xref c c-func docutils literal"><span class="pre">json_string_value()</span></tt></a> internally, so it exists as long as
+there are still references to the corresponding JSON string.</dd>
+<dt><tt class="docutils literal"><span class="pre">s%</span></tt> (string) [const char *, size_t *]</dt>
+<dd><p class="first">Convert a JSON string to a pointer to a NULL terminated UTF-8
+string and its length.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.6.</span></p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">n</span></tt> (null)</dt>
+<dd>Expect a JSON null value. Nothing is extracted.</dd>
+<dt><tt class="docutils literal"><span class="pre">b</span></tt> (boolean) [int]</dt>
+<dd>Convert a JSON boolean value to a C <tt class="xref c c-type docutils literal"><span class="pre">int</span></tt>, so that <tt class="docutils literal"><span class="pre">true</span></tt>
+is converted to 1 and <tt class="docutils literal"><span class="pre">false</span></tt> to 0.</dd>
+<dt><tt class="docutils literal"><span class="pre">i</span></tt> (integer) [int]</dt>
+<dd>Convert a JSON integer to C <tt class="xref c c-type docutils literal"><span class="pre">int</span></tt>.</dd>
+<dt><tt class="docutils literal"><span class="pre">I</span></tt> (integer) [json_int_t]</dt>
+<dd>Convert a JSON integer to C <a class="reference internal" href="#c.json_int_t" title="json_int_t"><tt class="xref c c-type docutils literal"><span class="pre">json_int_t</span></tt></a>.</dd>
+<dt><tt class="docutils literal"><span class="pre">f</span></tt> (real) [double]</dt>
+<dd>Convert a JSON real to C <tt class="xref c c-type docutils literal"><span class="pre">double</span></tt>.</dd>
+<dt><tt class="docutils literal"><span class="pre">F</span></tt> (integer or real) [double]</dt>
+<dd>Convert a JSON number (integer or real) to C <tt class="xref c c-type docutils literal"><span class="pre">double</span></tt>.</dd>
+<dt><tt class="docutils literal"><span class="pre">o</span></tt> (any value) [json_t *]</dt>
+<dd>Store a JSON value with no conversion to a <a class="reference internal" href="#c.json_t" title="json_t"><tt class="xref c c-type docutils literal"><span class="pre">json_t</span></tt></a> pointer.</dd>
+<dt><tt class="docutils literal"><span class="pre">O</span></tt> (any value) [json_t *]</dt>
+<dd>Like <tt class="docutils literal"><span class="pre">O</span></tt>, but the JSON value’s reference count is incremented.</dd>
+<dt><tt class="docutils literal"><span class="pre">[fmt]</span></tt> (array)</dt>
+<dd>Convert each item in the JSON array according to the inner format
+string. <tt class="docutils literal"><span class="pre">fmt</span></tt> may contain objects and arrays, i.e. recursive
+value extraction is supporetd.</dd>
+<dt><tt class="docutils literal"><span class="pre">{fmt}</span></tt> (object)</dt>
+<dd><p class="first">Convert each item in the JSON object according to the inner format
+string <tt class="docutils literal"><span class="pre">fmt</span></tt>. The first, third, etc. format specifier represent
+a key, and must be <tt class="docutils literal"><span class="pre">s</span></tt>. The corresponding argument to unpack
+functions is read as the object key. The second fourth, etc.
+format specifier represent a value and is written to the address
+given as the corresponding argument. <strong>Note</strong> that every other
+argument is read from and every other is written to.</p>
+<p><tt class="docutils literal"><span class="pre">fmt</span></tt> may contain objects and arrays as values, i.e. recursive
+value extraction is supporetd.</p>
+<div class="last versionadded">
+<p><span class="versionmodified">New in version 2.3: </span>Any <tt class="docutils literal"><span class="pre">s</span></tt> representing a key may be suffixed with a <tt class="docutils literal"><span class="pre">?</span></tt> to
+make the key optional. If the key is not found, nothing is
+extracted. See below for an example.</p>
+</div>
+</dd>
+<dt><tt class="docutils literal"><span class="pre">!</span></tt></dt>
+<dd>This special format specifier is used to enable the check that
+all object and array items are accessed, on a per-value basis. It
+must appear inside an array or object as the last format specifier
+before the closing bracket or brace. To enable the check globally,
+use the <tt class="docutils literal"><span class="pre">JSON_STRICT</span></tt> unpacking flag.</dd>
+<dt><tt class="docutils literal"><span class="pre">*</span></tt></dt>
+<dd>This special format specifier is the opposite of <tt class="docutils literal"><span class="pre">!</span></tt>. If the
+<tt class="docutils literal"><span class="pre">JSON_STRICT</span></tt> flag is used, <tt class="docutils literal"><span class="pre">*</span></tt> can be used to disable the
+strict check on a per-value basis. It must appear inside an array
+or object as the last format specifier before the closing bracket
+or brace.</dd>
+</dl>
+<p>Whitespace, <tt class="docutils literal"><span class="pre">:</span></tt> and <tt class="docutils literal"><span class="pre">,</span></tt> are ignored.</p>
+<p>The following functions compose the parsing and validation API:</p>
+<dl class="function">
+<dt id="c.json_unpack">
+int <tt class="descname">json_unpack</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *root</em>, const char<em> *fmt</em>, ...<big>)</big><a class="headerlink" href="#c.json_unpack" title="Permalink to this definition">¶</a></dt>
+<dd><p>Validate and unpack the JSON value <em>root</em> according to the format
+string <em>fmt</em>. Returns 0 on success and -1 on failure.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_unpack_ex">
+int <tt class="descname">json_unpack_ex</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *root</em>, <a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em>, size_t<em> flags</em>, const char<em> *fmt</em>, ...<big>)</big><a class="headerlink" href="#c.json_unpack_ex" title="Permalink to this definition">¶</a></dt>
+<dt id="c.json_vunpack_ex">
+int <tt class="descname">json_vunpack_ex</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *root</em>, <a class="reference internal" href="#c.json_error_t" title="json_error_t">json_error_t</a><em> *error</em>, size_t<em> flags</em>, const char<em> *fmt</em>, va_list<em> ap</em><big>)</big><a class="headerlink" href="#c.json_vunpack_ex" title="Permalink to this definition">¶</a></dt>
+<dd><p>Validate and unpack the JSON value <em>root</em> according to the format
+string <em>fmt</em>. If an error occurs and <em>error</em> is not <em>NULL</em>, write
+error information to <em>error</em>. <em>flags</em> can be used to control the
+behaviour of the unpacker, see below for the flags. Returns 0 on
+success and -1 on failure.</p>
+</dd></dl>
+
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p>The first argument of all unpack functions is <tt class="docutils literal"><span class="pre">json_t</span> <span class="pre">*root</span></tt>
+instead of <tt class="docutils literal"><span class="pre">const</span> <span class="pre">json_t</span> <span class="pre">*root</span></tt>, because the use of <tt class="docutils literal"><span class="pre">O</span></tt> format
+specifier causes the reference count of <tt class="docutils literal"><span class="pre">root</span></tt>, or some value
+reachable from <tt class="docutils literal"><span class="pre">root</span></tt>, to be increased. Furthermore, the <tt class="docutils literal"><span class="pre">o</span></tt>
+format specifier may be used to extract a value as-is, which allows
+modifying the structure or contents of a value reachable from
+<tt class="docutils literal"><span class="pre">root</span></tt>.</p>
+<p class="last">If the <tt class="docutils literal"><span class="pre">O</span></tt> and <tt class="docutils literal"><span class="pre">o</span></tt> format specifiers are not used, it’s
+perfectly safe to cast a <tt class="docutils literal"><span class="pre">const</span> <span class="pre">json_t</span> <span class="pre">*</span></tt> variable to plain
+<tt class="docutils literal"><span class="pre">json_t</span> <span class="pre">*</span></tt> when used with these functions.</p>
+</div>
+<p>The following unpacking flags are available:</p>
+<dl class="docutils">
+<dt><tt class="docutils literal"><span class="pre">JSON_STRICT</span></tt></dt>
+<dd>Enable the extra validation step checking that all object and
+array items are unpacked. This is equivalent to appending the
+format specifier <tt class="docutils literal"><span class="pre">!</span></tt> to the end of every array and object in the
+format string.</dd>
+<dt><tt class="docutils literal"><span class="pre">JSON_VALIDATE_ONLY</span></tt></dt>
+<dd>Don’t extract any data, just validate the JSON value against the
+given format string. Note that object keys must still be specified
+after the format string.</dd>
+</dl>
+<p>Examples:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cm">/* root is the JSON integer 42 */</span>
+<span class="kt">int</span> <span class="n">myint</span><span class="p">;</span>
+<span class="n">json_unpack</span><span class="p">(</span><span class="n">root</span><span class="p">,</span> <span class="s">"i"</span><span class="p">,</span> <span class="o">&</span><span class="n">myint</span><span class="p">);</span>
+<span class="n">assert</span><span class="p">(</span><span class="n">myint</span> <span class="o">==</span> <span class="mi">42</span><span class="p">);</span>
+
+<span class="cm">/* root is the JSON object {"foo": "bar", "quux": true} */</span>
+<span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">str</span><span class="p">;</span>
+<span class="kt">int</span> <span class="n">boolean</span><span class="p">;</span>
+<span class="n">json_unpack</span><span class="p">(</span><span class="n">root</span><span class="p">,</span> <span class="s">"{s:s, s:b}"</span><span class="p">,</span> <span class="s">"foo"</span><span class="p">,</span> <span class="o">&</span><span class="n">str</span><span class="p">,</span> <span class="s">"quux"</span><span class="p">,</span> <span class="o">&</span><span class="n">boolean</span><span class="p">);</span>
+<span class="n">assert</span><span class="p">(</span><span class="n">strcmp</span><span class="p">(</span><span class="n">str</span><span class="p">,</span> <span class="s">"bar"</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span> <span class="o">&&</span> <span class="n">boolean</span> <span class="o">==</span> <span class="mi">1</span><span class="p">);</span>
+
+<span class="cm">/* root is the JSON array [[1, 2], {"baz": null} */</span>
+<span class="kt">json_error_t</span> <span class="n">error</span><span class="p">;</span>
+<span class="n">json_unpack_ex</span><span class="p">(</span><span class="n">root</span><span class="p">,</span> <span class="o">&</span><span class="n">error</span><span class="p">,</span> <span class="n">JSON_VALIDATE_ONLY</span><span class="p">,</span> <span class="s">"[[i,i], {s:n}]"</span><span class="p">,</span> <span class="s">"baz"</span><span class="p">);</span>
+<span class="cm">/* returns 0 for validation success, nothing is extracted */</span>
+
+<span class="cm">/* root is the JSON array [1, 2, 3, 4, 5] */</span>
+<span class="kt">int</span> <span class="n">myint1</span><span class="p">,</span> <span class="n">myint2</span><span class="p">;</span>
+<span class="n">json_unpack</span><span class="p">(</span><span class="n">root</span><span class="p">,</span> <span class="s">"[ii!]"</span><span class="p">,</span> <span class="o">&</span><span class="n">myint1</span><span class="p">,</span> <span class="o">&</span><span class="n">myint2</span><span class="p">);</span>
+<span class="cm">/* returns -1 for failed validation */</span>
+
+<span class="cm">/* root is an empty JSON object */</span>
+<span class="kt">int</span> <span class="n">myint</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span> <span class="n">myint2</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span>
+<span class="n">json_unpack</span><span class="p">(</span><span class="n">root</span><span class="p">,</span> <span class="s">"{s?i, s?[ii]}"</span><span class="p">,</span>
+ <span class="s">"foo"</span><span class="p">,</span> <span class="o">&</span><span class="n">myint1</span><span class="p">,</span>
+ <span class="s">"bar"</span><span class="p">,</span> <span class="o">&</span><span class="n">myint2</span><span class="p">,</span> <span class="o">&</span><span class="n">myint3</span><span class="p">);</span>
+<span class="cm">/* myint1, myint2 or myint3 is no touched as "foo" and "bar" don't exist */</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="equality">
+<h2>Equality<a class="headerlink" href="#equality" title="Permalink to this headline">¶</a></h2>
+<p>Testing for equality of two JSON values cannot, in general, be
+achieved using the <tt class="docutils literal"><span class="pre">==</span></tt> operator. Equality in the terms of the
+<tt class="docutils literal"><span class="pre">==</span></tt> operator states that the two <a class="reference internal" href="#c.json_t" title="json_t"><tt class="xref c c-type docutils literal"><span class="pre">json_t</span></tt></a> pointers point to
+exactly the same JSON value. However, two JSON values can be equal not
+only if they are exactly the same value, but also if they have equal
+“contents”:</p>
+<ul class="simple">
+<li>Two integer or real values are equal if their contained numeric
+values are equal. An integer value is never equal to a real value,
+though.</li>
+<li>Two strings are equal if their contained UTF-8 strings are equal,
+byte by byte. Unicode comparison algorithms are not implemented.</li>
+<li>Two arrays are equal if they have the same number of elements and
+each element in the first array is equal to the corresponding
+element in the second array.</li>
+<li>Two objects are equal if they have exactly the same keys and the
+value for each key in the first object is equal to the value of the
+corresponding key in the second object.</li>
+<li>Two true, false or null values have no “contents”, so they are equal
+if their types are equal. (Because these values are singletons,
+their equality can actually be tested with <tt class="docutils literal"><span class="pre">==</span></tt>.)</li>
+</ul>
+<p>The following function can be used to test whether two JSON values are
+equal.</p>
+<dl class="function">
+<dt id="c.json_equal">
+int <tt class="descname">json_equal</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value1</em>, <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value2</em><big>)</big><a class="headerlink" href="#c.json_equal" title="Permalink to this definition">¶</a></dt>
+<dd><p>Returns 1 if <em>value1</em> and <em>value2</em> are equal, as defined above.
+Returns 0 if they are inequal or one or both of the pointers are
+<em>NULL</em>.</p>
+</dd></dl>
+
+</div>
+<div class="section" id="copying">
+<h2>Copying<a class="headerlink" href="#copying" title="Permalink to this headline">¶</a></h2>
+<p>Because of reference counting, passing JSON values around doesn’t
+require copying them. But sometimes a fresh copy of a JSON value is
+needed. For example, if you need to modify an array, but still want to
+use the original afterwards, you should take a copy of it first.</p>
+<p>Jansson supports two kinds of copying: shallow and deep. There is a
+difference between these methods only for arrays and objects. Shallow
+copying only copies the first level value (array or object) and uses
+the same child values in the copied value. Deep copying makes a fresh
+copy of the child values, too. Moreover, all the child values are deep
+copied in a recursive fashion.</p>
+<dl class="function">
+<dt id="c.json_copy">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_copy</tt><big>(</big><a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_copy" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns a shallow copy of <em>value</em>, or <em>NULL</em> on error.</p>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_deep_copy">
+<a class="reference internal" href="#c.json_t" title="json_t">json_t</a> *<tt class="descname">json_deep_copy</tt><big>(</big>const <a class="reference internal" href="#c.json_t" title="json_t">json_t</a><em> *value</em><big>)</big><a class="headerlink" href="#c.json_deep_copy" title="Permalink to this definition">¶</a></dt>
+<dd><em class="refcount">Return value: New reference.</em><p>Returns a deep copy of <em>value</em>, or <em>NULL</em> on error.</p>
+</dd></dl>
+
+</div>
+<div class="section" id="custom-memory-allocation">
+<span id="apiref-custom-memory-allocation"></span><h2>Custom Memory Allocation<a class="headerlink" href="#custom-memory-allocation" title="Permalink to this headline">¶</a></h2>
+<p>By default, Jansson uses <tt class="xref c c-func docutils literal"><span class="pre">malloc()</span></tt> and <tt class="xref c c-func docutils literal"><span class="pre">free()</span></tt> for
+memory allocation. These functions can be overridden if custom
+behavior is needed.</p>
+<dl class="type">
+<dt id="c.json_malloc_t">
+<tt class="descname">json_malloc_t</tt><a class="headerlink" href="#c.json_malloc_t" title="Permalink to this definition">¶</a></dt>
+<dd><p>A typedef for a function pointer with <tt class="xref c c-func docutils literal"><span class="pre">malloc()</span></tt>‘s
+signature:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="k">typedef</span> <span class="kt">void</span> <span class="o">*</span><span class="p">(</span><span class="o">*</span><span class="kt">json_malloc_t</span><span class="p">)(</span><span class="kt">size_t</span><span class="p">);</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="type">
+<dt id="c.json_free_t">
+<tt class="descname">json_free_t</tt><a class="headerlink" href="#c.json_free_t" title="Permalink to this definition">¶</a></dt>
+<dd><p>A typedef for a function pointer with <tt class="xref c c-func docutils literal"><span class="pre">free()</span></tt>‘s
+signature:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="k">typedef</span> <span class="nf">void</span> <span class="p">(</span><span class="o">*</span><span class="kt">json_free_t</span><span class="p">)(</span><span class="kt">void</span> <span class="o">*</span><span class="p">);</span>
+</pre></div>
+</div>
+</dd></dl>
+
+<dl class="function">
+<dt id="c.json_set_alloc_funcs">
+void <tt class="descname">json_set_alloc_funcs</tt><big>(</big><a class="reference internal" href="#c.json_malloc_t" title="json_malloc_t">json_malloc_t</a><em> malloc_fn</em>, <a class="reference internal" href="#c.json_free_t" title="json_free_t">json_free_t</a><em> free_fn</em><big>)</big><a class="headerlink" href="#c.json_set_alloc_funcs" title="Permalink to this definition">¶</a></dt>
+<dd><p>Use <em>malloc_fn</em> instead of <tt class="xref c c-func docutils literal"><span class="pre">malloc()</span></tt> and <em>free_fn</em> instead
+of <tt class="xref c c-func docutils literal"><span class="pre">free()</span></tt>. This function has to be called before any other
+Jansson’s API functions to ensure that all memory operations use
+the same functions.</p>
+</dd></dl>
+
+<p><strong>Examples:</strong></p>
+<p>Circumvent problems with different CRT heaps on Windows by using
+application’s <tt class="xref c c-func docutils literal"><span class="pre">malloc()</span></tt> and <tt class="xref c c-func docutils literal"><span class="pre">free()</span></tt>:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">json_set_alloc_funcs</span><span class="p">(</span><span class="n">malloc</span><span class="p">,</span> <span class="n">free</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Use the <a class="reference external" href="http://www.hpl.hp.com/personal/Hans_Boehm/gc/">Boehm’s conservative garbage collector</a> for memory
+operations:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">json_set_alloc_funcs</span><span class="p">(</span><span class="n">GC_malloc</span><span class="p">,</span> <span class="n">GC_free</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>Allow storing sensitive data (e.g. passwords or encryption keys) in
+JSON structures by zeroing all memory when freed:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="k">static</span> <span class="kt">void</span> <span class="o">*</span><span class="nf">secure_malloc</span><span class="p">(</span><span class="kt">size_t</span> <span class="n">size</span><span class="p">)</span>
+<span class="p">{</span>
+ <span class="cm">/* Store the memory area size in the beginning of the block */</span>
+ <span class="kt">void</span> <span class="o">*</span><span class="n">ptr</span> <span class="o">=</span> <span class="n">malloc</span><span class="p">(</span><span class="n">size</span> <span class="o">+</span> <span class="mi">8</span><span class="p">);</span>
+ <span class="o">*</span><span class="p">((</span><span class="kt">size_t</span> <span class="o">*</span><span class="p">)</span><span class="n">ptr</span><span class="p">)</span> <span class="o">=</span> <span class="n">size</span><span class="p">;</span>
+ <span class="k">return</span> <span class="n">ptr</span> <span class="o">+</span> <span class="mi">8</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="k">static</span> <span class="kt">void</span> <span class="nf">secure_free</span><span class="p">(</span><span class="kt">void</span> <span class="o">*</span><span class="n">ptr</span><span class="p">)</span>
+<span class="p">{</span>
+ <span class="kt">size_t</span> <span class="n">size</span><span class="p">;</span>
+
+ <span class="n">ptr</span> <span class="o">-=</span> <span class="mi">8</span><span class="p">;</span>
+ <span class="n">size</span> <span class="o">=</span> <span class="o">*</span><span class="p">((</span><span class="kt">size_t</span> <span class="o">*</span><span class="p">)</span><span class="n">ptr</span><span class="p">);</span>
+
+ <span class="n">guaranteed_memset</span><span class="p">(</span><span class="n">ptr</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="n">size</span> <span class="o">+</span> <span class="mi">8</span><span class="p">);</span>
+ <span class="n">free</span><span class="p">(</span><span class="n">ptr</span><span class="p">);</span>
+<span class="p">}</span>
+
+<span class="kt">int</span> <span class="nf">main</span><span class="p">()</span>
+<span class="p">{</span>
+ <span class="n">json_set_alloc_funcs</span><span class="p">(</span><span class="n">secure_malloc</span><span class="p">,</span> <span class="n">secure_free</span><span class="p">);</span>
+ <span class="cm">/* ... */</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>For more information about the issues of storing sensitive data in
+memory, see
+<a class="reference external" href="http://www.dwheeler.com/secure-programs/Secure-Programs-HOWTO/protect-secrets.html">http://www.dwheeler.com/secure-programs/Secure-Programs-HOWTO/protect-secrets.html</a>.
+The page also explains the <tt class="xref c c-func docutils literal"><span class="pre">guaranteed_memset()</span></tt> function used
+in the example and gives a sample implementation for it.</p>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="index.html">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">API Reference</a><ul>
+<li><a class="reference internal" href="#preliminaries">Preliminaries</a></li>
+<li><a class="reference internal" href="#library-version">Library Version</a></li>
+<li><a class="reference internal" href="#value-representation">Value Representation</a><ul>
+<li><a class="reference internal" href="#type">Type</a></li>
+<li><a class="reference internal" href="#reference-count">Reference Count</a></li>
+<li><a class="reference internal" href="#circular-references">Circular References</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#true-false-and-null">True, False and Null</a></li>
+<li><a class="reference internal" href="#string">String</a></li>
+<li><a class="reference internal" href="#number">Number</a></li>
+<li><a class="reference internal" href="#array">Array</a></li>
+<li><a class="reference internal" href="#object">Object</a></li>
+<li><a class="reference internal" href="#error-reporting">Error reporting</a></li>
+<li><a class="reference internal" href="#encoding">Encoding</a></li>
+<li><a class="reference internal" href="#decoding">Decoding</a></li>
+<li><a class="reference internal" href="#building-values">Building Values</a></li>
+<li><a class="reference internal" href="#parsing-and-validating-values">Parsing and Validating Values</a></li>
+<li><a class="reference internal" href="#equality">Equality</a></li>
+<li><a class="reference internal" href="#copying">Copying</a></li>
+<li><a class="reference internal" href="#custom-memory-allocation">Custom Memory Allocation</a></li>
+</ul>
+</li>
+</ul>
+
+ <h4>Previous topic</h4>
+ <p class="topless"><a href="portability.html"
+ title="previous chapter">Portability</a></p>
+ <h4>Next topic</h4>
+ <p class="topless"><a href="changes.html"
+ title="next chapter">Changes in Jansson</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/apiref.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="changes.html" title="Changes in Jansson"
+ >next</a> |</li>
+ <li class="right" >
+ <a href="portability.html" title="Portability"
+ >previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/changes.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,720 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Changes in Jansson — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ <link rel="prev" title="API Reference" href="apiref.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="apiref.html" title="API Reference"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="changes-in-jansson">
+<h1>Changes in Jansson<a class="headerlink" href="#changes-in-jansson" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="version-2-7">
+<h2>Version 2.7<a class="headerlink" href="#version-2-7" title="Permalink to this headline">¶</a></h2>
+<p>Released 2014-10-02</p>
+<ul class="simple">
+<li>New features:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_pack" title="json_pack"><tt class="xref c c-func docutils literal"><span class="pre">json_pack()</span></tt></a> and friends: Add format specifiers <tt class="docutils literal"><span class="pre">s%</span></tt> and <tt class="docutils literal"><span class="pre">+%</span></tt>
+for a size_t string length (#141).</li>
+<li><a class="reference internal" href="apiref.html#c.json_unpack" title="json_unpack"><tt class="xref c c-func docutils literal"><span class="pre">json_unpack()</span></tt></a> and friends: Add format specifier <tt class="docutils literal"><span class="pre">s%</span></tt> for
+unpacking the string length along with the string itself (#141).</li>
+<li>Add length-aware string constructors <a class="reference internal" href="apiref.html#c.json_stringn" title="json_stringn"><tt class="xref c c-func docutils literal"><span class="pre">json_stringn()</span></tt></a> and
+<a class="reference internal" href="apiref.html#c.json_stringn_nocheck" title="json_stringn_nocheck"><tt class="xref c c-func docutils literal"><span class="pre">json_stringn_nocheck()</span></tt></a>, length-aware string mutators
+<a class="reference internal" href="apiref.html#c.json_string_setn" title="json_string_setn"><tt class="xref c c-func docutils literal"><span class="pre">json_string_setn()</span></tt></a> and <a class="reference internal" href="apiref.html#c.json_string_setn_nocheck" title="json_string_setn_nocheck"><tt class="xref c c-func docutils literal"><span class="pre">json_string_setn_nocheck()</span></tt></a>, and a
+function for getting string’s length <a class="reference internal" href="apiref.html#c.json_string_length" title="json_string_length"><tt class="xref c c-func docutils literal"><span class="pre">json_string_length()</span></tt></a> (#141,
+#143).</li>
+<li>Support <tt class="docutils literal"><span class="pre">\u0000</span></tt> escapes in the decoder. The support can be
+enabled by using the <tt class="docutils literal"><span class="pre">JSON_ALLOW_NUL</span></tt> decoding flag (#141).</li>
+<li>Add <a class="reference internal" href="apiref.html#c.json_boolean_value" title="json_boolean_value"><tt class="xref c c-func docutils literal"><span class="pre">json_boolean_value()</span></tt></a> as an alias for <a class="reference internal" href="apiref.html#c.json_is_true" title="json_is_true"><tt class="xref c c-func docutils literal"><span class="pre">json_is_true()</span></tt></a>
+(#146).</li>
+<li>Add JSON_REAL_PRECISION encoding flag/macro for controlling real
+number precision (#178).</li>
+<li>Define the maximum indentation as JSON_MAX_INDENT (#191).</li>
+</ul>
+</li>
+<li>Bug fixes:<ul>
+<li>Some malformed <tt class="docutils literal"><span class="pre">\uNNNN</span></tt> escapes could crash the decoder with an
+assertion failure.</li>
+<li>Avoid integer overflows with very long strings in UTF-8 decoder and
+hashtable.</li>
+<li>Check for <em>NULL</em> key in <a class="reference internal" href="apiref.html#c.json_object_get" title="json_object_get"><tt class="xref c c-func docutils literal"><span class="pre">json_object_get()</span></tt></a> and
+<a class="reference internal" href="apiref.html#c.json_object_del" title="json_object_del"><tt class="xref c c-func docutils literal"><span class="pre">json_object_del()</span></tt></a> (#151).</li>
+<li>Enhance hashtable seeding on Windows (#162).</li>
+<li><a class="reference internal" href="apiref.html#c.json_unpack" title="json_unpack"><tt class="xref c c-func docutils literal"><span class="pre">json_unpack()</span></tt></a>: Allow mixing JSON_STRICT with optional keys
+(#162, #163).</li>
+<li>Fix int/int32 mismatch (#142).</li>
+<li>Parse subnormal numbers correctly (#202).</li>
+</ul>
+</li>
+<li>Build:<ul>
+<li>Remove VS2010 build files. CMake should be used on Windows instead
+(#165).</li>
+<li>Fix CMake build flags for MinGW (#193).</li>
+<li>Add CMake config files for find_package. Rename config.h to
+jansson_private_config.h (#157, #159).</li>
+<li>Make Valgrind checks work with CMake (#160).</li>
+<li>Fix feature checks to use correct __ATOMIC flags.</li>
+<li>Fix CMake checks for uint16_t and uint8_t support (#177).</li>
+<li>Make Jansson build on SmartOS/Solaris (#171).</li>
+<li>Work around a GCC bug on Solaris (#175).</li>
+<li>Fix autoreconf on Debian (#182).</li>
+<li>Don’t use GNU make specific export for global AM_CFLAGS (#203,
+#204).</li>
+<li>Fix building on Android using the supplied Android.mk (#166,
+#174).</li>
+<li>Android.mk: Add -DHAVE_STDINT_H to LOCAL_CFLAGS (#200).</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Document JANSSON_BUILD_SHARED_LIBS CMake option (#187).</li>
+</ul>
+</li>
+<li>Tests:<ul>
+<li>Close file handles correctly (#198).</li>
+</ul>
+</li>
+<li>Other changes:<ul>
+<li><tt class="docutils literal"><span class="pre">\uNNNN</span></tt> escapes are now encoded in upper case for better
+readability.</li>
+<li>Enable usage of AddressSanitizer (#180).</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-6">
+<h2>Version 2.6<a class="headerlink" href="#version-2-6" title="Permalink to this headline">¶</a></h2>
+<p>Released 2014-02-11</p>
+<ul class="simple">
+<li>Security:<ul>
+<li>CVE-2013-6401: The hash function used by the hashtable
+implementation has been changed, and is automatically seeded with
+random data when the first JSON object is created. This prevents
+an attacker from causing large JSON objects with specially crafted
+keys perform poorly.</li>
+</ul>
+</li>
+<li>New features:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_object_seed" title="json_object_seed"><tt class="xref c c-func docutils literal"><span class="pre">json_object_seed()</span></tt></a>: Set the seed value of the hash function.</li>
+</ul>
+</li>
+<li>Bug fixes:<ul>
+<li>Include CMake specific files in the release tarball.</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Fix tutorial source to send a User-Agent header, which is now
+required by the GitHub API.</li>
+<li>Set all memory to zero in secure_free() example.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-5">
+<h2>Version 2.5<a class="headerlink" href="#version-2-5" title="Permalink to this headline">¶</a></h2>
+<p>Released 2013-09-19</p>
+<ul class="simple">
+<li>New features:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_pack" title="json_pack"><tt class="xref c c-func docutils literal"><span class="pre">json_pack()</span></tt></a> and friends: Add format specifiers <tt class="docutils literal"><span class="pre">s#</span></tt>, <tt class="docutils literal"><span class="pre">+</span></tt> and
+<tt class="docutils literal"><span class="pre">+#</span></tt>.</li>
+<li>Add <tt class="docutils literal"><span class="pre">JSON_DECODE_INT_AS_REAL</span></tt> decoding flag to treat all numbers
+as real in the decoder (#123).</li>
+<li>Add <a class="reference internal" href="apiref.html#c.json_array_foreach" title="json_array_foreach"><tt class="xref c c-func docutils literal"><span class="pre">json_array_foreach()</span></tt></a>, paralleling <a class="reference internal" href="apiref.html#c.json_object_foreach" title="json_object_foreach"><tt class="xref c c-func docutils literal"><span class="pre">json_object_foreach()</span></tt></a>
+(#118).</li>
+</ul>
+</li>
+<li>Bug fixes:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_dumps" title="json_dumps"><tt class="xref c c-func docutils literal"><span class="pre">json_dumps()</span></tt></a> and friends: Don’t crash if json is <em>NULL</em> and
+<tt class="docutils literal"><span class="pre">JSON_ENCODE_ANY</span></tt> is set.</li>
+<li>Fix a theoretical integer overflow in <tt class="xref c c-func docutils literal"><span class="pre">jsonp_strdup()</span></tt>.</li>
+<li>Fix <tt class="xref c c-func docutils literal"><span class="pre">l_isxdigit()</span></tt> macro (#97).</li>
+<li>Fix an off-by-one error in <a class="reference internal" href="apiref.html#c.json_array_remove" title="json_array_remove"><tt class="xref c c-func docutils literal"><span class="pre">json_array_remove()</span></tt></a>.</li>
+</ul>
+</li>
+<li>Build:<ul>
+<li>Support CMake in addition to GNU Autotools (#106, #107, #112,
+#115, #120, #127).</li>
+<li>Support building for Android (#109).</li>
+<li>Don’t use <tt class="docutils literal"><span class="pre">-Werror</span></tt> by default.</li>
+<li>Support building and testing with VPATH (#93).</li>
+<li>Fix compilation when <tt class="docutils literal"><span class="pre">NDEBUG</span></tt> is defined (#128)</li>
+</ul>
+</li>
+<li>Tests:<ul>
+<li>Fix a refleak in <tt class="docutils literal"><span class="pre">test/bin/json_process.c</span></tt>.</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Clarify the return value of <a class="reference internal" href="apiref.html#c.json_load_callback_t" title="json_load_callback_t"><tt class="xref c c-func docutils literal"><span class="pre">json_load_callback_t()</span></tt></a>.</li>
+<li>Document how to circumvent problems with separate heaps on Windows.</li>
+<li>Fix memory leaks and warnings in <tt class="docutils literal"><span class="pre">github_commits.c</span></tt>.</li>
+<li>Use <a class="reference internal" href="apiref.html#c.json_decref" title="json_decref"><tt class="xref c c-func docutils literal"><span class="pre">json_decref()</span></tt></a> properly in tutorial.</li>
+</ul>
+</li>
+<li>Other:<ul>
+<li>Make it possible to forward declare <tt class="docutils literal"><span class="pre">struct</span> <span class="pre">json_t</span></tt>.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-4">
+<h2>Version 2.4<a class="headerlink" href="#version-2-4" title="Permalink to this headline">¶</a></h2>
+<p>Released 2012-09-23</p>
+<ul class="simple">
+<li>New features:<ul>
+<li>Add <a class="reference internal" href="apiref.html#c.json_boolean" title="json_boolean"><tt class="xref c c-func docutils literal"><span class="pre">json_boolean()</span></tt></a> macro that returns the JSON true or false
+value based on its argument (#86).</li>
+<li>Add <a class="reference internal" href="apiref.html#c.json_load_callback" title="json_load_callback"><tt class="xref c c-func docutils literal"><span class="pre">json_load_callback()</span></tt></a> that calls a callback function
+repeatedly to read the JSON input (#57).</li>
+<li>Add JSON_ESCAPE_SLASH encoding flag to escape all occurences of
+<tt class="docutils literal"><span class="pre">/</span></tt> with <tt class="docutils literal"><span class="pre">\/</span></tt>.</li>
+</ul>
+</li>
+<li>Bug fixes:<ul>
+<li>Check for and reject NaN and Inf values for reals. Encoding these
+values resulted in invalid JSON.</li>
+<li>Fix <a class="reference internal" href="apiref.html#c.json_real_set" title="json_real_set"><tt class="xref c c-func docutils literal"><span class="pre">json_real_set()</span></tt></a> to return -1 on error.</li>
+</ul>
+</li>
+<li>Build:<ul>
+<li>Jansson now builds on Windows with Visual Studio 2010, and
+includes solution and project files in <tt class="docutils literal"><span class="pre">win32/vs2010/</span></tt>
+directory.</li>
+<li>Fix build warnings (#77, #78).</li>
+<li>Add <tt class="docutils literal"><span class="pre">-no-undefined</span></tt> to LDFLAGS (#90).</li>
+</ul>
+</li>
+<li>Tests:<ul>
+<li>Fix the symbol exports test on Linux/PPC64 (#88).</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Fix typos (#73, #84).</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-3-1">
+<h2>Version 2.3.1<a class="headerlink" href="#version-2-3-1" title="Permalink to this headline">¶</a></h2>
+<p>Released 2012-04-20</p>
+<ul class="simple">
+<li>Build issues:<ul>
+<li>Only use <tt class="docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt> if <tt class="docutils literal"><span class="pre">strtoll()</span></tt> is also available.</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Fix the names of library version constants in documentation. (#52)</li>
+<li>Change the tutorial to use GitHub API v3. (#65)</li>
+</ul>
+</li>
+<li>Tests:<ul>
+<li>Make some tests locale independent. (#51)</li>
+<li>Distribute the library exports test in the tarball.</li>
+<li>Make test run on shells that don’t support the <tt class="docutils literal"><span class="pre">export</span> <span class="pre">FOO=bar</span></tt>
+syntax.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-3">
+<h2>Version 2.3<a class="headerlink" href="#version-2-3" title="Permalink to this headline">¶</a></h2>
+<p>Released 2012-01-27</p>
+<ul class="simple">
+<li>New features:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_unpack" title="json_unpack"><tt class="xref c c-func docutils literal"><span class="pre">json_unpack()</span></tt></a> and friends: Add support for optional object keys
+with the <tt class="docutils literal"><span class="pre">{s?o}</span></tt> syntax.</li>
+<li>Add <a class="reference internal" href="apiref.html#c.json_object_update_existing" title="json_object_update_existing"><tt class="xref c c-func docutils literal"><span class="pre">json_object_update_existing()</span></tt></a> and
+<a class="reference internal" href="apiref.html#c.json_object_update_missing" title="json_object_update_missing"><tt class="xref c c-func docutils literal"><span class="pre">json_object_update_missing()</span></tt></a>, for updating only existing keys or
+only adding missing keys to an object. (#37)</li>
+<li>Add <a class="reference internal" href="apiref.html#c.json_object_foreach" title="json_object_foreach"><tt class="xref c c-func docutils literal"><span class="pre">json_object_foreach()</span></tt></a> for more convenient iteration over
+objects. (#45, #46)</li>
+<li>When decoding JSON, write the number of bytes that were read from
+input to <tt class="docutils literal"><span class="pre">error.position</span></tt> also on success. This is handy with
+<tt class="docutils literal"><span class="pre">JSON_DISABLE_EOF_CHECK</span></tt>.</li>
+<li>Add support for decoding any JSON value, not just arrays or
+objects. The support is enabled with the new <tt class="docutils literal"><span class="pre">JSON_DECODE_ANY</span></tt>
+flag. Patch by Andrea Marchesini. (#4)</li>
+</ul>
+</li>
+<li>Bug fixes<ul>
+<li>Avoid problems with object’s serial number growing too big. (#40,
+#41)</li>
+<li>Decoding functions now return NULL if the first argument is NULL.
+Patch by Andrea Marchesini.</li>
+<li>Include <tt class="docutils literal"><span class="pre">jansson_config.h.win32</span></tt> in the distribution tarball.</li>
+<li>Remove <tt class="docutils literal"><span class="pre">+</span></tt> and leading zeros from exponents in the encoder.
+(#39)</li>
+<li>Make Jansson build and work on MinGW. (#39, #38)</li>
+</ul>
+</li>
+<li>Documentation<ul>
+<li>Note that the same JSON values must not be encoded in parallel by
+separate threads. (#42)</li>
+<li>Document MinGW support.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-2-1">
+<h2>Version 2.2.1<a class="headerlink" href="#version-2-2-1" title="Permalink to this headline">¶</a></h2>
+<p>Released 2011-10-06</p>
+<ul class="simple">
+<li>Bug fixes:<ul>
+<li>Fix real number encoding and decoding under non-C locales. (#32)</li>
+<li>Fix identifier decoding under non-UTF-8 locales. (#35)</li>
+<li><a class="reference internal" href="apiref.html#c.json_load_file" title="json_load_file"><tt class="xref c c-func docutils literal"><span class="pre">json_load_file()</span></tt></a>: Open the input file in binary mode for maximum
+compatiblity.</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Clarify the lifecycle of the result of the <tt class="docutils literal"><span class="pre">s</span></tt> fromat of
+<a class="reference internal" href="apiref.html#c.json_unpack" title="json_unpack"><tt class="xref c c-func docutils literal"><span class="pre">json_unpack()</span></tt></a>. (#31)</li>
+<li>Add some portability info. (#36)</li>
+<li>Little clarifications here and there.</li>
+</ul>
+</li>
+<li>Other:<ul>
+<li>Some style fixes, issues detected by static analyzers.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-2">
+<h2>Version 2.2<a class="headerlink" href="#version-2-2" title="Permalink to this headline">¶</a></h2>
+<p>Released 2011-09-03</p>
+<ul class="simple">
+<li>New features:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_dump_callback" title="json_dump_callback"><tt class="xref c c-func docutils literal"><span class="pre">json_dump_callback()</span></tt></a>: Pass the encoder output to a callback
+function in chunks.</li>
+</ul>
+</li>
+<li>Bug fixes:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_string_set" title="json_string_set"><tt class="xref c c-func docutils literal"><span class="pre">json_string_set()</span></tt></a>: Check that target is a string and value is
+not NULL.</li>
+</ul>
+</li>
+<li>Other:<ul>
+<li>Documentation typo fixes and clarifications.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-1">
+<h2>Version 2.1<a class="headerlink" href="#version-2-1" title="Permalink to this headline">¶</a></h2>
+<p>Released 2011-06-10</p>
+<ul class="simple">
+<li>New features:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_loadb" title="json_loadb"><tt class="xref c c-func docutils literal"><span class="pre">json_loadb()</span></tt></a>: Decode a string with a given size, useful if the
+string is not null terminated.</li>
+<li>Add <tt class="docutils literal"><span class="pre">JSON_ENCODE_ANY</span></tt> encoding flag to allow encoding any JSON
+value. By default, only arrays and objects can be encoded. (#19)</li>
+<li>Add <tt class="docutils literal"><span class="pre">JSON_REJECT_DUPLICATES</span></tt> decoding flag to issue a decoding
+error if any JSON object in the input contins duplicate keys. (#3)</li>
+<li>Add <tt class="docutils literal"><span class="pre">JSON_DISABLE_EOF_CHECK</span></tt> decoding flag to stop decoding after a
+valid JSON input. This allows other data after the JSON data.</li>
+</ul>
+</li>
+<li>Bug fixes:<ul>
+<li>Fix an additional memory leak when memory allocation fails in
+<a class="reference internal" href="apiref.html#c.json_object_set" title="json_object_set"><tt class="xref c c-func docutils literal"><span class="pre">json_object_set()</span></tt></a> and friends.</li>
+<li>Clear errno before calling <tt class="xref c c-func docutils literal"><span class="pre">strtod()</span></tt> for better portability. (#27)</li>
+</ul>
+</li>
+<li>Building:<ul>
+<li>Avoid set-but-not-used warning/error in a test. (#20)</li>
+</ul>
+</li>
+<li>Other:<ul>
+<li>Minor clarifications to documentation.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-0-1">
+<h2>Version 2.0.1<a class="headerlink" href="#version-2-0-1" title="Permalink to this headline">¶</a></h2>
+<p>Released 2011-03-31</p>
+<ul class="simple">
+<li>Bug fixes:<ul>
+<li>Replace a few <tt class="xref c c-func docutils literal"><span class="pre">malloc()</span></tt> and <tt class="xref c c-func docutils literal"><span class="pre">free()</span></tt> calls with their
+counterparts that support custom memory management.</li>
+<li>Fix object key hashing in json_unpack() strict checking mode.</li>
+<li>Fix the parentheses in <tt class="docutils literal"><span class="pre">JANSSON_VERSION_HEX</span></tt> macro.</li>
+<li>Fix <a class="reference internal" href="apiref.html#c.json_object_size" title="json_object_size"><tt class="xref c c-func docutils literal"><span class="pre">json_object_size()</span></tt></a> return value.</li>
+<li>Fix a few compilation issues.</li>
+</ul>
+</li>
+<li>Portability:<ul>
+<li>Enhance portability of <tt class="xref c c-func docutils literal"><span class="pre">va_copy()</span></tt>.</li>
+<li>Test framework portability enhancements.</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Distribute <tt class="docutils literal"><span class="pre">doc/upgrading.rst</span></tt> with the source tarball.</li>
+<li>Build documentation in strict mode in <tt class="docutils literal"><span class="pre">make</span> <span class="pre">distcheck</span></tt>.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-2-0">
+<h2>Version 2.0<a class="headerlink" href="#version-2-0" title="Permalink to this headline">¶</a></h2>
+<p>Released 2011-02-28</p>
+<p>This release is backwards incompatible with the 1.x release series.
+See the chapter “Upgrading from older versions” in documentation for
+details.</p>
+<ul class="simple">
+<li>Backwards incompatible changes:<ul>
+<li>Unify unsigned integer usage in the API: All occurences of
+unsigned int and unsigned long have been replaced with size_t.</li>
+<li>Change JSON integer’s underlying type to the widest signed integer
+type available, i.e. long long if it’s supported, otherwise long.
+Add a typedef json_int_t that defines the type.</li>
+<li>Change the maximum indentation depth to 31 spaces in encoder. This
+frees up bits from the flags parameter of encoding functions
+<a class="reference internal" href="apiref.html#c.json_dumpf" title="json_dumpf"><tt class="xref c c-func docutils literal"><span class="pre">json_dumpf()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_dumps" title="json_dumps"><tt class="xref c c-func docutils literal"><span class="pre">json_dumps()</span></tt></a> and <a class="reference internal" href="apiref.html#c.json_dump_file" title="json_dump_file"><tt class="xref c c-func docutils literal"><span class="pre">json_dump_file()</span></tt></a>.</li>
+<li>For future needs, add a flags parameter to all decoding functions
+<a class="reference internal" href="apiref.html#c.json_loadf" title="json_loadf"><tt class="xref c c-func docutils literal"><span class="pre">json_loadf()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_loads" title="json_loads"><tt class="xref c c-func docutils literal"><span class="pre">json_loads()</span></tt></a> and <a class="reference internal" href="apiref.html#c.json_load_file" title="json_load_file"><tt class="xref c c-func docutils literal"><span class="pre">json_load_file()</span></tt></a>.</li>
+</ul>
+</li>
+<li>New features<ul>
+<li><a class="reference internal" href="apiref.html#c.json_pack" title="json_pack"><tt class="xref c c-func docutils literal"><span class="pre">json_pack()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_pack_ex" title="json_pack_ex"><tt class="xref c c-func docutils literal"><span class="pre">json_pack_ex()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_vpack_ex" title="json_vpack_ex"><tt class="xref c c-func docutils literal"><span class="pre">json_vpack_ex()</span></tt></a>: Create JSON
+values based on a format string.</li>
+<li><a class="reference internal" href="apiref.html#c.json_unpack" title="json_unpack"><tt class="xref c c-func docutils literal"><span class="pre">json_unpack()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_unpack_ex" title="json_unpack_ex"><tt class="xref c c-func docutils literal"><span class="pre">json_unpack_ex()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_vunpack_ex" title="json_vunpack_ex"><tt class="xref c c-func docutils literal"><span class="pre">json_vunpack_ex()</span></tt></a>: Simple
+value extraction and validation functionality based on a format
+string.</li>
+<li>Add column, position and source fields to the <tt class="docutils literal"><span class="pre">json_error_t</span></tt>
+struct.</li>
+<li>Enhance error reporting in the decoder.</li>
+<li><tt class="docutils literal"><span class="pre">JANSSON_VERSION</span></tt> et al.: Preprocessor constants that define the
+library version.</li>
+<li><a class="reference internal" href="apiref.html#c.json_set_alloc_funcs" title="json_set_alloc_funcs"><tt class="xref c c-func docutils literal"><span class="pre">json_set_alloc_funcs()</span></tt></a>: Set custom memory allocation functions.</li>
+</ul>
+</li>
+<li>Fix many portability issues, especially on Windows.</li>
+<li>Configuration<ul>
+<li>Add file <tt class="docutils literal"><span class="pre">jansson_config.h</span></tt> that contains site specific
+configuration. It’s created automatically by the configure script,
+or can be created by hand if the configure script cannot be used.
+The file <tt class="docutils literal"><span class="pre">jansson_config.h.win32</span></tt> can be used without
+modifications on Windows systems.</li>
+<li>Add a section to documentation describing how to build Jansson on
+Windows.</li>
+<li>Documentation now requires Sphinx 1.0 or newer.</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-1-3">
+<h2>Version 1.3<a class="headerlink" href="#version-1-3" title="Permalink to this headline">¶</a></h2>
+<p>Released 2010-06-13</p>
+<ul class="simple">
+<li>New functions:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_object_iter_set" title="json_object_iter_set"><tt class="xref c c-func docutils literal"><span class="pre">json_object_iter_set()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_object_iter_set_new" title="json_object_iter_set_new"><tt class="xref c c-func docutils literal"><span class="pre">json_object_iter_set_new()</span></tt></a>: Change
+object contents while iterating over it.</li>
+<li><a class="reference internal" href="apiref.html#c.json_object_iter_at" title="json_object_iter_at"><tt class="xref c c-func docutils literal"><span class="pre">json_object_iter_at()</span></tt></a>: Return an iterator that points to a
+specific object item.</li>
+</ul>
+</li>
+<li>New encoding flags:<ul>
+<li><tt class="docutils literal"><span class="pre">JSON_PRESERVE_ORDER</span></tt>: Preserve the insertion order of object
+keys.</li>
+</ul>
+</li>
+<li>Bug fixes:<ul>
+<li>Fix an error that occured when an array or object was first
+encoded as empty, then populated with some data, and then
+re-encoded</li>
+<li>Fix the situation like above, but when the first encoding resulted
+in an error</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Clarify the documentation on reference stealing, providing an
+example usage pattern</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-1-2-1">
+<h2>Version 1.2.1<a class="headerlink" href="#version-1-2-1" title="Permalink to this headline">¶</a></h2>
+<p>Released 2010-04-03</p>
+<ul class="simple">
+<li>Bug fixes:<ul>
+<li>Fix reference counting on <tt class="docutils literal"><span class="pre">true</span></tt>, <tt class="docutils literal"><span class="pre">false</span></tt> and <tt class="docutils literal"><span class="pre">null</span></tt></li>
+<li>Estimate real number underflows in decoder with 0.0 instead of
+issuing an error</li>
+</ul>
+</li>
+<li>Portability:<ul>
+<li>Make <tt class="docutils literal"><span class="pre">int32_t</span></tt> available on all systems</li>
+<li>Support compilers that don’t have the <tt class="docutils literal"><span class="pre">inline</span></tt> keyword</li>
+<li>Require Autoconf 2.60 (for <tt class="docutils literal"><span class="pre">int32_t</span></tt>)</li>
+</ul>
+</li>
+<li>Tests:<ul>
+<li>Print test names correctly when <tt class="docutils literal"><span class="pre">VERBOSE=1</span></tt></li>
+<li><tt class="docutils literal"><span class="pre">test/suites/api</span></tt>: Fail when a test fails</li>
+<li>Enhance tests for iterators</li>
+<li>Enhance tests for decoding texts that contain null bytes</li>
+</ul>
+</li>
+<li>Documentation:<ul>
+<li>Don’t remove <tt class="docutils literal"><span class="pre">changes.rst</span></tt> in <tt class="docutils literal"><span class="pre">make</span> <span class="pre">clean</span></tt></li>
+<li>Add a chapter on RFC conformance</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-1-2">
+<h2>Version 1.2<a class="headerlink" href="#version-1-2" title="Permalink to this headline">¶</a></h2>
+<p>Released 2010-01-21</p>
+<ul class="simple">
+<li>New functions:<ul>
+<li><a class="reference internal" href="apiref.html#c.json_equal" title="json_equal"><tt class="xref c c-func docutils literal"><span class="pre">json_equal()</span></tt></a>: Test whether two JSON values are equal</li>
+<li><a class="reference internal" href="apiref.html#c.json_copy" title="json_copy"><tt class="xref c c-func docutils literal"><span class="pre">json_copy()</span></tt></a> and <a class="reference internal" href="apiref.html#c.json_deep_copy" title="json_deep_copy"><tt class="xref c c-func docutils literal"><span class="pre">json_deep_copy()</span></tt></a>: Make shallow and deep copies
+of JSON values</li>
+<li>Add a version of all functions taking a string argument that
+doesn’t check for valid UTF-8: <a class="reference internal" href="apiref.html#c.json_string_nocheck" title="json_string_nocheck"><tt class="xref c c-func docutils literal"><span class="pre">json_string_nocheck()</span></tt></a>,
+<a class="reference internal" href="apiref.html#c.json_string_set_nocheck" title="json_string_set_nocheck"><tt class="xref c c-func docutils literal"><span class="pre">json_string_set_nocheck()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_object_set_nocheck" title="json_object_set_nocheck"><tt class="xref c c-func docutils literal"><span class="pre">json_object_set_nocheck()</span></tt></a>,
+<a class="reference internal" href="apiref.html#c.json_object_set_new_nocheck" title="json_object_set_new_nocheck"><tt class="xref c c-func docutils literal"><span class="pre">json_object_set_new_nocheck()</span></tt></a></li>
+</ul>
+</li>
+<li>New encoding flags:<ul>
+<li><tt class="docutils literal"><span class="pre">JSON_SORT_KEYS</span></tt>: Sort objects by key</li>
+<li><tt class="docutils literal"><span class="pre">JSON_ENSURE_ASCII</span></tt>: Escape all non-ASCII Unicode characters</li>
+<li><tt class="docutils literal"><span class="pre">JSON_COMPACT</span></tt>: Use a compact representation with all unneeded
+whitespace stripped</li>
+</ul>
+</li>
+<li>Bug fixes:<ul>
+<li>Revise and unify whitespace usage in encoder: Add spaces between
+array and object items, never append newline to output.</li>
+<li>Remove const qualifier from the <tt class="docutils literal"><span class="pre">json_t</span></tt> parameter in
+<a class="reference internal" href="apiref.html#c.json_string_set" title="json_string_set"><tt class="xref c c-func docutils literal"><span class="pre">json_string_set()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_integer_set" title="json_integer_set"><tt class="xref c c-func docutils literal"><span class="pre">json_integer_set()</span></tt></a> and <a class="reference internal" href="apiref.html#c.json_real_set" title="json_real_set"><tt class="xref c c-func docutils literal"><span class="pre">json_real_set()</span></tt></a>.</li>
+<li>Use <tt class="docutils literal"><span class="pre">int32_t</span></tt> internally for representing Unicode code points
+(int is not enough on all platforms)</li>
+</ul>
+</li>
+<li>Other changes:<ul>
+<li>Convert <tt class="docutils literal"><span class="pre">CHANGES</span></tt> (this file) to reStructured text and add it to
+HTML documentation</li>
+<li>The test system has been refactored. Python is no longer required
+to run the tests.</li>
+<li>Documentation can now be built by invoking <tt class="docutils literal"><span class="pre">make</span> <span class="pre">html</span></tt></li>
+<li>Support for pkg-config</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="version-1-1-3">
+<h2>Version 1.1.3<a class="headerlink" href="#version-1-1-3" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-12-18</p>
+<ul class="simple">
+<li>Encode reals correctly, so that first encoding and then decoding a
+real always produces the same value</li>
+<li>Don’t export private symbols in <tt class="docutils literal"><span class="pre">libjansson.so</span></tt></li>
+</ul>
+</div>
+<div class="section" id="version-1-1-2">
+<h2>Version 1.1.2<a class="headerlink" href="#version-1-1-2" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-11-08</p>
+<ul class="simple">
+<li>Fix a bug where an error message was not produced if the input file
+could not be opened in <a class="reference internal" href="apiref.html#c.json_load_file" title="json_load_file"><tt class="xref c c-func docutils literal"><span class="pre">json_load_file()</span></tt></a></li>
+<li>Fix an assertion failure in decoder caused by a minus sign without a
+digit after it</li>
+<li>Remove an unneeded include of <tt class="docutils literal"><span class="pre">stdint.h</span></tt> in <tt class="docutils literal"><span class="pre">jansson.h</span></tt></li>
+</ul>
+</div>
+<div class="section" id="version-1-1-1">
+<h2>Version 1.1.1<a class="headerlink" href="#version-1-1-1" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-10-26</p>
+<ul class="simple">
+<li>All documentation files were not distributed with v1.1; build
+documentation in make distcheck to prevent this in the future</li>
+<li>Fix v1.1 release date in <tt class="docutils literal"><span class="pre">CHANGES</span></tt></li>
+</ul>
+</div>
+<div class="section" id="version-1-1">
+<h2>Version 1.1<a class="headerlink" href="#version-1-1" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-10-20</p>
+<ul class="simple">
+<li>API additions and improvements:<ul>
+<li>Extend array and object APIs</li>
+<li>Add functions to modify integer, real and string values</li>
+<li>Improve argument validation</li>
+<li>Use unsigned int instead of <tt class="docutils literal"><span class="pre">uint32_t</span></tt> for encoding flags</li>
+</ul>
+</li>
+<li>Enhance documentation<ul>
+<li>Add getting started guide and tutorial</li>
+<li>Fix some typos</li>
+<li>General clarifications and cleanup</li>
+</ul>
+</li>
+<li>Check for integer and real overflows and underflows in decoder</li>
+<li>Make singleton values thread-safe (<tt class="docutils literal"><span class="pre">true</span></tt>, <tt class="docutils literal"><span class="pre">false</span></tt> and <tt class="docutils literal"><span class="pre">null</span></tt>)</li>
+<li>Enhance circular reference handling</li>
+<li>Don’t define <tt class="docutils literal"><span class="pre">-std=c99</span></tt> in <tt class="docutils literal"><span class="pre">AM_CFLAGS</span></tt></li>
+<li>Add C++ guards to <tt class="docutils literal"><span class="pre">jansson.h</span></tt></li>
+<li>Minor performance and portability improvements</li>
+<li>Expand test coverage</li>
+</ul>
+</div>
+<div class="section" id="version-1-0-4">
+<h2>Version 1.0.4<a class="headerlink" href="#version-1-0-4" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-10-11</p>
+<ul class="simple">
+<li>Relax Autoconf version requirement to 2.59</li>
+<li>Make Jansson compile on platforms where plain <tt class="docutils literal"><span class="pre">char</span></tt> is unsigned</li>
+<li>Fix API tests for object</li>
+</ul>
+</div>
+<div class="section" id="version-1-0-3">
+<h2>Version 1.0.3<a class="headerlink" href="#version-1-0-3" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-09-14</p>
+<ul class="simple">
+<li>Check for integer and real overflows and underflows in decoder</li>
+<li>Use the Python json module for tests, or simplejson if the json
+module is not found</li>
+<li>Distribute changelog (this file)</li>
+</ul>
+</div>
+<div class="section" id="version-1-0-2">
+<h2>Version 1.0.2<a class="headerlink" href="#version-1-0-2" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-09-08</p>
+<ul class="simple">
+<li>Handle EOF correctly in decoder</li>
+</ul>
+</div>
+<div class="section" id="version-1-0-1">
+<h2>Version 1.0.1<a class="headerlink" href="#version-1-0-1" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-09-04</p>
+<ul class="simple">
+<li>Fixed broken <a class="reference internal" href="apiref.html#c.json_is_boolean" title="json_is_boolean"><tt class="xref c c-func docutils literal"><span class="pre">json_is_boolean()</span></tt></a></li>
+</ul>
+</div>
+<div class="section" id="version-1-0">
+<h2>Version 1.0<a class="headerlink" href="#version-1-0" title="Permalink to this headline">¶</a></h2>
+<p>Released 2009-08-25</p>
+<ul class="simple">
+<li>Initial release</li>
+</ul>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="index.html">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">Changes in Jansson</a><ul>
+<li><a class="reference internal" href="#version-2-7">Version 2.7</a></li>
+<li><a class="reference internal" href="#version-2-6">Version 2.6</a></li>
+<li><a class="reference internal" href="#version-2-5">Version 2.5</a></li>
+<li><a class="reference internal" href="#version-2-4">Version 2.4</a></li>
+<li><a class="reference internal" href="#version-2-3-1">Version 2.3.1</a></li>
+<li><a class="reference internal" href="#version-2-3">Version 2.3</a></li>
+<li><a class="reference internal" href="#version-2-2-1">Version 2.2.1</a></li>
+<li><a class="reference internal" href="#version-2-2">Version 2.2</a></li>
+<li><a class="reference internal" href="#version-2-1">Version 2.1</a></li>
+<li><a class="reference internal" href="#version-2-0-1">Version 2.0.1</a></li>
+<li><a class="reference internal" href="#version-2-0">Version 2.0</a></li>
+<li><a class="reference internal" href="#version-1-3">Version 1.3</a></li>
+<li><a class="reference internal" href="#version-1-2-1">Version 1.2.1</a></li>
+<li><a class="reference internal" href="#version-1-2">Version 1.2</a></li>
+<li><a class="reference internal" href="#version-1-1-3">Version 1.1.3</a></li>
+<li><a class="reference internal" href="#version-1-1-2">Version 1.1.2</a></li>
+<li><a class="reference internal" href="#version-1-1-1">Version 1.1.1</a></li>
+<li><a class="reference internal" href="#version-1-1">Version 1.1</a></li>
+<li><a class="reference internal" href="#version-1-0-4">Version 1.0.4</a></li>
+<li><a class="reference internal" href="#version-1-0-3">Version 1.0.3</a></li>
+<li><a class="reference internal" href="#version-1-0-2">Version 1.0.2</a></li>
+<li><a class="reference internal" href="#version-1-0-1">Version 1.0.1</a></li>
+<li><a class="reference internal" href="#version-1-0">Version 1.0</a></li>
+</ul>
+</li>
+</ul>
+
+ <h4>Previous topic</h4>
+ <p class="topless"><a href="apiref.html"
+ title="previous chapter">API Reference</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/changes.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="apiref.html" title="API Reference"
+ >previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/conformance.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,211 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>RFC Conformance — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ <link rel="next" title="Portability" href="portability.html" />
+ <link rel="prev" title="Tutorial" href="tutorial.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="portability.html" title="Portability"
+ accesskey="N">next</a> |</li>
+ <li class="right" >
+ <a href="tutorial.html" title="Tutorial"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="rfc-conformance">
+<span id="id1"></span><h1>RFC Conformance<a class="headerlink" href="#rfc-conformance" title="Permalink to this headline">¶</a></h1>
+<p>JSON is specified in <span class="target" id="index-0"></span><a class="rfc reference external" href="http://tools.ietf.org/html/rfc4627.html"><strong>RFC 4627</strong></a>, <em>“The application/json Media Type
+for JavaScript Object Notation (JSON)”</em>.</p>
+<div class="section" id="character-encoding">
+<h2>Character Encoding<a class="headerlink" href="#character-encoding" title="Permalink to this headline">¶</a></h2>
+<p>Jansson only supports UTF-8 encoded JSON texts. It does not support or
+auto-detect any of the other encodings mentioned in the RFC, namely
+UTF-16LE, UTF-16BE, UTF-32LE or UTF-32BE. Pure ASCII is supported, as
+it’s a subset of UTF-8.</p>
+</div>
+<div class="section" id="strings">
+<h2>Strings<a class="headerlink" href="#strings" title="Permalink to this headline">¶</a></h2>
+<p>JSON strings are mapped to C-style null-terminated character arrays,
+and UTF-8 encoding is used internally.</p>
+<p>All Unicode codepoints U+0000 through U+10FFFF are allowed in string
+values. However, U+0000 is not allowed in object keys because of API
+restrictions.</p>
+<p>Unicode normalization or any other transformation is never performed
+on any strings (string values or object keys). When checking for
+equivalence of strings or object keys, the comparison is performed
+byte by byte between the original UTF-8 representations of the
+strings.</p>
+</div>
+<div class="section" id="numbers">
+<h2>Numbers<a class="headerlink" href="#numbers" title="Permalink to this headline">¶</a></h2>
+<div class="section" id="real-vs-integer">
+<span id="id2"></span><h3>Real vs. Integer<a class="headerlink" href="#real-vs-integer" title="Permalink to this headline">¶</a></h3>
+<p>JSON makes no distinction between real and integer numbers; Jansson
+does. Real numbers are mapped to the <tt class="docutils literal"><span class="pre">double</span></tt> type and integers to
+the <tt class="docutils literal"><span class="pre">json_int_t</span></tt> type, which is a typedef of <tt class="docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt> or
+<tt class="docutils literal"><span class="pre">long</span></tt>, depending on whether <tt class="docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt> is supported by your
+compiler or not.</p>
+<p>A JSON number is considered to be a real number if its lexical
+representation includes one of <tt class="docutils literal"><span class="pre">e</span></tt>, <tt class="docutils literal"><span class="pre">E</span></tt>, or <tt class="docutils literal"><span class="pre">.</span></tt>; regardless if
+its actual numeric value is a true integer (e.g., all of <tt class="docutils literal"><span class="pre">1E6</span></tt>,
+<tt class="docutils literal"><span class="pre">3.0</span></tt>, <tt class="docutils literal"><span class="pre">400E-2</span></tt>, and <tt class="docutils literal"><span class="pre">3.14E3</span></tt> are mathematical integers, but
+will be treated as real values). With the <tt class="docutils literal"><span class="pre">JSON_DECODE_INT_AS_REAL</span></tt>
+decoder flag set all numbers are interpreted as real.</p>
+<p>All other JSON numbers are considered integers.</p>
+<p>When encoding to JSON, real values are always represented
+with a fractional part; e.g., the <tt class="docutils literal"><span class="pre">double</span></tt> value 3.0 will be
+represented in JSON as <tt class="docutils literal"><span class="pre">3.0</span></tt>, not <tt class="docutils literal"><span class="pre">3</span></tt>.</p>
+</div>
+<div class="section" id="overflow-underflow-precision">
+<h3>Overflow, Underflow & Precision<a class="headerlink" href="#overflow-underflow-precision" title="Permalink to this headline">¶</a></h3>
+<p>Real numbers whose absolute values are too small to be represented in
+a C <tt class="docutils literal"><span class="pre">double</span></tt> will be silently estimated with 0.0. Thus, depending on
+platform, JSON numbers very close to zero such as 1E-999 may result in
+0.0.</p>
+<p>Real numbers whose absolute values are too large to be represented in
+a C <tt class="docutils literal"><span class="pre">double</span></tt> will result in an overflow error (a JSON decoding
+error). Thus, depending on platform, JSON numbers like 1E+999 or
+-1E+999 may result in a parsing error.</p>
+<p>Likewise, integer numbers whose absolute values are too large to be
+represented in the <tt class="docutils literal"><span class="pre">json_int_t</span></tt> type (see above) will result in an
+overflow error (a JSON decoding error). Thus, depending on platform,
+JSON numbers like 1000000000000000 may result in parsing error.</p>
+<p>Parsing JSON real numbers may result in a loss of precision. As long
+as overflow does not occur (i.e. a total loss of precision), the
+rounded approximate value is silently used. Thus the JSON number
+1.000000000000000005 may, depending on platform, result in the
+<tt class="docutils literal"><span class="pre">double</span></tt> value 1.0.</p>
+</div>
+<div class="section" id="signed-zeros">
+<h3>Signed zeros<a class="headerlink" href="#signed-zeros" title="Permalink to this headline">¶</a></h3>
+<p>JSON makes no statement about what a number means; however Javascript
+(ECMAscript) does state that +0.0 and -0.0 must be treated as being
+distinct values, i.e. -0.0 ≠0.0. Jansson relies on the
+underlying floating point library in the C environment in which it is
+compiled. Therefore it is platform-dependent whether 0.0 and -0.0 will
+be distinct values. Most platforms that use the IEEE 754
+floating-point standard will support signed zeros.</p>
+<p>Note that this only applies to floating-point; neither JSON, C, or
+IEEE support the concept of signed integer zeros.</p>
+</div>
+<div class="section" id="types">
+<h3>Types<a class="headerlink" href="#types" title="Permalink to this headline">¶</a></h3>
+<p>No support is provided in Jansson for any C numeric types other than
+<tt class="docutils literal"><span class="pre">json_int_t</span></tt> and <tt class="docutils literal"><span class="pre">double</span></tt>. This excludes things such as unsigned
+types, <tt class="docutils literal"><span class="pre">long</span> <span class="pre">double</span></tt>, etc. Obviously, shorter types like <tt class="docutils literal"><span class="pre">short</span></tt>,
+<tt class="docutils literal"><span class="pre">int</span></tt>, <tt class="docutils literal"><span class="pre">long</span></tt> (if <tt class="docutils literal"><span class="pre">json_int_t</span></tt> is <tt class="docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt>) and <tt class="docutils literal"><span class="pre">float</span></tt>
+are implicitly handled via the ordinary C type coercion rules (subject
+to overflow semantics). Also, no support or hooks are provided for any
+supplemental “bignum” type add-on packages.</p>
+</div>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="index.html">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">RFC Conformance</a><ul>
+<li><a class="reference internal" href="#character-encoding">Character Encoding</a></li>
+<li><a class="reference internal" href="#strings">Strings</a></li>
+<li><a class="reference internal" href="#numbers">Numbers</a><ul>
+<li><a class="reference internal" href="#real-vs-integer">Real vs. Integer</a></li>
+<li><a class="reference internal" href="#overflow-underflow-precision">Overflow, Underflow & Precision</a></li>
+<li><a class="reference internal" href="#signed-zeros">Signed zeros</a></li>
+<li><a class="reference internal" href="#types">Types</a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+
+ <h4>Previous topic</h4>
+ <p class="topless"><a href="tutorial.html"
+ title="previous chapter">Tutorial</a></p>
+ <h4>Next topic</h4>
+ <p class="topless"><a href="portability.html"
+ title="next chapter">Portability</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/conformance.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="portability.html" title="Portability"
+ >next</a> |</li>
+ <li class="right" >
+ <a href="tutorial.html" title="Tutorial"
+ >previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/genindex.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,519 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Index — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="#" title="General Index"
+ accesskey="I">index</a></li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+
+<h1 id="index">Index</h1>
+
+<div class="genindex-jumpbox">
+ <a href="#J"><strong>J</strong></a>
+ | <a href="#R"><strong>R</strong></a>
+
+</div>
+<h2 id="J">J</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a href="apiref.html#c.json_array">json_array (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_append">json_array_append (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_append_new">json_array_append_new (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_clear">json_array_clear (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_extend">json_array_extend (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_foreach">json_array_foreach (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_get">json_array_get (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_insert">json_array_insert (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_insert_new">json_array_insert_new (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_remove">json_array_remove (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_set">json_array_set (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_set_new">json_array_set_new (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_array_size">json_array_size (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_boolean">json_boolean (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_boolean_value">json_boolean_value (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_copy">json_copy (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_decref">json_decref (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_deep_copy">json_deep_copy (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_dump_callback">json_dump_callback (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_dump_callback_t">json_dump_callback_t (C type)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_dump_file">json_dump_file (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_dumpf">json_dumpf (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_dumps">json_dumps (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_equal">json_equal (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_error_t">json_error_t (C type)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_error_t.column">json_error_t.column (C member)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_error_t.line">json_error_t.line (C member)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_error_t.position">json_error_t.position (C member)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_false">json_false (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_free_t">json_free_t (C type)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_incref">json_incref (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_int_t">json_int_t (C type)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_integer">json_integer (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_integer_set">json_integer_set (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_integer_value">json_integer_value (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_array">json_is_array (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_boolean">json_is_boolean (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_false">json_is_false (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_integer">json_is_integer (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_null">json_is_null (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_number">json_is_number (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_object">json_is_object (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_real">json_is_real (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_string">json_is_string (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_is_true">json_is_true (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_load_callback">json_load_callback (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_load_callback_t">json_load_callback_t (C type)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_load_file">json_load_file (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_loadb">json_loadb (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_loadf">json_loadf (C function)</a>
+ </dt>
+
+ </dl></td>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt><a href="apiref.html#c.json_loads">json_loads (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_malloc_t">json_malloc_t (C type)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_null">json_null (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_number_value">json_number_value (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object">json_object (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_clear">json_object_clear (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_del">json_object_del (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_foreach">json_object_foreach (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_get">json_object_get (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_iter">json_object_iter (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_iter_at">json_object_iter_at (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_iter_key">json_object_iter_key (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_iter_next">json_object_iter_next (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_iter_set">json_object_iter_set (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_iter_set_new">json_object_iter_set_new (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_iter_value">json_object_iter_value (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_key_to_iter">json_object_key_to_iter (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_seed">json_object_seed (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_set">json_object_set (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_set_new">json_object_set_new (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_set_new_nocheck">json_object_set_new_nocheck (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_set_nocheck">json_object_set_nocheck (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_size">json_object_size (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_update">json_object_update (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_update_existing">json_object_update_existing (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_object_update_missing">json_object_update_missing (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_pack">json_pack (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_pack_ex">json_pack_ex (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_real">json_real (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_real_set">json_real_set (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_real_value">json_real_value (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_set_alloc_funcs">json_set_alloc_funcs (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_string">json_string (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_string_length">json_string_length (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_string_nocheck">json_string_nocheck (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_string_set">json_string_set (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_string_set_nocheck">json_string_set_nocheck (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_string_setn">json_string_setn (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_string_setn_nocheck">json_string_setn_nocheck (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_string_value">json_string_value (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_stringn">json_stringn (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_stringn_nocheck">json_stringn_nocheck (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_t">json_t (C type)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_true">json_true (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_type">json_type (C type)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_typeof">json_typeof (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_unpack">json_unpack (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_unpack_ex">json_unpack_ex (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_vpack_ex">json_vpack_ex (C function)</a>
+ </dt>
+
+
+ <dt><a href="apiref.html#c.json_vunpack_ex">json_vunpack_ex (C function)</a>
+ </dt>
+
+ </dl></td>
+</tr></table>
+
+<h2 id="R">R</h2>
+<table style="width: 100%" class="indextable genindextable"><tr>
+ <td style="width: 33%" valign="top"><dl>
+
+ <dt>
+ RFC
+ </dt>
+
+ <dd><dl>
+
+ <dt><a href="apiref.html#index-0">RFC 4627</a>, <a href="apiref.html#index-1">[1]</a>, <a href="apiref.html#index-2">[2]</a>, <a href="conformance.html#index-0">[3]</a>
+ </dt>
+
+ </dl></dd>
+ </dl></td>
+</tr></table>
+
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+
+
+
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="#" title="General Index"
+ >index</a></li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/gettingstarted.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,324 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Getting Started — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ <link rel="next" title="Upgrading from 1.x" href="upgrading.html" />
+ <link rel="prev" title="Jansson Documentation" href="index.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="upgrading.html" title="Upgrading from 1.x"
+ accesskey="N">next</a> |</li>
+ <li class="right" >
+ <a href="index.html" title="Jansson Documentation"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="getting-started">
+<h1>Getting Started<a class="headerlink" href="#getting-started" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="compiling-and-installing-jansson">
+<h2>Compiling and Installing Jansson<a class="headerlink" href="#compiling-and-installing-jansson" title="Permalink to this headline">¶</a></h2>
+<p>The Jansson source is available at
+<a class="reference external" href="http://www.digip.org/jansson/releases/">http://www.digip.org/jansson/releases/</a>.</p>
+<div class="section" id="unix-like-systems-including-mingw">
+<h3>Unix-like systems (including MinGW)<a class="headerlink" href="#unix-like-systems-including-mingw" title="Permalink to this headline">¶</a></h3>
+<p>Unpack the source tarball and change to the source directory:</p>
+<pre class="literal-block">
+bunzip2 -c jansson-2.7.tar.bz2 | tar xf -
+cd jansson-2.7
+</pre>
+<p>The source uses GNU Autotools (<a class="reference external" href="http://www.gnu.org/software/autoconf/">autoconf</a>, <a class="reference external" href="http://www.gnu.org/software/automake/">automake</a>, <a class="reference external" href="http://www.gnu.org/software/libtool/">libtool</a>), so
+compiling and installing is extremely simple:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="p">.</span><span class="o">/</span><span class="n">configure</span>
+<span class="n">make</span>
+<span class="n">make</span> <span class="n">check</span>
+<span class="n">make</span> <span class="n">install</span>
+</pre></div>
+</div>
+<p>To change the destination directory (<tt class="docutils literal"><span class="pre">/usr/local</span></tt> by default), use
+the <tt class="docutils literal"><span class="pre">--prefix=DIR</span></tt> argument to <tt class="docutils literal"><span class="pre">./configure</span></tt>. See <tt class="docutils literal"><span class="pre">./configure</span>
+<span class="pre">--help</span></tt> for the list of all possible installation options. (There are
+no options to customize the resulting Jansson binary.)</p>
+<p>The command <tt class="docutils literal"><span class="pre">make</span> <span class="pre">check</span></tt> runs the test suite distributed with
+Jansson. This step is not strictly necessary, but it may find possible
+problems that Jansson has on your platform. If any problems are found,
+please report them.</p>
+<p>If you obtained the source from a Git repository (or any other source
+control system), there’s no <tt class="docutils literal"><span class="pre">./configure</span></tt> script as it’s not kept in
+version control. To create the script, the build system needs to be
+bootstrapped. There are many ways to do this, but the easiest one is
+to use <tt class="docutils literal"><span class="pre">autoreconf</span></tt>:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">autoreconf</span> <span class="o">-</span><span class="n">vi</span>
+</pre></div>
+</div>
+<p>This command creates the <tt class="docutils literal"><span class="pre">./configure</span></tt> script, which can then be
+used as described above.</p>
+</div>
+<div class="section" id="cmake-various-platforms-including-windows">
+<span id="build-cmake"></span><h3>CMake (various platforms, including Windows)<a class="headerlink" href="#cmake-various-platforms-including-windows" title="Permalink to this headline">¶</a></h3>
+<p>Jansson can be built using <a class="reference external" href="http://www.cmake.org">CMake</a>. Create a build directory for an
+out-of-tree build, change to that directory, and run <tt class="docutils literal"><span class="pre">cmake</span></tt> (or <tt class="docutils literal"><span class="pre">ccmake</span></tt>,
+<tt class="docutils literal"><span class="pre">cmake-gui</span></tt>, or similar) to configure the project.</p>
+<p>See the examples below for more detailed information.</p>
+<div class="admonition note">
+<p class="first admonition-title">Note</p>
+<p class="last">In the below examples <tt class="docutils literal"><span class="pre">..</span></tt> is used as an argument for <tt class="docutils literal"><span class="pre">cmake</span></tt>.
+This is simply the path to the jansson project root directory.
+In the example it is assumed you’ve created a sub-directory <tt class="docutils literal"><span class="pre">build</span></tt>
+and are using that. You could use any path you want.</p>
+</div>
+<div class="section" id="unix-make-files">
+<span id="build-cmake-unix"></span><h4>Unix (Make files)<a class="headerlink" href="#unix-make-files" title="Permalink to this headline">¶</a></h4>
+<p>Generating make files on unix:</p>
+<pre class="literal-block">
+bunzip2 -c jansson-2.7.tar.bz2 | tar xf -
+cd jansson-2.7
+
+mkdir build
+cd build
+cmake .. # or <tt class="xref c c-func docutils literal"><span class="pre">ccmake</span> <span class="pre">..()</span></tt> for a GUI.
+</pre>
+<p>Then to build:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">make</span>
+<span class="n">make</span> <span class="n">check</span>
+<span class="n">make</span> <span class="n">install</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="windows-visual-studio">
+<h4>Windows (Visual Studio)<a class="headerlink" href="#windows-visual-studio" title="Permalink to this headline">¶</a></h4>
+<p>Creating Visual Studio project files from the command line:</p>
+<pre class="literal-block">
+<unpack>
+cd jansson-2.7
+
+md build
+cd build
+cmake -G "Visual Studio 10" ..
+</pre>
+<p>You will now have a <em>Visual Studio Solution</em> in your build directory.
+To run the unit tests build the <tt class="docutils literal"><span class="pre">RUN_TESTS</span></tt> project.</p>
+<p>If you prefer a GUI the <tt class="docutils literal"><span class="pre">cmake</span></tt> line in the above example can
+be replaced with:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">cmake</span><span class="o">-</span><span class="n">gui</span> <span class="p">..</span>
+</pre></div>
+</div>
+<p>For command line help (including a list of available generators)
+for <a class="reference external" href="http://www.cmake.org">CMake</a> simply run:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">cmake</span>
+</pre></div>
+</div>
+<p>To list available <a class="reference external" href="http://www.cmake.org">CMake</a> settings (and what they are currently set to)
+for the project, run:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">cmake</span> <span class="o">-</span><span class="n">LH</span> <span class="p">..</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="mac-osx-xcode">
+<h4>Mac OSX (Xcode)<a class="headerlink" href="#mac-osx-xcode" title="Permalink to this headline">¶</a></h4>
+<p>If you prefer using Xcode instead of make files on OSX,
+do the following. (Use the same steps as
+for <a class="reference internal" href="#build-cmake-unix"><em>Unix</em></a>):</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="p">...</span>
+<span class="n">cmake</span> <span class="o">-</span><span class="n">G</span> <span class="s">"Xcode"</span> <span class="p">..</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="additional-cmake-settings">
+<h4>Additional CMake settings<a class="headerlink" href="#additional-cmake-settings" title="Permalink to this headline">¶</a></h4>
+<div class="section" id="shared-library">
+<h5>Shared library<a class="headerlink" href="#shared-library" title="Permalink to this headline">¶</a></h5>
+<p>By default the <a class="reference external" href="http://www.cmake.org">CMake</a> project will generate build files for building the
+static library. To build the shared version use:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="p">...</span>
+<span class="n">cmake</span> <span class="o">-</span><span class="n">DJANSSON_BUILD_SHARED_LIBS</span><span class="o">=</span><span class="mi">1</span> <span class="p">..</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="changing-install-directory-same-as-autoconf-prefix">
+<h5>Changing install directory (same as autoconf –prefix)<a class="headerlink" href="#changing-install-directory-same-as-autoconf-prefix" title="Permalink to this headline">¶</a></h5>
+<p>Just as with the <a class="reference external" href="http://www.gnu.org/software/autoconf/">autoconf</a> project you can change the destination directory
+for <tt class="docutils literal"><span class="pre">make</span> <span class="pre">install</span></tt>. The equivalent for autoconfs <tt class="docutils literal"><span class="pre">./configure</span> <span class="pre">--prefix</span></tt>
+in <a class="reference external" href="http://www.cmake.org">CMake</a> is:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="p">...</span>
+<span class="n">cmake</span> <span class="o">-</span><span class="n">DCMAKE_INSTALL_PREFIX</span><span class="o">:</span><span class="n">PATH</span><span class="o">=/</span><span class="n">some</span><span class="o">/</span><span class="n">other</span><span class="o">/</span><span class="n">path</span> <span class="p">..</span>
+<span class="n">make</span> <span class="n">install</span>
+</pre></div>
+</div>
+</div>
+</div>
+</div>
+<div class="section" id="android">
+<h3>Android<a class="headerlink" href="#android" title="Permalink to this headline">¶</a></h3>
+<p>Jansson can be built for Android platforms. Android.mk is in the
+source root directory. The configuration header file is located in the
+<tt class="docutils literal"><span class="pre">android</span></tt> directory in the source distribution.</p>
+</div>
+<div class="section" id="other-systems">
+<h3>Other Systems<a class="headerlink" href="#other-systems" title="Permalink to this headline">¶</a></h3>
+<p>On non Unix-like systems, you may be unable to run the <tt class="docutils literal"><span class="pre">./configure</span></tt>
+script. In this case, follow these steps. All the files mentioned can
+be found in the <tt class="docutils literal"><span class="pre">src/</span></tt> directory.</p>
+<ol class="arabic simple">
+<li>Create <tt class="docutils literal"><span class="pre">jansson_config.h</span></tt> (which has some platform-specific
+parameters that are normally filled in by the <tt class="docutils literal"><span class="pre">./configure</span></tt>
+script). Edit <tt class="docutils literal"><span class="pre">jansson_config.h.in</span></tt>, replacing all <tt class="docutils literal"><span class="pre">@variable@</span></tt>
+placeholders, and rename the file to <tt class="docutils literal"><span class="pre">jansson_config.h</span></tt>.</li>
+<li>Make <tt class="docutils literal"><span class="pre">jansson.h</span></tt> and <tt class="docutils literal"><span class="pre">jansson_config.h</span></tt> available to the
+compiler, so that they can be found when compiling programs that
+use Jansson.</li>
+<li>Compile all the <tt class="docutils literal"><span class="pre">.c</span></tt> files (in the <tt class="docutils literal"><span class="pre">src/</span></tt> directory) into a
+library file. Make the library available to the compiler, as in
+step 2.</li>
+</ol>
+</div>
+<div class="section" id="building-the-documentation">
+<h3>Building the Documentation<a class="headerlink" href="#building-the-documentation" title="Permalink to this headline">¶</a></h3>
+<p>(This subsection describes how to build the HTML documentation you are
+currently reading, so it can be safely skipped.)</p>
+<p>Documentation is in the <tt class="docutils literal"><span class="pre">doc/</span></tt> subdirectory. It’s written in
+<a class="reference external" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> with <a class="reference external" href="http://sphinx.pocoo.org/">Sphinx</a> annotations. To generate the HTML
+documentation, invoke:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">make</span> <span class="n">html</span>
+</pre></div>
+</div>
+<p>and point your browser to <tt class="docutils literal"><span class="pre">doc/_build/html/index.html</span></tt>. <a class="reference external" href="http://sphinx.pocoo.org/">Sphinx</a> 1.0
+or newer is required to generate the documentation.</p>
+</div>
+</div>
+<div class="section" id="compiling-programs-that-use-jansson">
+<h2>Compiling Programs that Use Jansson<a class="headerlink" href="#compiling-programs-that-use-jansson" title="Permalink to this headline">¶</a></h2>
+<p>Jansson involves one C header file, <tt class="file docutils literal"><span class="pre">jansson.h</span></tt>, so it’s enough
+to put the line</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cp">#include <jansson.h></span>
+</pre></div>
+</div>
+<p>in the beginning of every source file that uses Jansson.</p>
+<p>There’s also just one library to link with, <tt class="docutils literal"><span class="pre">libjansson</span></tt>. Compile and
+link the program as follows:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">cc</span> <span class="o">-</span><span class="n">I /usr/include/jansson</span> <span class="o">-</span><span class="n">o</span> <span class="n">prog</span> <span class="n">prog</span><span class="p">.</span><span class="n">c</span> <span class="o">-</span><span class="n">ljansson</span>
+</pre></div>
+</div>
+<p>Starting from version 1.2, there’s also support for <a class="reference external" href="http://pkg-config.freedesktop.org/">pkg-config</a>:</p>
+<div class="highlight-c"><div class="highlight"><pre>cc -o prog prog.c `pkg-config --cflags --libs jansson`
+</pre></div>
+</div>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="index.html">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">Getting Started</a><ul>
+<li><a class="reference internal" href="#compiling-and-installing-jansson">Compiling and Installing Jansson</a><ul>
+<li><a class="reference internal" href="#unix-like-systems-including-mingw">Unix-like systems (including MinGW)</a></li>
+<li><a class="reference internal" href="#cmake-various-platforms-including-windows">CMake (various platforms, including Windows)</a><ul>
+<li><a class="reference internal" href="#unix-make-files">Unix (Make files)</a></li>
+<li><a class="reference internal" href="#windows-visual-studio">Windows (Visual Studio)</a></li>
+<li><a class="reference internal" href="#mac-osx-xcode">Mac OSX (Xcode)</a></li>
+<li><a class="reference internal" href="#additional-cmake-settings">Additional CMake settings</a><ul>
+<li><a class="reference internal" href="#shared-library">Shared library</a></li>
+<li><a class="reference internal" href="#changing-install-directory-same-as-autoconf-prefix">Changing install directory (same as autoconf –prefix)</a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a class="reference internal" href="#android">Android</a></li>
+<li><a class="reference internal" href="#other-systems">Other Systems</a></li>
+<li><a class="reference internal" href="#building-the-documentation">Building the Documentation</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#compiling-programs-that-use-jansson">Compiling Programs that Use Jansson</a></li>
+</ul>
+</li>
+</ul>
+
+ <h4>Previous topic</h4>
+ <p class="topless"><a href="index.html"
+ title="previous chapter">Jansson Documentation</a></p>
+ <h4>Next topic</h4>
+ <p class="topless"><a href="upgrading.html"
+ title="next chapter">Upgrading from 1.x</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/gettingstarted.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="upgrading.html" title="Upgrading from 1.x"
+ >next</a> |</li>
+ <li class="right" >
+ <a href="index.html" title="Jansson Documentation"
+ >previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/index.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,215 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Jansson Documentation — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="#" />
+ <link rel="next" title="Getting Started" href="gettingstarted.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="gettingstarted.html" title="Getting Started"
+ accesskey="N">next</a> |</li>
+ <li><a href="#">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="jansson-documentation">
+<h1>Jansson Documentation<a class="headerlink" href="#jansson-documentation" title="Permalink to this headline">¶</a></h1>
+<p>This is the documentation for <a class="reference external" href="http://www.digip.org/jansson/">Jansson</a> 2.7, last updated October 28, 2014.</p>
+<div class="section" id="introduction">
+<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
+<p><a class="reference external" href="http://www.digip.org/jansson/">Jansson</a> is a C library for encoding, decoding and manipulating JSON
+data. Its main features and design principles are:</p>
+<ul class="simple">
+<li>Simple and intuitive API and data model</li>
+<li>Comprehensive documentation</li>
+<li>No dependencies on other libraries</li>
+<li>Full Unicode support (UTF-8)</li>
+<li>Extensive test suite</li>
+</ul>
+<p>Jansson is licensed under the <a class="reference external" href="http://www.opensource.org/licenses/mit-license.php">MIT license</a>; see LICENSE in the
+source distribution for details.</p>
+<p>Jansson is used in production and its API is stable. It works on
+numerous platforms, including numerous Unix like systems and Windows.
+It’s suitable for use on any system, including desktop, server, and
+small embedded systems.</p>
+</div>
+<div class="section" id="contents">
+<h2>Contents<a class="headerlink" href="#contents" title="Permalink to this headline">¶</a></h2>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Getting Started</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#compiling-and-installing-jansson">Compiling and Installing Jansson</a></li>
+<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#compiling-programs-that-use-jansson">Compiling Programs that Use Jansson</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="upgrading.html">Upgrading from 1.x</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="upgrading.html#compatibility">Compatibility</a></li>
+<li class="toctree-l2"><a class="reference internal" href="upgrading.html#list-of-incompatible-changes">List of Incompatible Changes</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="tutorial.html">Tutorial</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="tutorial.html#the-github-repo-commits-api">The GitHub Repo Commits API</a></li>
+<li class="toctree-l2"><a class="reference internal" href="tutorial.html#the-program">The Program</a></li>
+<li class="toctree-l2"><a class="reference internal" href="tutorial.html#conclusion">Conclusion</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="conformance.html">RFC Conformance</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="conformance.html#character-encoding">Character Encoding</a></li>
+<li class="toctree-l2"><a class="reference internal" href="conformance.html#strings">Strings</a></li>
+<li class="toctree-l2"><a class="reference internal" href="conformance.html#numbers">Numbers</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="portability.html">Portability</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="portability.html#thread-safety">Thread safety</a></li>
+<li class="toctree-l2"><a class="reference internal" href="portability.html#locale">Locale</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="apiref.html">API Reference</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#preliminaries">Preliminaries</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#library-version">Library Version</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#value-representation">Value Representation</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#true-false-and-null">True, False and Null</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#string">String</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#number">Number</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#array">Array</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#object">Object</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#error-reporting">Error reporting</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#encoding">Encoding</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#decoding">Decoding</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#building-values">Building Values</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#parsing-and-validating-values">Parsing and Validating Values</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#equality">Equality</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#copying">Copying</a></li>
+<li class="toctree-l2"><a class="reference internal" href="apiref.html#custom-memory-allocation">Custom Memory Allocation</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="changes.html">Changes in Jansson</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-7">Version 2.7</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-6">Version 2.6</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-5">Version 2.5</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-4">Version 2.4</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-3-1">Version 2.3.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-3">Version 2.3</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-2-1">Version 2.2.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-2">Version 2.2</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-1">Version 2.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-0-1">Version 2.0.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-2-0">Version 2.0</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-3">Version 1.3</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-2-1">Version 1.2.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-2">Version 1.2</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-1-3">Version 1.1.3</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-1-2">Version 1.1.2</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-1-1">Version 1.1.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-1">Version 1.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-0-4">Version 1.0.4</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-0-3">Version 1.0.3</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-0-2">Version 1.0.2</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-0-1">Version 1.0.1</a></li>
+<li class="toctree-l2"><a class="reference internal" href="changes.html#version-1-0">Version 1.0</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="section" id="indices-and-tables">
+<h1>Indices and Tables<a class="headerlink" href="#indices-and-tables" title="Permalink to this headline">¶</a></h1>
+<ul class="simple">
+<li><a class="reference internal" href="genindex.html"><em>Index</em></a></li>
+<li><a class="reference internal" href="search.html"><em>Search Page</em></a></li>
+</ul>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="#">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">Jansson Documentation</a><ul>
+<li><a class="reference internal" href="#introduction">Introduction</a></li>
+<li><a class="reference internal" href="#contents">Contents</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#indices-and-tables">Indices and Tables</a></li>
+</ul>
+
+ <h4>Next topic</h4>
+ <p class="topless"><a href="gettingstarted.html"
+ title="next chapter">Getting Started</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/index.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="gettingstarted.html" title="Getting Started"
+ >next</a> |</li>
+ <li><a href="#">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/portability.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,186 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Portability — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ <link rel="next" title="API Reference" href="apiref.html" />
+ <link rel="prev" title="RFC Conformance" href="conformance.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="apiref.html" title="API Reference"
+ accesskey="N">next</a> |</li>
+ <li class="right" >
+ <a href="conformance.html" title="RFC Conformance"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="portability">
+<h1>Portability<a class="headerlink" href="#portability" title="Permalink to this headline">¶</a></h1>
+<div class="section" id="thread-safety">
+<span id="portability-thread-safety"></span><h2>Thread safety<a class="headerlink" href="#thread-safety" title="Permalink to this headline">¶</a></h2>
+<p>Jansson is thread safe and has no mutable global state. The only
+exceptions are the hash function seed and memory allocation functions,
+see below.</p>
+<p>There’s no locking performed inside Jansson’s code, so a multithreaded
+program must perform its own locking if JSON values are shared by
+multiple threads. Jansson’s reference counting semantics may make this
+a bit harder than it seems, as it’s possible to have a reference to a
+value that’s also stored inside a list or object. Modifying the
+container (adding or removing values) may trigger concurrent access to
+such values, as containers manage the reference count of their
+contained values. Bugs involving concurrent incrementing or
+decrementing of deference counts may be hard to track.</p>
+<p>The encoding functions (<a class="reference internal" href="apiref.html#c.json_dumps" title="json_dumps"><tt class="xref c c-func docutils literal"><span class="pre">json_dumps()</span></tt></a> and friends) track
+reference loops by modifying the internal state of objects and arrays.
+For this reason, encoding functions must not be run on the same JSON
+values in two separate threads at the same time. As already noted
+above, be especially careful if two arrays or objects share their
+contained values with another array or object.</p>
+<p>If you want to make sure that two JSON value hierarchies do not
+contain shared values, use <a class="reference internal" href="apiref.html#c.json_deep_copy" title="json_deep_copy"><tt class="xref c c-func docutils literal"><span class="pre">json_deep_copy()</span></tt></a> to make copies.</p>
+<div class="section" id="hash-function-seed">
+<h3>Hash function seed<a class="headerlink" href="#hash-function-seed" title="Permalink to this headline">¶</a></h3>
+<p>To prevent an attacker from intentionally causing large JSON objects
+with specially crafted keys to perform very slow, the hash function
+used by Jansson is randomized using a seed value. The seed is
+automatically generated on the first explicit or implicit call to
+<a class="reference internal" href="apiref.html#c.json_object" title="json_object"><tt class="xref c c-func docutils literal"><span class="pre">json_object()</span></tt></a>, if <a class="reference internal" href="apiref.html#c.json_object_seed" title="json_object_seed"><tt class="xref c c-func docutils literal"><span class="pre">json_object_seed()</span></tt></a> has not been
+called beforehand.</p>
+<p>The seed is generated by using operating system’s entropy sources if
+they are available (<tt class="docutils literal"><span class="pre">/dev/urandom</span></tt>, <tt class="docutils literal"><span class="pre">CryptGenRandom()</span></tt>). The
+initialization is done in as thread safe manner as possible, by using
+architecture specific lockless operations if provided by the platform
+or the compiler.</p>
+<p>If you’re using threads, it’s recommended to autoseed the hashtable
+explicitly before spawning any threads by calling
+<tt class="docutils literal"><span class="pre">json_object_seed(0)</span></tt> , especially if you’re unsure whether the
+initialization is thread safe on your platform.</p>
+</div>
+<div class="section" id="memory-allocation-functions">
+<h3>Memory allocation functions<a class="headerlink" href="#memory-allocation-functions" title="Permalink to this headline">¶</a></h3>
+<p>Memory allocation functions should be set at most once, and only on
+program startup. See <a class="reference internal" href="apiref.html#apiref-custom-memory-allocation"><em>Custom Memory Allocation</em></a>.</p>
+</div>
+</div>
+<div class="section" id="locale">
+<h2>Locale<a class="headerlink" href="#locale" title="Permalink to this headline">¶</a></h2>
+<p>Jansson works fine under any locale.</p>
+<p>However, if the host program is multithreaded and uses <tt class="docutils literal"><span class="pre">setlocale()</span></tt>
+to switch the locale in one thread while Jansson is currently encoding
+or decoding JSON data in another thread, the result may be wrong or
+the program may even crash.</p>
+<p>Jansson uses locale specific functions for certain string conversions
+in the encoder and decoder, and then converts the locale specific
+values to/from the JSON representation. This fails if the locale
+changes between the string conversion and the locale-to-JSON
+conversion. This can only happen in multithreaded programs that use
+<tt class="docutils literal"><span class="pre">setlocale()</span></tt>, because <tt class="docutils literal"><span class="pre">setlocale()</span></tt> switches the locale for all
+running threads, not only the thread that calls <tt class="docutils literal"><span class="pre">setlocale()</span></tt>.</p>
+<p>If your program uses <tt class="docutils literal"><span class="pre">setlocale()</span></tt> as described above, consider
+using the thread-safe <tt class="docutils literal"><span class="pre">uselocale()</span></tt> instead.</p>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="index.html">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">Portability</a><ul>
+<li><a class="reference internal" href="#thread-safety">Thread safety</a><ul>
+<li><a class="reference internal" href="#hash-function-seed">Hash function seed</a></li>
+<li><a class="reference internal" href="#memory-allocation-functions">Memory allocation functions</a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#locale">Locale</a></li>
+</ul>
+</li>
+</ul>
+
+ <h4>Previous topic</h4>
+ <p class="topless"><a href="conformance.html"
+ title="previous chapter">RFC Conformance</a></p>
+ <h4>Next topic</h4>
+ <p class="topless"><a href="apiref.html"
+ title="next chapter">API Reference</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/portability.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="apiref.html" title="API Reference"
+ >next</a> |</li>
+ <li class="right" >
+ <a href="conformance.html" title="RFC Conformance"
+ >previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/search.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,99 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Search — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <script type="text/javascript" src="_static/searchtools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ <script type="text/javascript">
+ jQuery(function() { Search.loadIndex("searchindex.js"); });
+ </script>
+
+ <script type="text/javascript" id="searchindexloader"></script>
+
+
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <h1 id="search-documentation">Search</h1>
+ <div id="fallback" class="admonition warning">
+ <script type="text/javascript">$('#fallback').hide();</script>
+ <p>
+ Please activate JavaScript to enable the search
+ functionality.
+ </p>
+ </div>
+ <p>
+ From here you can search these documents. Enter your search
+ words into the box below and click "search". Note that the search
+ function will automatically search for all of the words. Pages
+ containing fewer words won't appear in the result list.
+ </p>
+ <form action="" method="get">
+ <input type="text" name="q" value="" />
+ <input type="submit" value="search" />
+ <span id="search-progress" style="padding-left: 10px"></span>
+ </form>
+
+ <div id="search-results">
+
+ </div>
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/searchindex.js Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,1 @@
+Search.setIndex({envversion:42,terms:{all:[0,1,3,4,5,6,7],code:[6,3,4,5,1],entropi:[3,1],maximum:[3,4,5],queri:3,consum:3,json_typeof:3,poorli:5,prefix:3,concept:7,urandom:1,skip:0,follow:[0,6,3],ptr:3,lld:3,compact:[3,5],whose:[3,7,6],privat:5,depend:[2,7,4,3],system:[3,5],uint8_t:5,json_boolean_valu:[3,5],sensit:3,readabl:[3,5],specif:[0,5,1,3],send:[5,6],program:3,json_object_foreach:[3,5],decis:3,under:[2,5,1],preprocess:3,sent:6,codepoint:[3,7],sourc:[0,1,2,3,4,5,6],everi:[0,3],digip:0,json_object:[3,1],"void":3,json_object_get:[3,5,6],dhave_stdint_h:5,whether:[3,4,5,1,7],fall:3,veri:[7,5,1],appar:3,implicitli:7,json_decode_ani:[3,5],exact:3,implement:[3,5,6],cool:3,failur:[3,5],"0x010201":3,foo:[3,5],doesn:[3,5],level:3,did:6,quux:3,dif:3,list:[0,3,6,1,2],iter:[3,5],"try":3,item:[3,5],supplement:7,form:[3,6],stderr:6,small:[2,7,6],retun:3,dir:0,json_string_set:[3,5],upper:5,repres:[3,5,7],snprintf:6,"14e3":7,natur:3,direct:3,uselocal:1,sign:[3,5],zero:[3,5],design:[2,3],pass:[3,5],"873eddaf":6,improv:5,append:[3,5],compat:[2,3],index:[0,3,2],what:[0,7],jansson_minor_vers:3,appear:3,compar:3,cast:3,preserv:[3,5],abi:4,section:[3,5,6],json_dumpf:[3,4,5],current:[0,1,3],delet:3,"2637faa4":6,consecut:3,"new":[3,4,5,6],arr2:3,json_load_callback_t:[3,5],va_list:3,whatev:3,full:[2,4,6,3],themselv:3,abov:[0,1,5,3,7,6],gener:[0,5,1,3],never:[3,5,7],len:3,json_object_iter_set_new:[3,5],behaviour:[3,6],explicitli:[3,4,1],studio:5,free:[3,4,5,6],solari:5,address:3,path:[0,3],along:5,becom:3,modifi:[3,4,5,1],implicit:[3,4,1],json_nul:3,convert:[3,5,1],produc:[3,5],convers:[3,1],broken:5,shift:3,anymor:6,step:[0,4,3],autoreconf:[0,5],fetch:6,precis:[3,5],jansson:3,extrem:0,chang:3,werror:5,call:[6,3,4,5,1],portabl:[2,5],json_stringn:[3,5],subsect:0,semant:[7,1],via:7,regardless:[3,7],danger:3,circumv:[3,5],appli:7,modul:5,json_max_ind:[3,5],prefer:0,inequ:3,releas:[0,4,5,6,3],"boolean":3,reuiqr:3,printf:[3,6],decrement:[3,1],total:7,coercion:[7,4],unit:[0,3],json_pack:[3,5],unnnn:5,hexadecim:[3,6],from:[0,1,2,3,5,6],describ:[0,5,1,3],would:3,commun:6,distinct:[3,7],doubl:[3,7],two:[3,5,1],coverag:5,next:[3,6],few:5,json_fals:3,value2:3,value1:3,recommend:1,scope:6,basi:3,tell:3,minor:[3,5],"const":[3,5,6],sort:[3,5],relax:5,relat:6,mismatch:5,problem:[0,5,3],enhanc:5,warn:5,bunzip2:0,flag:[3,4,5,7],marchesini:5,indic:3,particular:3,actual:[3,7,6],hold:3,unpack:[0,5,3],easiest:0,must:[3,5,1,7],word:3,"32le":7,alia:[3,5],work:[2,4,5,1,3],annot:0,dev:1,json_number_valu:3,other:[3,5,7],obvious:7,can:[0,1,3,4,5,6],json_:3,json_array_remov:[3,5],rememb:6,root:[0,6,3],"0x010300":3,control:[0,5,3],defer:1,malform:5,want:[0,1,3],stream:3,give:3,process:3,lock:1,ppc64:5,digit:[3,5],accept:3,abort:3,fprintf:6,explor:6,tarbal:[0,5],strtoll:5,serial:[3,5],keep:3,unsign:[5,4,7],occur:[3,5,6,7],autose:1,alwai:[3,5,7],gcc:[5,6],subnorm:5,end:3,newlin:[3,5,6],secur:[3,5],anoth:1,ordinari:[3,7],json_boolean:[3,5],write:[3,5],how:[0,5,3],json_is_numb:3,consist:3,pure:7,other_arrai:3,instead:[0,5,1,3],json_copi:[3,5],simpl:[0,5,3,2],updat:[2,5,3],map:7,product:2,resourc:6,overridden:3,jansson_private_config:5,after:[3,5,6],"long":[3,4,5,7],befor:[3,5,1],wrong:1,callback:[3,5],repeatedli:[3,5],mai:[0,7,4,1,3],multipl:[3,1],associ:3,grow:[3,5],advantag:3,repo:2,"short":[7,6],attempt:3,practic:3,third:3,read:[0,5,3],opaqu:3,bootstrap:0,explicit:[3,1],correspond:3,"__atom":5,caus:[3,5,1],inform:[0,6,3],"switch":1,increment:[3,1],combin:3,json_is_nul:3,allow:[3,5,7],json_object_se:[3,5,1],json_object_update_miss:[3,5],order:[3,5],json_real_valu:3,oper:[3,1],json_object_set_nocheck:[3,5],djansson_build_shared_lib:0,json_array_insert:3,concatent:3,"32be":7,jsonp_strdup:5,json_is_integ:3,top:3,becaus:[3,7,1],increas:3,through:[3,7],affect:3,size_t:[3,4,5,6],still:[3,4],pointer:3,run_test:0,dynam:[3,4],paramet:[0,4,5,6,3],member:3,style:[7,5,6],"1581f26a":6,concaten:3,concis:3,jansson_config:[0,5],fix:[3,5],better:5,segfault:3,window:[3,5],complex:3,comprehens:2,main:[2,6,3],alter:3,non:[0,5,3],"float":[3,7],"return":[3,5,6],fourth:3,jansson_micro_vers:3,json_vpack_ex:[3,5],python:5,timestamp:3,safe:[0,5,1,3],handi:5,initi:[3,5,1],borrow:3,json_is_tru:[3,5],framework:5,json_unpack_ex:[3,5],placehold:0,discuss:3,nor:3,term:3,somewher:3,name:[3,5,6,7],json_decode_int_as_r:[3,5,7],edit:0,sucess:3,drop:3,dcmake_install_prefix:0,separ:[3,5,1],micro:3,achiev:3,alreadi:[3,1],mode:5,each:3,debug:3,found:[0,5,3],unicod:[2,7,5,3],compatibl:[3,5],gui:0,mean:[3,7],subset:[3,7],bignum:7,due:3,replac:[0,4,5,3],chunk:[3,5],hard:1,gc_malloc:3,ensur:3,realli:[3,6],line:[0,6,3],contrib:6,"17a51a4b":6,json_integer_valu:3,"static":[0,5,6,3],expect:3,json_set_alloc_func:[3,5],happen:[3,1],extract:[3,5,6],special:[3,5,1],out:[0,6,3],variabl:[0,6,3],rfc:[3,5],json_dump:[3,4,5,1],safeti:[2,3],space:[3,5],miss:5,newli:[3,6],content:[3,5],method:3,suitabl:2,print:[3,5,6],got:6,correct:5,interoperat:3,achiv:3,clarifi:5,qualifi:5,json_object_iter_valu:3,insid:[3,1],"_new":3,json_is_fals:3,manipul:[2,6,3],situat:5,given:[3,5,6],argv:6,standard:7,reason:[3,1],base:[3,5],json_object_update_exist:[3,5],json_array_foreach:[3,5],dictionari:3,usual:[3,4],put:0,org:0,"byte":[3,5,7],argc:6,afterward:3,boehm:3,care:1,json_object_set_new_nocheck:[3,5],indent:[3,4,5],val:3,thread:[2,5,3],angl:3,where:[3,5,6],could:[0,5],omit:3,refus:3,round:7,counterpart:5,thing:7,length:[3,5,6],enforc:3,place:3,unabl:0,outsid:3,principl:2,fmt:3,first:[3,5,6,1],origin:[3,7],pleas:[0,6],major:3,suffix:3,directli:3,prevent:[5,1],onc:1,independ:[5,6],yourself:3,restrict:7,distcheck:5,json_string_setn:[3,5],done:1,least:3,"1e6":7,stabl:2,json_array_append:3,open:5,size:[3,4,5,6],avail:[0,1,3,4,5,6],differ:3,json_validate_onli:3,silent:[3,7],script:[0,5],data:[2,5,6,1,3],caught:3,perfectli:3,mkdir:0,sometim:3,messag:[3,5,6],parallel:5,json_load_fil:[3,4,5],json_free_t:3,attack:[3,5,1],definit:6,too:[3,5,6,7],json_arrai:3,subdirectori:0,termin:[3,5,7],conveni:5,"final":6,store:[3,1],includ:[3,5,7],shell:5,statement:[3,7],especi:[3,5,1],json_string_set_nocheck:[3,5],json_int_t:[3,4,5,7],specifi:[3,5,7],forward:[3,5],part:[3,7,6],unrandom:3,conserv:3,rst:5,kept:[0,3],exactli:3,than:[7,4,1],std:5,denot:3,kind:3,target:5,keyword:[3,5],provid:[7,5,1],remov:[3,5,1],older:5,tree:0,rate:6,structur:[3,6],charact:[3,5],project:[0,5],json_object_iter_kei:3,str:3,were:[3,5],posit:[3,5],src:0,toward:3,thu:[3,7],seri:5,fashion:3,newline_offset:6,modern:4,beforehand:1,argument:[0,4,5,3],cryptgenrandom:1,packag:7,seed:[3,5],manner:1,json_dump_callback_t:3,tabl:3,need:[0,4,5,6,3],seem:1,element:[3,6],seek:3,minu:[3,5],option:[0,5,3],"4true":3,date:5,built:[0,5],equival:[0,7,3],recompil:4,destroi:3,moreov:3,violat:3,cbb80baf:6,note:[3,5,6,1,7],mix:5,without:[3,5],take:[3,5,6],which:[0,7,5,3],environ:7,brace:3,noth:3,singl:3,recurs:3,even:[3,1],begin:[0,6,3],json_object_clear:3,unless:3,distribut:[0,5,2],normal:[0,7,3],unsur:1,c99:5,previou:3,reach:3,jansson_build_shared_lib:5,json_error_t:[3,5,6],json_object_iter_at:[3,5],detect:[3,5,7],json_ensure_ascii:[3,5],thi:[0,1,2,3,4,5,6,7],pair:3,indirectli:3,url_siz:6,sub:0,don:[3,5,6],correctli:[3,5],url:6,doc:[0,5],clear:5,later:3,cover:6,doe:7,bracket:3,json_incref:3,clean:5,left:3,"400e":7,json_is_str:[3,6],json_array_s:[3,6],heap:[3,5],"16be":7,opposit:3,comparis:3,json_array_extend:3,syntax:[5,6],concurr:1,pkg:[0,5],worri:3,jansson_version_hex:[3,5],identifi:[3,5],longer:[3,5],fine:1,find:[0,6],help:[0,3],involv:[0,1],absolut:7,onli:[1,3,4,5,6,7],slow:1,locat:0,thei:[0,1,3],pretti:3,strtod:5,losslessli:3,explain:[3,6],configur:[0,5],solut:[0,5],behind:3,json_string_nocheck:[3,5],won:3,"10ffff":[3,7],jansson_major_vers:3,constant:[3,5,6],local:[0,5,2],over:[3,5,6],sure:1,overwritten:3,info:[3,5,6],hit:3,unus:3,free_fn:3,get:[3,5],likewis:7,stop:[3,5],soon:3,e8fd3e30:6,cannot:[3,5],foobarbaz:3,json_sort_kei:[3,5],json_malloc_t:3,neither:[3,7],requir:[0,4,5,6,3],ssb:3,bar:[3,5],enabl:[3,5],crt:3,emb:3,baz:3,dramat:4,yield:3,patch:5,gc_free:3,sha:6,suit:[0,5,2],common:3,though:3,contain:[6,3,4,5,1],steal:[3,5],view:6,respond:6,conform:[3,5],set:[3,5,7],json_is_boolean:[3,5],packer:3,startup:[3,1],json_strict:[3,5],mutabl:1,hierarchi:1,nul:3,result:[0,1,5,3,7,6],respons:6,fail:[3,5,6,1],close:[3,5,7],best:6,subject:7,strchr:6,awar:[3,5],statu:3,said:3,myint1:3,kei:[3,5,1,7],myint3:3,myint2:3,pattern:5,someth:3,json_object_it:3,restructur:5,secure_fre:[3,5],json_reject_dupl:[3,5],between:[3,5,1,7],json_unpack:[3,5],"import":6,awai:3,experi:6,libtool:0,signatur:3,accord:3,libjansson:[0,5],extend:5,numer:[2,7,3],javascript:7,typedef:[3,4,5,7],json_object_iter_set:[3,5],extens:2,json_str:3,succeed:3,here:[3,5,6],json_vunpack_ex:[3,5],distinguish:3,decreas:[3,6],embed:[2,3],addit:[3,5],both:[3,4],protect:3,last:[2,3],similar:[0,3],howev:[3,7,1],json_encode_ani:[3,5],valgrind:5,against:[3,4],etc:[3,4,7],tutori:[2,5],present:3,guaranteed_memset:3,agent:5,let:6,json_integ:3,json_deep_copi:[3,5,1],com:[3,6],preprocessor:[3,5],json_process:5,simpli:0,reject:5,point:[0,7,5,3],int32_t:5,period:6,except:[3,1],header:[0,5],written:[0,3],theoret:5,linux:5,respect:[3,6],throughout:3,assum:0,simpler:3,duplic:[3,5],github_commit:[5,6],clarif:5,creat:[0,5,6,3],second:[3,4,6],platform:[7,5],json_typ:3,underflow:5,json_real_precis:[3,5],secret:3,compos:3,empti:[3,5],sinc:3,json_ind:[3,4],"int":[3,4,5,6,7],json:[2,1,3,4,5,6,7],much:3,unexpect:6,interpret:[3,7],modif:[5,4],stdint:5,addresssanit:5,popul:5,vpath:5,field:[3,5,6],bd2c0c73:6,octob:2,buflen:3,am_cflag:5,ani:[0,1,2,3,5,7],assert:[3,5],craft:[5,1],file:[3,5],togeth:3,child:3,json_string_setn_nocheck:[3,5],rang:[3,4],andrea:5,those:3,"case":[0,4,5,6,3],stolen:3,gnu:[0,5],plain:[3,5],bz2:0,harder:1,search:2,defin:[3,5,6],invok:[0,5],unifi:[5,4],behavior:3,indetermin:3,json_preserve_ord:[3,5],invoc:3,cve:5,loop:[6,1],pack:3,spawn:1,real:[3,5],malloc:[3,5],have:[0,4,5,1,3],tar:0,applic:[3,7],readi:6,therefor:7,them:[0,4,3],json_object_del:[3,5],destin:0,akheron:6,itself:[3,5],json_real_set:[3,5],revis:5,unneed:5,ascii:[3,5,7],sever:6,around:[3,5],incompat:[2,5,3],mutat:5,clearli:3,strcmp:3,"16le":7,media:7,make:[3,5,7],same:[3,5],"while":[3,5,1],shorter:[3,7],binari:[0,5,6],html:[0,5,3],json_dump_fil:[3,4,5],auto:7,json_real:3,algorithm:3,android:5,document:[3,5],start:[3,5],finish:6,http:[0,6,3],json_t:[3,5,6],see:[0,1,2,3,5,6,7],json_integer_is_long_long:3,dwheeler:3,expans:6,nest:3,smallish:4,upon:3,hand:[3,5],va_copi:5,user:[3,5,6],mani:[0,5,6,3],json_integer_set:[3,5],encrypt:3,stack:3,expand:[3,5],pull:6,test_load_callback:6,off:5,lib:0,discourag:3,mention:[0,7],find_packag:5,whole:[3,4],random:[3,5,1],parenthes:[3,5],autotool:[0,5],more:[0,5,6,3],exampl:[0,4,5,6,3],command:[0,6],ecmascript:7,uint32_t:5,endif:3,undefin:[3,5],json_object_key_to_it:3,model:2,lcurl:6,json_dump_callback:[3,5],latest:6,explan:6,load:6,construct:3,protocol:3,just:[0,5,6,3],when:[0,5,4,3,7,6],json_integer_format:3,exclud:7,obtain:[0,3],rest:3,refactor:5,aspect:3,json_is_object:[3,6],touch:3,config:[0,5],speed:3,languag:3,web:6,now:[0,4,5,6],struct:[3,5],widest:[3,4,5],also:[0,1,3,4,5,6,7],scenario:3,restructuredtext:0,supporetd:3,littl:5,desktop:2,add:[3,5,6,7],cleanup:5,simplejson:5,bigger:4,versa:3,json_loadb:[3,5],els:[3,6],expon:5,approxim:7,match:3,bin:5,int32:5,json_array_insert_new:3,refleak:5,format:[3,5,6],handl:[3,4,5,6,7],big:5,caller:3,howto:3,intuit:2,json_array_set_new:3,know:3,insert:[3,5],guid:5,bit:[3,4,5,1],password:3,l_isxdigit:5,licens:2,u0000:[3,5],loss:[3,7],ignor:[3,6],like:[3,5,7],success:[3,5],whitespac:[3,5],should:[3,4,5,1],changelog:5,integ:[3,5],mit:2,ldflag:5,collect:3,necessari:0,either:3,ieee:[3,7],furthermor:3,bunch:6,output:[3,5],hook:7,page:[2,3],underli:[3,4,5,7],encount:3,www:[0,3],json_load_callback:[3,5,6],old:4,deal:4,json_is_r:3,some:[0,5,6,3],json_decref:[3,5,6],vs2010:5,global:[3,5,1],shallow:[3,5],intern:[3,5,1,7],contin:5,sampl:3,proper:[3,6],guarante:[3,4],indirect:3,server:2,constitut:3,fromat:5,json_object_upd:3,win32:5,json_pack_ex:[3,5],friend:[5,1],lead:[3,5],json_object_set_new:3,leak:5,avoid:[3,5,6],extra:[3,4],json_string_length:[3,5],per:3,buffer:3,mathemat:7,larg:[7,5,1],prog:0,malloc_fn:3,three:3,freed:3,myint:3,run:[0,5,6,1,3],garbag:3,"enum":3,usag:[5,4,6],json_equ:[3,5],host:1,lexic:7,repositori:[0,6],offset:6,strlen:6,jansson_:3,microsecond:3,json_tru:3,chapter:[5,4],comparison:[3,7],about:[3,7],obj:3,json_loadf:[3,4,5],most:[3,4,1,7],column:[3,5],proce:6,json_object_iter_next:3,json_array_append_new:3,manag:[3,5,1],lifecycl:5,issu:[3,5],constructor:5,commit:2,disabl:3,block:3,compil:[3,5,7],own:[3,1],cflag:0,consid:[7,1],url_format:6,json_stringn_nocheck:[3,5],within:6,automat:[5,1],upgrad:[2,5],automak:0,guard:5,right:[3,6],been:[3,4,5,1],strip:[5,6],smarto:5,browser:0,json_escape_slash:[3,5],your:[0,7,4,1,3],merg:6,ccmake:0,inclus:3,git:0,wai:[0,6,3],area:3,errno:5,support:[0,2,5,4,3,7],buffer_po:6,bodi:6,transform:7,overwrit:3,verbos:5,strict:[3,5],reli:7,trigger:1,inner:3,message_text:6,ndebug:5,biggest:4,perform:[3,5,1,7],strictli:0,"_build":0,treat:[7,5],"function":[3,5],properli:5,typo:5,lockless:1,enough:[0,5,6,3],back:3,github:[2,5],"_new_":3,link:[0,4],measur:3,newer:[0,5],renam:[0,5],overflow:[3,5],inlin:5,bug:[3,5,1],conclus:2,faster:3,suppli:5,notat:7,json_array_clear:3,libcurl:6,utf:[2,7,5,3],input:[3,4,5],"09c39adc":6,possibl:[0,5,1,3],"default":[0,5,3],wish:3,access:[3,1],analyz:5,intermedi:6,below:[0,1,3],unspecifi:3,limit:6,sum:6,site:5,otherwis:[3,5],ljansson:[0,6],autoconf:5,secure_malloc:3,jansson_vers:[3,5],reachabl:3,featur:[2,5,6,3],hash:[3,5],json_allow_nul:[3,5],multibyt:3,certain:[3,1],"abstract":3,deep:[3,5],json_object_s:[3,5],"char":[3,5,6],itselfi:3,exist:[3,5],bd72efbd:6,our:6,request:6,mingw:5,inf:5,rogerz:6,check:[0,7,5,6,3],aabfd493:6,fill:[0,3],again:6,macro:[3,4,5,6],cmake:5,collector:3,estim:[7,5],json_disable_eof_check:[3,5],nan:5,detail:[0,5,6,3,2],local_cflag:5,setlocal:1,declar:[3,5,6],uint16_t:5,futur:[5,4],branch:6,test:[0,5,6,3,2],json_array_set:3,you:[0,6,1,3],json_load:[3,4,5,6],intention:1,architectur:1,repeat:3,json_is_arrai:[3,6],tweak:6,symbol:[5,6],introduc:4,invalid:[3,5],"040bd7b0":6,track:[3,1],preform:6,escap:[3,5],usr:0,singleton:[3,5],bracker:3,sisi:3,debian:5,fraction:7,multithread:1,state:[3,7,1],json_string_valu:[3,6],sphinx:[0,5],eof:[3,5],json_object_set:[3,5],vice:3,directori:5,hashtabl:[3,5,1],crash:[5,1],visual:[3,5],rule:7,depth:[5,4],text:[3,5,6,7],json_array_get:[3,6],arr1:3,time:[3,6,1],fresh:3,"export":[5,6],backward:[3,4,5],json_compact:[3,5],stick:6},objtypes:{"0":"c:function","1":"c:type","2":"c:member"},objnames:{"0":["c","function","C function"],"1":["c","type","C type"],"2":["c","member","C member"]},filenames:["gettingstarted","portability","index","apiref","upgrading","changes","tutorial","conformance"],titles:["Getting Started","Portability","Jansson Documentation","API Reference","Upgrading from 1.x","Changes in Jansson","Tutorial","RFC Conformance"],objects:{"":{json_is_string:[3,0,1,"c.json_is_string"],json_copy:[3,0,1,"c.json_copy"],json_array_insert:[3,0,1,"c.json_array_insert"],json_array_append:[3,0,1,"c.json_array_append"],json_typeof:[3,0,1,"c.json_typeof"],json_array_extend:[3,0,1,"c.json_array_extend"],json_is_object:[3,0,1,"c.json_is_object"],json_is_number:[3,0,1,"c.json_is_number"],json_object_key_to_iter:[3,0,1,"c.json_object_key_to_iter"],json_loads:[3,0,1,"c.json_loads"],json_object_update_existing:[3,0,1,"c.json_object_update_existing"],json_vpack_ex:[3,0,1,"c.json_vpack_ex"],json_string_nocheck:[3,0,1,"c.json_string_nocheck"],json_loadf:[3,0,1,"c.json_loadf"],json_object_foreach:[3,0,1,"c.json_object_foreach"],json_loadb:[3,0,1,"c.json_loadb"],json_object:[3,0,1,"c.json_object"],json_number_value:[3,0,1,"c.json_number_value"],json_array_clear:[3,0,1,"c.json_array_clear"],json_object_get:[3,0,1,"c.json_object_get"],json_array_set_new:[3,0,1,"c.json_array_set_new"],json_unpack:[3,0,1,"c.json_unpack"],json_unpack_ex:[3,0,1,"c.json_unpack_ex"],json_null:[3,0,1,"c.json_null"],json_load_callback:[3,0,1,"c.json_load_callback"],json_array_size:[3,0,1,"c.json_array_size"],json_integer_value:[3,0,1,"c.json_integer_value"],json_set_alloc_funcs:[3,0,1,"c.json_set_alloc_funcs"],json_is_null:[3,0,1,"c.json_is_null"],json_string_set:[3,0,1,"c.json_string_set"],json_is_boolean:[3,0,1,"c.json_is_boolean"],json_decref:[3,0,1,"c.json_decref"],json_string_length:[3,0,1,"c.json_string_length"],json_object_set:[3,0,1,"c.json_object_set"],json_false:[3,0,1,"c.json_false"],json_load_file:[3,0,1,"c.json_load_file"],json_pack_ex:[3,0,1,"c.json_pack_ex"],json_object_set_new:[3,0,1,"c.json_object_set_new"],json_dumpf:[3,0,1,"c.json_dumpf"],json_dumps:[3,0,1,"c.json_dumps"],json_load_callback_t:[3,1,1,"c.json_load_callback_t"],json_array_remove:[3,0,1,"c.json_array_remove"],json_object_iter_set_new:[3,0,1,"c.json_object_iter_set_new"],json_object_iter_set:[3,0,1,"c.json_object_iter_set"],json_array_foreach:[3,0,1,"c.json_array_foreach"],json_vunpack_ex:[3,0,1,"c.json_vunpack_ex"],json_dump_callback:[3,0,1,"c.json_dump_callback"],json_equal:[3,0,1,"c.json_equal"],json_object_seed:[3,0,1,"c.json_object_seed"],json_object_set_new_nocheck:[3,0,1,"c.json_object_set_new_nocheck"],json_object_iter_next:[3,0,1,"c.json_object_iter_next"],json_deep_copy:[3,0,1,"c.json_deep_copy"],json_array_append_new:[3,0,1,"c.json_array_append_new"],json_string_value:[3,0,1,"c.json_string_value"],json_object_update_missing:[3,0,1,"c.json_object_update_missing"],json_stringn:[3,0,1,"c.json_stringn"],json_type:[3,1,1,"c.json_type"],json_string_setn:[3,0,1,"c.json_string_setn"],json_pack:[3,0,1,"c.json_pack"],json_integer:[3,0,1,"c.json_integer"],json_array:[3,0,1,"c.json_array"],json_is_false:[3,0,1,"c.json_is_false"],json_object_del:[3,0,1,"c.json_object_del"],json_free_t:[3,1,1,"c.json_free_t"],json_array_set:[3,0,1,"c.json_array_set"],json_string_set_nocheck:[3,0,1,"c.json_string_set_nocheck"],json_int_t:[3,1,1,"c.json_int_t"],json_object_size:[3,0,1,"c.json_object_size"],json_string_setn_nocheck:[3,0,1,"c.json_string_setn_nocheck"],json_object_update:[3,0,1,"c.json_object_update"],json_object_iter_key:[3,0,1,"c.json_object_iter_key"],json_object_iter_value:[3,0,1,"c.json_object_iter_value"],json_is_integer:[3,0,1,"c.json_is_integer"],json_dump_callback_t:[3,1,1,"c.json_dump_callback_t"],json_boolean_value:[3,0,1,"c.json_boolean_value"],json_real_set:[3,0,1,"c.json_real_set"],json_dump_file:[3,0,1,"c.json_dump_file"],json_true:[3,0,1,"c.json_true"],json_boolean:[3,0,1,"c.json_boolean"],json_is_real:[3,0,1,"c.json_is_real"],json_real:[3,0,1,"c.json_real"],json_real_value:[3,0,1,"c.json_real_value"],json_object_clear:[3,0,1,"c.json_object_clear"],json_t:[3,1,1,"c.json_t"],json_error_t:[3,1,1,"c.json_error_t"],json_object_set_nocheck:[3,0,1,"c.json_object_set_nocheck"],json_stringn_nocheck:[3,0,1,"c.json_stringn_nocheck"],json_integer_set:[3,0,1,"c.json_integer_set"],json_is_array:[3,0,1,"c.json_is_array"],json_object_iter:[3,0,1,"c.json_object_iter"],json_malloc_t:[3,1,1,"c.json_malloc_t"],json_array_get:[3,0,1,"c.json_array_get"],json_array_insert_new:[3,0,1,"c.json_array_insert_new"],json_is_true:[3,0,1,"c.json_is_true"],json_incref:[3,0,1,"c.json_incref"],json_object_iter_at:[3,0,1,"c.json_object_iter_at"],json_string:[3,0,1,"c.json_string"]},json_error_t:{column:[3,2,1,"c.json_error_t.column"],position:[3,2,1,"c.json_error_t.position"],line:[3,2,1,"c.json_error_t.line"]}},titleterms:{represent:3,osx:0,xcode:0,prefix:0,underflow:7,platform:0,window:0,program:[0,6],local:1,real:7,string:[3,7],variou:0,get:0,fals:3,repo:6,report:3,introduct:2,like:0,list:4,integ:7,rfc:7,mingw:0,valid:3,compil:0,conform:7,set:0,sign:7,zero:7,librari:[0,3],compat:4,safeti:1,content:2,version:[3,5],refer:3,hash:1,studio:0,valu:3,addit:0,thread:1,equal:3,precis:7,jansson:[0,5,2],tutori:6,commit:6,chang:[0,4,5],portabl:1,arrai:3,encod:[3,7],number:[3,7],upgrad:4,unix:0,api:[3,6],instal:0,from:4,memori:[3,1],system:0,custom:3,start:0,includ:0,type:[3,7],"function":1,copi:3,visual:0,pars:3,overflow:7,"true":3,conclus:6,count:3,charact:7,error:3,autoconf:0,share:0,indic:2,seed:1,file:0,tabl:2,"null":3,incompat:4,cmake:0,make:0,same:0,other:0,decod:3,build:[0,3],android:0,document:[0,2],circular:3,preliminari:3,object:3,mac:0,alloc:[3,1],github:6,directori:0}})
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/tutorial.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,371 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Tutorial — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ <link rel="next" title="RFC Conformance" href="conformance.html" />
+ <link rel="prev" title="Upgrading from 1.x" href="upgrading.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="conformance.html" title="RFC Conformance"
+ accesskey="N">next</a> |</li>
+ <li class="right" >
+ <a href="upgrading.html" title="Upgrading from 1.x"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="tutorial">
+<span id="id1"></span><h1>Tutorial<a class="headerlink" href="#tutorial" title="Permalink to this headline">¶</a></h1>
+<p>In this tutorial, we create a program that fetches the latest commits
+of a repository in <a class="reference external" href="https://github.com/">GitHub</a> over the web. <a class="reference external" href="http://developer.github.com/">GitHub API</a> uses JSON, so
+the result can be parsed using Jansson.</p>
+<p>To stick to the the scope of this tutorial, we will only cover the the
+parts of the program related to handling JSON data. For the best user
+experience, the full source code is available:
+<a class="reference download internal" href="_downloads/github_commits.c"><tt class="xref download docutils literal"><span class="pre">github_commits.c</span></tt></a>. To compile it (on Unix-like systems with
+gcc), use the following command:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">gcc</span> <span class="o">-</span><span class="n">o</span> <span class="n">github_commits</span> <span class="n">github_commits</span><span class="p">.</span><span class="n">c</span> <span class="o">-</span><span class="n">ljansson</span> <span class="o">-</span><span class="n">lcurl</span>
+</pre></div>
+</div>
+<p><a class="reference external" href="http://curl.haxx.se/">libcurl</a> is used to communicate over the web, so it is required to
+compile the program.</p>
+<p>The command line syntax is:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">github_commits</span> <span class="n">USER</span> <span class="n">REPOSITORY</span>
+</pre></div>
+</div>
+<p><tt class="docutils literal"><span class="pre">USER</span></tt> is a GitHub user ID and <tt class="docutils literal"><span class="pre">REPOSITORY</span></tt> is the repository
+name. Please note that the GitHub API is rate limited, so if you run
+the program too many times within a short period of time, the sever
+starts to respond with an error.</p>
+<div class="section" id="the-github-repo-commits-api">
+<span id="tutorial-github-commits-api"></span><h2>The GitHub Repo Commits API<a class="headerlink" href="#the-github-repo-commits-api" title="Permalink to this headline">¶</a></h2>
+<p>The <a class="reference external" href="http://developer.github.com/v3/repos/commits/">GitHub Repo Commits API</a> is used by sending HTTP requests to
+URLs like <tt class="docutils literal"><span class="pre">https://api.github.com/repos/USER/REPOSITORY/commits</span></tt>,
+where <tt class="docutils literal"><span class="pre">USER</span></tt> and <tt class="docutils literal"><span class="pre">REPOSITORY</span></tt> are the GitHub user ID and the name
+of the repository whose commits are to be listed, respectively.</p>
+<p>GitHub responds with a JSON array of the following form:</p>
+<div class="highlight-none"><div class="highlight"><pre>[
+ {
+ "sha": "<the commit ID>",
+ "commit": {
+ "message": "<the commit message>",
+ <more fields, not important to this tutorial...>
+ },
+ <more fields...>
+ },
+ {
+ "sha": "<the commit ID>",
+ "commit": {
+ "message": "<the commit message>",
+ <more fields...>
+ },
+ <more fields...>
+ },
+ <more commits...>
+]
+</pre></div>
+</div>
+<p>In our program, the HTTP request is sent using the following
+function:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="k">static</span> <span class="kt">char</span> <span class="o">*</span><span class="nf">request</span><span class="p">(</span><span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">url</span><span class="p">);</span>
+</pre></div>
+</div>
+<p>It takes the URL as a parameter, preforms a HTTP GET request, and
+returns a newly allocated string that contains the response body. If
+the request fails, an error message is printed to stderr and the
+return value is <em>NULL</em>. For full details, refer to <a class="reference download internal" href="_downloads/github_commits.c"><tt class="xref download docutils literal"><span class="pre">the</span> <span class="pre">code</span></tt></a>, as the actual implementation is not important
+here.</p>
+</div>
+<div class="section" id="the-program">
+<span id="tutorial-the-program"></span><h2>The Program<a class="headerlink" href="#the-program" title="Permalink to this headline">¶</a></h2>
+<p>First the includes:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cp">#include <string.h></span>
+<span class="cp">#include <jansson.h></span>
+</pre></div>
+</div>
+<p>Like all the programs using Jansson, we need to include
+<tt class="file docutils literal"><span class="pre">jansson.h</span></tt>.</p>
+<p>The following definitions are used to build the GitHub API request
+URL:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cp">#define URL_FORMAT "https:</span><span class="c1">//api.github.com/repos/%s/%s/commits"</span>
+<span class="cp">#define URL_SIZE 256</span>
+</pre></div>
+</div>
+<p>The following function is used when formatting the result to find the
+first newline in the commit message:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="cm">/* Return the offset of the first newline in text or the length of</span>
+<span class="cm"> text if there's no newline */</span>
+<span class="k">static</span> <span class="kt">int</span> <span class="nf">newline_offset</span><span class="p">(</span><span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">text</span><span class="p">)</span>
+<span class="p">{</span>
+ <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">newline</span> <span class="o">=</span> <span class="n">strchr</span><span class="p">(</span><span class="n">text</span><span class="p">,</span> <span class="sc">'\n'</span><span class="p">);</span>
+ <span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">newline</span><span class="p">)</span>
+ <span class="k">return</span> <span class="n">strlen</span><span class="p">(</span><span class="n">text</span><span class="p">);</span>
+ <span class="k">else</span>
+ <span class="k">return</span> <span class="p">(</span><span class="kt">int</span><span class="p">)(</span><span class="n">newline</span> <span class="o">-</span> <span class="n">text</span><span class="p">);</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>The main function follows. In the beginning, we first declare a bunch
+of variables and check the command line parameters:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="kt">int</span> <span class="nf">main</span><span class="p">(</span><span class="kt">int</span> <span class="n">argc</span><span class="p">,</span> <span class="kt">char</span> <span class="o">*</span><span class="n">argv</span><span class="p">[])</span>
+<span class="p">{</span>
+ <span class="kt">size_t</span> <span class="n">i</span><span class="p">;</span>
+ <span class="kt">char</span> <span class="o">*</span><span class="n">text</span><span class="p">;</span>
+ <span class="kt">char</span> <span class="n">url</span><span class="p">[</span><span class="n">URL_SIZE</span><span class="p">];</span>
+
+ <span class="kt">json_t</span> <span class="o">*</span><span class="n">root</span><span class="p">;</span>
+ <span class="kt">json_error_t</span> <span class="n">error</span><span class="p">;</span>
+
+ <span class="k">if</span><span class="p">(</span><span class="n">argc</span> <span class="o">!=</span> <span class="mi">3</span><span class="p">)</span>
+ <span class="p">{</span>
+ <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"usage: %s USER REPOSITORY</span><span class="se">\n\n</span><span class="s">"</span><span class="p">,</span> <span class="n">argv</span><span class="p">[</span><span class="mi">0</span><span class="p">]);</span>
+ <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"List commits at USER's REPOSITORY.</span><span class="se">\n\n</span><span class="s">"</span><span class="p">);</span>
+ <span class="k">return</span> <span class="mi">2</span><span class="p">;</span>
+ <span class="p">}</span>
+</pre></div>
+</div>
+<p>Then we build the request URL using the user and repository names
+given as command line parameters:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">snprintf</span><span class="p">(</span><span class="n">url</span><span class="p">,</span> <span class="n">URL_SIZE</span><span class="p">,</span> <span class="n">URL_FORMAT</span><span class="p">,</span> <span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">argv</span><span class="p">[</span><span class="mi">2</span><span class="p">]);</span>
+</pre></div>
+</div>
+<p>This uses the <tt class="docutils literal"><span class="pre">URL_SIZE</span></tt> and <tt class="docutils literal"><span class="pre">URL_FORMAT</span></tt> constants defined above.
+Now we’re ready to actually request the JSON data over the web:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">text</span> <span class="o">=</span> <span class="n">request</span><span class="p">(</span><span class="n">url</span><span class="p">);</span>
+<span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">text</span><span class="p">)</span>
+ <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+</pre></div>
+</div>
+<p>If an error occurs, our function <tt class="docutils literal"><span class="pre">request</span></tt> prints the error and
+returns <em>NULL</em>, so it’s enough to just return 1 from the main
+function.</p>
+<p>Next we’ll call <a class="reference internal" href="apiref.html#c.json_loads" title="json_loads"><tt class="xref c c-func docutils literal"><span class="pre">json_loads()</span></tt></a> to decode the JSON text we got
+as a response:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">root</span> <span class="o">=</span> <span class="n">json_loads</span><span class="p">(</span><span class="n">text</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="o">&</span><span class="n">error</span><span class="p">);</span>
+<span class="n">free</span><span class="p">(</span><span class="n">text</span><span class="p">);</span>
+
+<span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">root</span><span class="p">)</span>
+<span class="p">{</span>
+ <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"error: on line %d: %s</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">error</span><span class="p">.</span><span class="n">line</span><span class="p">,</span> <span class="n">error</span><span class="p">.</span><span class="n">text</span><span class="p">);</span>
+ <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>We don’t need the JSON text anymore, so we can free the <tt class="docutils literal"><span class="pre">text</span></tt>
+variable right after decoding it. If <a class="reference internal" href="apiref.html#c.json_loads" title="json_loads"><tt class="xref c c-func docutils literal"><span class="pre">json_loads()</span></tt></a> fails, it
+returns <em>NULL</em> and sets error information to the <a class="reference internal" href="apiref.html#c.json_error_t" title="json_error_t"><tt class="xref c c-type docutils literal"><span class="pre">json_error_t</span></tt></a>
+structure given as the second parameter. In this case, our program
+prints the error information out and returns 1 from the main function.</p>
+<p>Now we’re ready to extract the data out of the decoded JSON response.
+The structure of the response JSON was explained in section
+<a class="reference internal" href="#tutorial-github-commits-api"><em>The GitHub Repo Commits API</em></a>.</p>
+<p>We check that the returned value really is an array:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">json_is_array</span><span class="p">(</span><span class="n">root</span><span class="p">))</span>
+<span class="p">{</span>
+ <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"error: root is not an array</span><span class="se">\n</span><span class="s">"</span><span class="p">);</span>
+ <span class="n">json_decref</span><span class="p">(</span><span class="n">root</span><span class="p">);</span>
+ <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>Then we proceed to loop over all the commits in the array:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="k">for</span><span class="p">(</span><span class="n">i</span> <span class="o">=</span> <span class="mi">0</span><span class="p">;</span> <span class="n">i</span> <span class="o"><</span> <span class="n">json_array_size</span><span class="p">(</span><span class="n">root</span><span class="p">);</span> <span class="n">i</span><span class="o">++</span><span class="p">)</span>
+<span class="p">{</span>
+ <span class="kt">json_t</span> <span class="o">*</span><span class="n">data</span><span class="p">,</span> <span class="o">*</span><span class="n">sha</span><span class="p">,</span> <span class="o">*</span><span class="n">commit</span><span class="p">,</span> <span class="o">*</span><span class="n">message</span><span class="p">;</span>
+ <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">message_text</span><span class="p">;</span>
+
+ <span class="n">data</span> <span class="o">=</span> <span class="n">json_array_get</span><span class="p">(</span><span class="n">root</span><span class="p">,</span> <span class="n">i</span><span class="p">);</span>
+ <span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">json_is_object</span><span class="p">(</span><span class="n">data</span><span class="p">))</span>
+ <span class="p">{</span>
+ <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"error: commit data %d is not an object</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="n">json_decref</span><span class="p">(</span><span class="n">root</span><span class="p">);</span>
+ <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+ <span class="p">}</span>
+<span class="p">...</span>
+</pre></div>
+</div>
+<p>The function <a class="reference internal" href="apiref.html#c.json_array_size" title="json_array_size"><tt class="xref c c-func docutils literal"><span class="pre">json_array_size()</span></tt></a> returns the size of a JSON
+array. First, we again declare some variables and then extract the
+i’th element of the <tt class="docutils literal"><span class="pre">root</span></tt> array using <a class="reference internal" href="apiref.html#c.json_array_get" title="json_array_get"><tt class="xref c c-func docutils literal"><span class="pre">json_array_get()</span></tt></a>.
+We also check that the resulting value is a JSON object.</p>
+<p>Next we’ll extract the commit ID (a hexadecimal SHA-1 sum),
+intermediate commit info object, and the commit message from that
+object. We also do proper type checks:</p>
+<div class="highlight-c"><div class="highlight"><pre> <span class="n">sha</span> <span class="o">=</span> <span class="n">json_object_get</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="s">"sha"</span><span class="p">);</span>
+ <span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">json_is_string</span><span class="p">(</span><span class="n">sha</span><span class="p">))</span>
+ <span class="p">{</span>
+ <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"error: commit %d: sha is not a string</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="n">json_decref</span><span class="p">(</span><span class="n">root</span><span class="p">);</span>
+ <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+ <span class="p">}</span>
+
+ <span class="n">commit</span> <span class="o">=</span> <span class="n">json_object_get</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="s">"commit"</span><span class="p">);</span>
+ <span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">json_is_object</span><span class="p">(</span><span class="n">commit</span><span class="p">))</span>
+ <span class="p">{</span>
+ <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"error: commit %d: commit is not an object</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="n">json_decref</span><span class="p">(</span><span class="n">root</span><span class="p">);</span>
+ <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+ <span class="p">}</span>
+
+ <span class="n">message</span> <span class="o">=</span> <span class="n">json_object_get</span><span class="p">(</span><span class="n">commit</span><span class="p">,</span> <span class="s">"message"</span><span class="p">);</span>
+ <span class="k">if</span><span class="p">(</span><span class="o">!</span><span class="n">json_is_string</span><span class="p">(</span><span class="n">message</span><span class="p">))</span>
+ <span class="p">{</span>
+ <span class="n">fprintf</span><span class="p">(</span><span class="n">stderr</span><span class="p">,</span> <span class="s">"error: commit %d: message is not a string</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">i</span> <span class="o">+</span> <span class="mi">1</span><span class="p">);</span>
+ <span class="n">json_decref</span><span class="p">(</span><span class="n">root</span><span class="p">);</span>
+ <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+ <span class="p">}</span>
+<span class="p">...</span>
+</pre></div>
+</div>
+<p>And finally, we’ll print the first 8 characters of the commit ID and
+the first line of the commit message. A C-style string is extracted
+from a JSON string using <a class="reference internal" href="apiref.html#c.json_string_value" title="json_string_value"><tt class="xref c c-func docutils literal"><span class="pre">json_string_value()</span></tt></a>:</p>
+<div class="highlight-c"><div class="highlight"><pre> <span class="n">message_text</span> <span class="o">=</span> <span class="n">json_string_value</span><span class="p">(</span><span class="n">message</span><span class="p">);</span>
+ <span class="n">printf</span><span class="p">(</span><span class="s">"%.8s %.*s</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span>
+ <span class="n">json_string_value</span><span class="p">(</span><span class="n">id</span><span class="p">),</span>
+ <span class="n">newline_offset</span><span class="p">(</span><span class="n">message_text</span><span class="p">),</span>
+ <span class="n">message_text</span><span class="p">);</span>
+<span class="p">}</span>
+</pre></div>
+</div>
+<p>After sending the HTTP request, we decoded the JSON text using
+<a class="reference internal" href="apiref.html#c.json_loads" title="json_loads"><tt class="xref c c-func docutils literal"><span class="pre">json_loads()</span></tt></a>, remember? It returns a <em>new reference</em> to the
+JSON value it decodes. When we’re finished with the value, we’ll need
+to decrease the reference count using <a class="reference internal" href="apiref.html#c.json_decref" title="json_decref"><tt class="xref c c-func docutils literal"><span class="pre">json_decref()</span></tt></a>. This way
+Jansson can release the resources:</p>
+<div class="highlight-c"><div class="highlight"><pre><span class="n">json_decref</span><span class="p">(</span><span class="n">root</span><span class="p">);</span>
+<span class="k">return</span> <span class="mi">0</span><span class="p">;</span>
+</pre></div>
+</div>
+<p>For a detailed explanation of reference counting in Jansson, see
+<a class="reference internal" href="apiref.html#apiref-reference-count"><em>Reference Count</em></a> in <a class="reference internal" href="apiref.html#apiref"><em>API Reference</em></a>.</p>
+<p>The program’s ready, let’s test it and view the latest commits in
+Jansson’s repository:</p>
+<div class="highlight-c"><div class="highlight"><pre>$ ./github_commits akheron jansson
+1581f26a Merge branch '2.3'
+aabfd493 load: Change buffer_pos to be a size_t
+bd72efbd load: Avoid unexpected behaviour in macro expansion
+e8fd3e30 Document and tweak json_load_callback()
+873eddaf Merge pull request #60 from rogerz/contrib
+bd2c0c73 Ignore the binary test_load_callback
+17a51a4b Merge branch '2.3'
+09c39adc Add json_load_callback to the list of exported symbols
+cbb80baf Merge pull request #57 from rogerz/contrib
+040bd7b0 Add json_load_callback()
+2637faa4 Make test stripping locale independent
+<...>
+</pre></div>
+</div>
+</div>
+<div class="section" id="conclusion">
+<h2>Conclusion<a class="headerlink" href="#conclusion" title="Permalink to this headline">¶</a></h2>
+<p>In this tutorial, we implemented a program that fetches the latest
+commits of a GitHub repository using the GitHub Repo Commits API.
+Jansson was used to decode the JSON response and to extract the commit
+data.</p>
+<p>This tutorial only covered a small part of Jansson. For example, we
+did not create or manipulate JSON values at all. Proceed to
+<a class="reference internal" href="apiref.html#apiref"><em>API Reference</em></a> to explore all features of Jansson.</p>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="index.html">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">Tutorial</a><ul>
+<li><a class="reference internal" href="#the-github-repo-commits-api">The GitHub Repo Commits API</a></li>
+<li><a class="reference internal" href="#the-program">The Program</a></li>
+<li><a class="reference internal" href="#conclusion">Conclusion</a></li>
+</ul>
+</li>
+</ul>
+
+ <h4>Previous topic</h4>
+ <p class="topless"><a href="upgrading.html"
+ title="previous chapter">Upgrading from 1.x</a></p>
+ <h4>Next topic</h4>
+ <p class="topless"><a href="conformance.html"
+ title="next chapter">RFC Conformance</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/tutorial.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="conformance.html" title="RFC Conformance"
+ >next</a> |</li>
+ <li class="right" >
+ <a href="upgrading.html" title="Upgrading from 1.x"
+ >previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/html/upgrading.html Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,181 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+
+ <title>Upgrading from 1.x — Jansson 2.7 documentation</title>
+
+ <link rel="stylesheet" href="_static/default.css" type="text/css" />
+ <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT: './',
+ VERSION: '2.7',
+ COLLAPSE_INDEX: false,
+ FILE_SUFFIX: '.html',
+ HAS_SOURCE: true
+ };
+ </script>
+ <script type="text/javascript" src="_static/jquery.js"></script>
+ <script type="text/javascript" src="_static/underscore.js"></script>
+ <script type="text/javascript" src="_static/doctools.js"></script>
+ <link rel="top" title="Jansson 2.7 documentation" href="index.html" />
+ <link rel="next" title="Tutorial" href="tutorial.html" />
+ <link rel="prev" title="Getting Started" href="gettingstarted.html" />
+ </head>
+ <body>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ accesskey="I">index</a></li>
+ <li class="right" >
+ <a href="tutorial.html" title="Tutorial"
+ accesskey="N">next</a> |</li>
+ <li class="right" >
+ <a href="gettingstarted.html" title="Getting Started"
+ accesskey="P">previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+
+ <div class="document">
+ <div class="documentwrapper">
+ <div class="bodywrapper">
+ <div class="body">
+
+ <div class="section" id="upgrading-from-1-x">
+<h1>Upgrading from 1.x<a class="headerlink" href="#upgrading-from-1-x" title="Permalink to this headline">¶</a></h1>
+<p>This chapter lists the backwards incompatible changes introduced in
+Jansson 2.0, and the steps that are needed for upgrading your code.</p>
+<p><strong>The incompatibilities are not dramatic.</strong> The biggest change is that
+all decoding functions now require and extra parameter. Most programs
+can be modified to work with 2.0 by adding a <tt class="docutils literal"><span class="pre">0</span></tt> as the second
+parameter to all calls of <a class="reference internal" href="apiref.html#c.json_loads" title="json_loads"><tt class="xref c c-func docutils literal"><span class="pre">json_loads()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_loadf" title="json_loadf"><tt class="xref c c-func docutils literal"><span class="pre">json_loadf()</span></tt></a>
+and <a class="reference internal" href="apiref.html#c.json_load_file" title="json_load_file"><tt class="xref c c-func docutils literal"><span class="pre">json_load_file()</span></tt></a>.</p>
+<div class="section" id="compatibility">
+<h2>Compatibility<a class="headerlink" href="#compatibility" title="Permalink to this headline">¶</a></h2>
+<p>Jansson 2.0 is backwards incompatible with the Jansson 1.x releases.
+It is ABI incompatible, i.e. all programs dynamically linking to the
+Jansson library need to be recompiled. It’s also API incompatible,
+i.e. the source code of programs using Jansson 1.x may need
+modifications to make them compile against Jansson 2.0.</p>
+<p>All the 2.x releases are guaranteed to be backwards compatible for
+both ABI and API, so no recompilation or source changes are needed
+when upgrading from 2.x to 2.y.</p>
+</div>
+<div class="section" id="list-of-incompatible-changes">
+<h2>List of Incompatible Changes<a class="headerlink" href="#list-of-incompatible-changes" title="Permalink to this headline">¶</a></h2>
+<dl class="docutils">
+<dt><strong>Decoding flags</strong></dt>
+<dd><p class="first">For future needs, a <tt class="docutils literal"><span class="pre">flags</span></tt> parameter was added as the second
+parameter to all decoding functions, i.e. <a class="reference internal" href="apiref.html#c.json_loads" title="json_loads"><tt class="xref c c-func docutils literal"><span class="pre">json_loads()</span></tt></a>,
+<a class="reference internal" href="apiref.html#c.json_loadf" title="json_loadf"><tt class="xref c c-func docutils literal"><span class="pre">json_loadf()</span></tt></a> and <a class="reference internal" href="apiref.html#c.json_load_file" title="json_load_file"><tt class="xref c c-func docutils literal"><span class="pre">json_load_file()</span></tt></a>. All calls to
+these functions need to be changed by adding a <tt class="docutils literal"><span class="pre">0</span></tt> as the second
+argument. For example:</p>
+<div class="last highlight-c"><div class="highlight"><pre><span class="cm">/* old code */</span>
+<span class="n">json_loads</span><span class="p">(</span><span class="n">input</span><span class="p">,</span> <span class="o">&</span><span class="n">error</span><span class="p">);</span>
+
+<span class="cm">/* new code */</span>
+<span class="n">json_loads</span><span class="p">(</span><span class="n">input</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="o">&</span><span class="n">error</span><span class="p">);</span>
+</pre></div>
+</div>
+</dd>
+<dt><strong>Underlying type of JSON integers</strong></dt>
+<dd><p class="first">The underlying C type of JSON integers has been changed from
+<tt class="xref c c-type docutils literal"><span class="pre">int</span></tt> to the widest available signed integer type, i.e.
+<tt class="xref c c-type docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt> or <tt class="xref c c-type docutils literal"><span class="pre">long</span></tt>, depending on whether
+<tt class="xref c c-type docutils literal"><span class="pre">long</span> <span class="pre">long</span></tt> is supported on your system or not. This makes
+the whole 64-bit integer range available on most modern systems.</p>
+<p class="last"><tt class="docutils literal"><span class="pre">jansson.h</span></tt> has a typedef <a class="reference internal" href="apiref.html#c.json_int_t" title="json_int_t"><tt class="xref c c-type docutils literal"><span class="pre">json_int_t</span></tt></a> to the underlying
+integer type. <tt class="xref c c-type docutils literal"><span class="pre">int</span></tt> should still be used in most cases when
+dealing with smallish JSON integers, as the compiler handles
+implicit type coercion. Only when the full 64-bit range is needed,
+<a class="reference internal" href="apiref.html#c.json_int_t" title="json_int_t"><tt class="xref c c-type docutils literal"><span class="pre">json_int_t</span></tt></a> should be explicitly used.</p>
+</dd>
+<dt><strong>Maximum encoder indentation depth</strong></dt>
+<dd>The maximum argument of the <tt class="docutils literal"><span class="pre">JSON_INDENT()</span></tt> macro has been
+changed from 255 to 31, to free up bits from the <tt class="docutils literal"><span class="pre">flags</span></tt>
+parameter of <a class="reference internal" href="apiref.html#c.json_dumps" title="json_dumps"><tt class="xref c c-func docutils literal"><span class="pre">json_dumps()</span></tt></a>, <a class="reference internal" href="apiref.html#c.json_dumpf" title="json_dumpf"><tt class="xref c c-func docutils literal"><span class="pre">json_dumpf()</span></tt></a> and
+<a class="reference internal" href="apiref.html#c.json_dump_file" title="json_dump_file"><tt class="xref c c-func docutils literal"><span class="pre">json_dump_file()</span></tt></a>. If your code uses a bigger indentation
+than 31, it needs to be changed.</dd>
+<dt><strong>Unsigned integers in API functions</strong></dt>
+<dd>Version 2.0 unifies unsigned integer usage in the API. All uses of
+<tt class="xref c c-type docutils literal"><span class="pre">unsigned</span> <span class="pre">int</span></tt> and <tt class="xref c c-type docutils literal"><span class="pre">unsigned</span> <span class="pre">long</span></tt> have been replaced
+with <tt class="xref c c-type docutils literal"><span class="pre">size_t</span></tt>. This includes flags, container sizes, etc.
+This should not require source code changes, as both
+<tt class="xref c c-type docutils literal"><span class="pre">unsigned</span> <span class="pre">int</span></tt> and <tt class="xref c c-type docutils literal"><span class="pre">unsigned</span> <span class="pre">long</span></tt> are usually
+compatible with <tt class="xref c c-type docutils literal"><span class="pre">size_t</span></tt>.</dd>
+</dl>
+</div>
+</div>
+
+
+ </div>
+ </div>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+ <h3><a href="index.html">Table Of Contents</a></h3>
+ <ul>
+<li><a class="reference internal" href="#">Upgrading from 1.x</a><ul>
+<li><a class="reference internal" href="#compatibility">Compatibility</a></li>
+<li><a class="reference internal" href="#list-of-incompatible-changes">List of Incompatible Changes</a></li>
+</ul>
+</li>
+</ul>
+
+ <h4>Previous topic</h4>
+ <p class="topless"><a href="gettingstarted.html"
+ title="previous chapter">Getting Started</a></p>
+ <h4>Next topic</h4>
+ <p class="topless"><a href="tutorial.html"
+ title="next chapter">Tutorial</a></p>
+ <h3>This Page</h3>
+ <ul class="this-page-menu">
+ <li><a href="_sources/upgrading.txt"
+ rel="nofollow">Show Source</a></li>
+ </ul>
+<div id="searchbox" style="display: none">
+ <h3>Quick search</h3>
+ <form class="search" action="search.html" method="get">
+ <input type="text" name="q" />
+ <input type="submit" value="Go" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+ <p class="searchtip" style="font-size: 90%">
+ Enter search terms or a module, class or function name.
+ </p>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+ </div>
+ </div>
+ <div class="clearer"></div>
+ </div>
+ <div class="related">
+ <h3>Navigation</h3>
+ <ul>
+ <li class="right" style="margin-right: 10px">
+ <a href="genindex.html" title="General Index"
+ >index</a></li>
+ <li class="right" >
+ <a href="tutorial.html" title="Tutorial"
+ >next</a> |</li>
+ <li class="right" >
+ <a href="gettingstarted.html" title="Getting Started"
+ >previous</a> |</li>
+ <li><a href="index.html">Jansson 2.7 documentation</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2009-2014, Petri Lehtinen.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.2.
+ </div>
+ </body>
+</html>
\ No newline at end of file
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/doc/man3lib/jansson.3lib Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,3652 @@
+.\" Man page generated from reStructuredText.
+.
+.TH "JANSSON" "3LIB" "October 28, 2014" "2.7" "Jansson"
+.SH NAME
+jansson \- Jansson Documentation
+.sp
+This is the documentation for \fI\%Jansson\fP 2.7, last updated October 28, 2014\&.
+.SH INTRODUCTION
+.sp
+\fI\%Jansson\fP is a C library for encoding, decoding and manipulating JSON
+data. Its main features and design principles are:
+.INDENT 0.0
+.IP \(bu 2
+Simple and intuitive API and data model
+.IP \(bu 2
+Comprehensive documentation
+.IP \(bu 2
+No dependencies on other libraries
+.IP \(bu 2
+Full Unicode support (UTF\-8)
+.IP \(bu 2
+Extensive test suite
+.UNINDENT
+.sp
+Jansson is licensed under the \fI\%MIT license\fP; see LICENSE in the
+source distribution for details.
+.sp
+Jansson is used in production and its API is stable. It works on
+numerous platforms, including numerous Unix like systems and Windows.
+It\(aqs suitable for use on any system, including desktop, server, and
+small embedded systems.
+.SH CONTENTS
+.SS Getting Started
+.SS Compiling and Installing Jansson
+.sp
+The Jansson source is available at
+\fI\%http://www.digip.org/jansson/releases/\fP\&.
+.SS Unix\-like systems (including MinGW)
+.sp
+Unpack the source tarball and change to the source directory:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+bunzip2 \-c jansson\-2.7\&.tar.bz2 | tar xf \-
+cd jansson\-2.7
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The source uses GNU Autotools (\fI\%autoconf\fP, \fI\%automake\fP, \fI\%libtool\fP), so
+compiling and installing is extremely simple:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+\&./configure
+make
+make check
+make install
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+To change the destination directory (\fB/usr/local\fP by default), use
+the \fB\-\-prefix=DIR\fP argument to \fB\&./configure\fP\&. See \fB\&./configure
+\-\-help\fP for the list of all possible installation options. (There are
+no options to customize the resulting Jansson binary.)
+.sp
+The command \fBmake check\fP runs the test suite distributed with
+Jansson. This step is not strictly necessary, but it may find possible
+problems that Jansson has on your platform. If any problems are found,
+please report them.
+.sp
+If you obtained the source from a Git repository (or any other source
+control system), there\(aqs no \fB\&./configure\fP script as it\(aqs not kept in
+version control. To create the script, the build system needs to be
+bootstrapped. There are many ways to do this, but the easiest one is
+to use \fBautoreconf\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+autoreconf \-vi
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This command creates the \fB\&./configure\fP script, which can then be
+used as described above.
+.SS CMake (various platforms, including Windows)
+.sp
+Jansson can be built using \fI\%CMake\fP\&. Create a build directory for an
+out\-of\-tree build, change to that directory, and run \fBcmake\fP (or \fBccmake\fP,
+\fBcmake\-gui\fP, or similar) to configure the project.
+.sp
+See the examples below for more detailed information.
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+In the below examples \fB\&..\fP is used as an argument for \fBcmake\fP\&.
+This is simply the path to the jansson project root directory.
+In the example it is assumed you\(aqve created a sub\-directory \fBbuild\fP
+and are using that. You could use any path you want.
+.UNINDENT
+.UNINDENT
+.SS Unix (Make files)
+.sp
+Generating make files on unix:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+bunzip2 \-c jansson\-2.7\&.tar.bz2 | tar xf \-
+cd jansson\-2.7
+
+mkdir build
+cd build
+cmake .. # or \fBccmake ..()\fP for a GUI.
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Then to build:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+make
+make check
+make install
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Windows (Visual Studio)
+.sp
+Creating Visual Studio project files from the command line:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+<unpack>
+cd jansson\-2.7
+
+md build
+cd build
+cmake \-G "Visual Studio 10" ..
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+You will now have a \fIVisual Studio Solution\fP in your build directory.
+To run the unit tests build the \fBRUN_TESTS\fP project.
+.sp
+If you prefer a GUI the \fBcmake\fP line in the above example can
+be replaced with:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+cmake\-gui ..
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+For command line help (including a list of available generators)
+for \fI\%CMake\fP simply run:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+cmake
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+To list available \fI\%CMake\fP settings (and what they are currently set to)
+for the project, run:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+cmake \-LH ..
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Mac OSX (Xcode)
+.sp
+If you prefer using Xcode instead of make files on OSX,
+do the following. (Use the same steps as
+for \fIUnix\fP):
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+\&...
+cmake \-G "Xcode" ..
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Additional CMake settings
+.SS Shared library
+.sp
+By default the \fI\%CMake\fP project will generate build files for building the
+static library. To build the shared version use:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+\&...
+cmake \-DJANSSON_BUILD_SHARED_LIBS=1 ..
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Changing install directory (same as autoconf \-\-prefix)
+.sp
+Just as with the \fI\%autoconf\fP project you can change the destination directory
+for \fBmake install\fP\&. The equivalent for autoconfs \fB\&./configure \-\-prefix\fP
+in \fI\%CMake\fP is:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+\&...
+cmake \-DCMAKE_INSTALL_PREFIX:PATH=/some/other/path ..
+make install
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Android
+.sp
+Jansson can be built for Android platforms. Android.mk is in the
+source root directory. The configuration header file is located in the
+\fBandroid\fP directory in the source distribution.
+.SS Other Systems
+.sp
+On non Unix\-like systems, you may be unable to run the \fB\&./configure\fP
+script. In this case, follow these steps. All the files mentioned can
+be found in the \fBsrc/\fP directory.
+.INDENT 0.0
+.IP 1. 3
+Create \fBjansson_config.h\fP (which has some platform\-specific
+parameters that are normally filled in by the \fB\&./configure\fP
+script). Edit \fBjansson_config.h.in\fP, replacing all \fB@variable@\fP
+placeholders, and rename the file to \fBjansson_config.h\fP\&.
+.IP 2. 3
+Make \fBjansson.h\fP and \fBjansson_config.h\fP available to the
+compiler, so that they can be found when compiling programs that
+use Jansson.
+.IP 3. 3
+Compile all the \fB\&.c\fP files (in the \fBsrc/\fP directory) into a
+library file. Make the library available to the compiler, as in
+step 2.
+.UNINDENT
+.SS Building the Documentation
+.sp
+(This subsection describes how to build the HTML documentation you are
+currently reading, so it can be safely skipped.)
+.sp
+Documentation is in the \fBdoc/\fP subdirectory. It\(aqs written in
+\fI\%reStructuredText\fP with \fI\%Sphinx\fP annotations. To generate the HTML
+documentation, invoke:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+make html
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+and point your browser to \fBdoc/_build/html/index.html\fP\&. \fI\%Sphinx\fP 1.0
+or newer is required to generate the documentation.
+.SS Compiling Programs that Use Jansson
+.sp
+Jansson involves one C header file, \fBjansson.h\fP, so it\(aqs enough
+to put the line
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+#include <jansson.h>
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+in the beginning of every source file that uses Jansson.
+.sp
+There\(aqs also just one library to link with, \fBlibjansson\fP\&. Compile and
+link the program as follows:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+cc \-I/usr/include/jansson \-o prog prog.c \-ljansson
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Starting from version 1.2, there\(aqs also support for \fI\%pkg\-config\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+cc \-o prog prog.c \(gapkg\-config \-\-cflags \-\-libs jansson\(ga
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Upgrading from 1.x
+.sp
+This chapter lists the backwards incompatible changes introduced in
+Jansson 2.0, and the steps that are needed for upgrading your code.
+.sp
+\fBThe incompatibilities are not dramatic.\fP The biggest change is that
+all decoding functions now require and extra parameter. Most programs
+can be modified to work with 2.0 by adding a \fB0\fP as the second
+parameter to all calls of \fBjson_loads()\fP, \fBjson_loadf()\fP
+and \fBjson_load_file()\fP\&.
+.SS Compatibility
+.sp
+Jansson 2.0 is backwards incompatible with the Jansson 1.x releases.
+It is ABI incompatible, i.e. all programs dynamically linking to the
+Jansson library need to be recompiled. It\(aqs also API incompatible,
+i.e. the source code of programs using Jansson 1.x may need
+modifications to make them compile against Jansson 2.0.
+.sp
+All the 2.x releases are guaranteed to be backwards compatible for
+both ABI and API, so no recompilation or source changes are needed
+when upgrading from 2.x to 2.y.
+.SS List of Incompatible Changes
+.INDENT 0.0
+.TP
+.B \fBDecoding flags\fP
+For future needs, a \fBflags\fP parameter was added as the second
+parameter to all decoding functions, i.e. \fBjson_loads()\fP,
+\fBjson_loadf()\fP and \fBjson_load_file()\fP\&. All calls to
+these functions need to be changed by adding a \fB0\fP as the second
+argument. For example:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+/* old code */
+json_loads(input, &error);
+
+/* new code */
+json_loads(input, 0, &error);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.TP
+.B \fBUnderlying type of JSON integers\fP
+The underlying C type of JSON integers has been changed from
+\fBint\fP to the widest available signed integer type, i.e.
+\fBlong long\fP or \fBlong\fP, depending on whether
+\fBlong long\fP is supported on your system or not. This makes
+the whole 64\-bit integer range available on most modern systems.
+.sp
+\fBjansson.h\fP has a typedef \fBjson_int_t\fP to the underlying
+integer type. \fBint\fP should still be used in most cases when
+dealing with smallish JSON integers, as the compiler handles
+implicit type coercion. Only when the full 64\-bit range is needed,
+\fBjson_int_t\fP should be explicitly used.
+.TP
+.B \fBMaximum encoder indentation depth\fP
+The maximum argument of the \fBJSON_INDENT()\fP macro has been
+changed from 255 to 31, to free up bits from the \fBflags\fP
+parameter of \fBjson_dumps()\fP, \fBjson_dumpf()\fP and
+\fBjson_dump_file()\fP\&. If your code uses a bigger indentation
+than 31, it needs to be changed.
+.TP
+.B \fBUnsigned integers in API functions\fP
+Version 2.0 unifies unsigned integer usage in the API. All uses of
+\fBunsigned int\fP and \fBunsigned long\fP have been replaced
+with \fBsize_t\fP\&. This includes flags, container sizes, etc.
+This should not require source code changes, as both
+\fBunsigned int\fP and \fBunsigned long\fP are usually
+compatible with \fBsize_t\fP\&.
+.UNINDENT
+.SS Tutorial
+.sp
+In this tutorial, we create a program that fetches the latest commits
+of a repository in \fI\%GitHub\fP over the web. \fI\%GitHub API\fP uses JSON, so
+the result can be parsed using Jansson.
+.sp
+To stick to the the scope of this tutorial, we will only cover the the
+parts of the program related to handling JSON data. For the best user
+experience, the full source code is available:
+\fBgithub_commits.c\fP\&. To compile it (on Unix\-like systems with
+gcc), use the following command:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+gcc \-o github_commits github_commits.c \-ljansson \-lcurl
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fI\%libcurl\fP is used to communicate over the web, so it is required to
+compile the program.
+.sp
+The command line syntax is:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+github_commits USER REPOSITORY
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fBUSER\fP is a GitHub user ID and \fBREPOSITORY\fP is the repository
+name. Please note that the GitHub API is rate limited, so if you run
+the program too many times within a short period of time, the sever
+starts to respond with an error.
+.SS The GitHub Repo Commits API
+.sp
+The \fI\%GitHub Repo Commits API\fP is used by sending HTTP requests to
+URLs like \fBhttps://api.github.com/repos/USER/REPOSITORY/commits\fP,
+where \fBUSER\fP and \fBREPOSITORY\fP are the GitHub user ID and the name
+of the repository whose commits are to be listed, respectively.
+.sp
+GitHub responds with a JSON array of the following form:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+[
+ {
+ "sha": "<the commit ID>",
+ "commit": {
+ "message": "<the commit message>",
+ <more fields, not important to this tutorial...>
+ },
+ <more fields...>
+ },
+ {
+ "sha": "<the commit ID>",
+ "commit": {
+ "message": "<the commit message>",
+ <more fields...>
+ },
+ <more fields...>
+ },
+ <more commits...>
+]
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+In our program, the HTTP request is sent using the following
+function:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+static char *request(const char *url);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+It takes the URL as a parameter, preforms a HTTP GET request, and
+returns a newly allocated string that contains the response body. If
+the request fails, an error message is printed to stderr and the
+return value is \fINULL\fP\&. For full details, refer to \fBthe code\fP, as the actual implementation is not important
+here.
+.SS The Program
+.sp
+First the includes:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+#include <string.h>
+#include <jansson.h>
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Like all the programs using Jansson, we need to include
+\fBjansson.h\fP\&.
+.sp
+The following definitions are used to build the GitHub API request
+URL:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+#define URL_FORMAT "https://api.github.com/repos/%s/%s/commits"
+#define URL_SIZE 256
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The following function is used when formatting the result to find the
+first newline in the commit message:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+/* Return the offset of the first newline in text or the length of
+ text if there\(aqs no newline */
+static int newline_offset(const char *text)
+{
+ const char *newline = strchr(text, \(aq\en\(aq);
+ if(!newline)
+ return strlen(text);
+ else
+ return (int)(newline \- text);
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The main function follows. In the beginning, we first declare a bunch
+of variables and check the command line parameters:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+int main(int argc, char *argv[])
+{
+ size_t i;
+ char *text;
+ char url[URL_SIZE];
+
+ json_t *root;
+ json_error_t error;
+
+ if(argc != 3)
+ {
+ fprintf(stderr, "usage: %s USER REPOSITORY\en\en", argv[0]);
+ fprintf(stderr, "List commits at USER\(aqs REPOSITORY.\en\en");
+ return 2;
+ }
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Then we build the request URL using the user and repository names
+given as command line parameters:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+snprintf(url, URL_SIZE, URL_FORMAT, argv[1], argv[2]);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+This uses the \fBURL_SIZE\fP and \fBURL_FORMAT\fP constants defined above.
+Now we\(aqre ready to actually request the JSON data over the web:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+text = request(url);
+if(!text)
+ return 1;
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+If an error occurs, our function \fBrequest\fP prints the error and
+returns \fINULL\fP, so it\(aqs enough to just return 1 from the main
+function.
+.sp
+Next we\(aqll call \fBjson_loads()\fP to decode the JSON text we got
+as a response:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+root = json_loads(text, 0, &error);
+free(text);
+
+if(!root)
+{
+ fprintf(stderr, "error: on line %d: %s\en", error.line, error.text);
+ return 1;
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+We don\(aqt need the JSON text anymore, so we can free the \fBtext\fP
+variable right after decoding it. If \fBjson_loads()\fP fails, it
+returns \fINULL\fP and sets error information to the \fBjson_error_t\fP
+structure given as the second parameter. In this case, our program
+prints the error information out and returns 1 from the main function.
+.sp
+Now we\(aqre ready to extract the data out of the decoded JSON response.
+The structure of the response JSON was explained in section
+\fI\%The GitHub Repo Commits API\fP\&.
+.sp
+We check that the returned value really is an array:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+if(!json_is_array(root))
+{
+ fprintf(stderr, "error: root is not an array\en");
+ json_decref(root);
+ return 1;
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Then we proceed to loop over all the commits in the array:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+for(i = 0; i < json_array_size(root); i++)
+{
+ json_t *data, *sha, *commit, *message;
+ const char *message_text;
+
+ data = json_array_get(root, i);
+ if(!json_is_object(data))
+ {
+ fprintf(stderr, "error: commit data %d is not an object\en", i + 1);
+ json_decref(root);
+ return 1;
+ }
+\&...
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The function \fBjson_array_size()\fP returns the size of a JSON
+array. First, we again declare some variables and then extract the
+i\(aqth element of the \fBroot\fP array using \fBjson_array_get()\fP\&.
+We also check that the resulting value is a JSON object.
+.sp
+Next we\(aqll extract the commit ID (a hexadecimal SHA\-1 sum),
+intermediate commit info object, and the commit message from that
+object. We also do proper type checks:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+ sha = json_object_get(data, "sha");
+ if(!json_is_string(sha))
+ {
+ fprintf(stderr, "error: commit %d: sha is not a string\en", i + 1);
+ json_decref(root);
+ return 1;
+ }
+
+ commit = json_object_get(data, "commit");
+ if(!json_is_object(commit))
+ {
+ fprintf(stderr, "error: commit %d: commit is not an object\en", i + 1);
+ json_decref(root);
+ return 1;
+ }
+
+ message = json_object_get(commit, "message");
+ if(!json_is_string(message))
+ {
+ fprintf(stderr, "error: commit %d: message is not a string\en", i + 1);
+ json_decref(root);
+ return 1;
+ }
+\&...
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+And finally, we\(aqll print the first 8 characters of the commit ID and
+the first line of the commit message. A C\-style string is extracted
+from a JSON string using \fBjson_string_value()\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+ message_text = json_string_value(message);
+ printf("%.8s %.*s\en",
+ json_string_value(id),
+ newline_offset(message_text),
+ message_text);
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+After sending the HTTP request, we decoded the JSON text using
+\fBjson_loads()\fP, remember? It returns a \fInew reference\fP to the
+JSON value it decodes. When we\(aqre finished with the value, we\(aqll need
+to decrease the reference count using \fBjson_decref()\fP\&. This way
+Jansson can release the resources:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+json_decref(root);
+return 0;
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+For a detailed explanation of reference counting in Jansson, see
+\fIapiref\-reference\-count\fP in \fIapiref\fP\&.
+.sp
+The program\(aqs ready, let\(aqs test it and view the latest commits in
+Jansson\(aqs repository:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+$ ./github_commits akheron jansson
+1581f26a Merge branch \(aq2.3\(aq
+aabfd493 load: Change buffer_pos to be a size_t
+bd72efbd load: Avoid unexpected behaviour in macro expansion
+e8fd3e30 Document and tweak json_load_callback()
+873eddaf Merge pull request #60 from rogerz/contrib
+bd2c0c73 Ignore the binary test_load_callback
+17a51a4b Merge branch \(aq2.3\(aq
+09c39adc Add json_load_callback to the list of exported symbols
+cbb80baf Merge pull request #57 from rogerz/contrib
+040bd7b0 Add json_load_callback()
+2637faa4 Make test stripping locale independent
+<...>
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Conclusion
+.sp
+In this tutorial, we implemented a program that fetches the latest
+commits of a GitHub repository using the GitHub Repo Commits API.
+Jansson was used to decode the JSON response and to extract the commit
+data.
+.sp
+This tutorial only covered a small part of Jansson. For example, we
+did not create or manipulate JSON values at all. Proceed to
+\fIapiref\fP to explore all features of Jansson.
+.SS RFC Conformance
+.sp
+JSON is specified in \fI\%RFC 4627\fP, \fI"The application/json Media Type
+for JavaScript Object Notation (JSON)"\fP\&.
+.SS Character Encoding
+.sp
+Jansson only supports UTF\-8 encoded JSON texts. It does not support or
+auto\-detect any of the other encodings mentioned in the RFC, namely
+UTF\-16LE, UTF\-16BE, UTF\-32LE or UTF\-32BE. Pure ASCII is supported, as
+it\(aqs a subset of UTF\-8.
+.SS Strings
+.sp
+JSON strings are mapped to C\-style null\-terminated character arrays,
+and UTF\-8 encoding is used internally.
+.sp
+All Unicode codepoints U+0000 through U+10FFFF are allowed in string
+values. However, U+0000 is not allowed in object keys because of API
+restrictions.
+.sp
+Unicode normalization or any other transformation is never performed
+on any strings (string values or object keys). When checking for
+equivalence of strings or object keys, the comparison is performed
+byte by byte between the original UTF\-8 representations of the
+strings.
+.SS Numbers
+.SS Real vs. Integer
+.sp
+JSON makes no distinction between real and integer numbers; Jansson
+does. Real numbers are mapped to the \fBdouble\fP type and integers to
+the \fBjson_int_t\fP type, which is a typedef of \fBlong long\fP or
+\fBlong\fP, depending on whether \fBlong long\fP is supported by your
+compiler or not.
+.sp
+A JSON number is considered to be a real number if its lexical
+representation includes one of \fBe\fP, \fBE\fP, or \fB\&.\fP; regardless if
+its actual numeric value is a true integer (e.g., all of \fB1E6\fP,
+\fB3.0\fP, \fB400E\-2\fP, and \fB3.14E3\fP are mathematical integers, but
+will be treated as real values). With the \fBJSON_DECODE_INT_AS_REAL\fP
+decoder flag set all numbers are interpreted as real.
+.sp
+All other JSON numbers are considered integers.
+.sp
+When encoding to JSON, real values are always represented
+with a fractional part; e.g., the \fBdouble\fP value 3.0 will be
+represented in JSON as \fB3.0\fP, not \fB3\fP\&.
+.SS Overflow, Underflow & Precision
+.sp
+Real numbers whose absolute values are too small to be represented in
+a C \fBdouble\fP will be silently estimated with 0.0. Thus, depending on
+platform, JSON numbers very close to zero such as 1E\-999 may result in
+0.0.
+.sp
+Real numbers whose absolute values are too large to be represented in
+a C \fBdouble\fP will result in an overflow error (a JSON decoding
+error). Thus, depending on platform, JSON numbers like 1E+999 or
+\-1E+999 may result in a parsing error.
+.sp
+Likewise, integer numbers whose absolute values are too large to be
+represented in the \fBjson_int_t\fP type (see above) will result in an
+overflow error (a JSON decoding error). Thus, depending on platform,
+JSON numbers like 1000000000000000 may result in parsing error.
+.sp
+Parsing JSON real numbers may result in a loss of precision. As long
+as overflow does not occur (i.e. a total loss of precision), the
+rounded approximate value is silently used. Thus the JSON number
+1.000000000000000005 may, depending on platform, result in the
+\fBdouble\fP value 1.0.
+.SS Signed zeros
+.sp
+JSON makes no statement about what a number means; however Javascript
+(ECMAscript) does state that +0.0 and \-0.0 must be treated as being
+distinct values, i.e. \-0.0 ≠0.0. Jansson relies on the
+underlying floating point library in the C environment in which it is
+compiled. Therefore it is platform\-dependent whether 0.0 and \-0.0 will
+be distinct values. Most platforms that use the IEEE 754
+floating\-point standard will support signed zeros.
+.sp
+Note that this only applies to floating\-point; neither JSON, C, or
+IEEE support the concept of signed integer zeros.
+.SS Types
+.sp
+No support is provided in Jansson for any C numeric types other than
+\fBjson_int_t\fP and \fBdouble\fP\&. This excludes things such as unsigned
+types, \fBlong double\fP, etc. Obviously, shorter types like \fBshort\fP,
+\fBint\fP, \fBlong\fP (if \fBjson_int_t\fP is \fBlong long\fP) and \fBfloat\fP
+are implicitly handled via the ordinary C type coercion rules (subject
+to overflow semantics). Also, no support or hooks are provided for any
+supplemental "bignum" type add\-on packages.
+.SS Portability
+.SS Thread safety
+.sp
+Jansson is thread safe and has no mutable global state. The only
+exceptions are the hash function seed and memory allocation functions,
+see below.
+.sp
+There\(aqs no locking performed inside Jansson\(aqs code, so a multithreaded
+program must perform its own locking if JSON values are shared by
+multiple threads. Jansson\(aqs reference counting semantics may make this
+a bit harder than it seems, as it\(aqs possible to have a reference to a
+value that\(aqs also stored inside a list or object. Modifying the
+container (adding or removing values) may trigger concurrent access to
+such values, as containers manage the reference count of their
+contained values. Bugs involving concurrent incrementing or
+decrementing of deference counts may be hard to track.
+.sp
+The encoding functions (\fBjson_dumps()\fP and friends) track
+reference loops by modifying the internal state of objects and arrays.
+For this reason, encoding functions must not be run on the same JSON
+values in two separate threads at the same time. As already noted
+above, be especially careful if two arrays or objects share their
+contained values with another array or object.
+.sp
+If you want to make sure that two JSON value hierarchies do not
+contain shared values, use \fBjson_deep_copy()\fP to make copies.
+.SS Hash function seed
+.sp
+To prevent an attacker from intentionally causing large JSON objects
+with specially crafted keys to perform very slow, the hash function
+used by Jansson is randomized using a seed value. The seed is
+automatically generated on the first explicit or implicit call to
+\fBjson_object()\fP, if \fBjson_object_seed()\fP has not been
+called beforehand.
+.sp
+The seed is generated by using operating system\(aqs entropy sources if
+they are available (\fB/dev/urandom\fP, \fBCryptGenRandom()\fP). The
+initialization is done in as thread safe manner as possible, by using
+architecture specific lockless operations if provided by the platform
+or the compiler.
+.sp
+If you\(aqre using threads, it\(aqs recommended to autoseed the hashtable
+explicitly before spawning any threads by calling
+\fBjson_object_seed(0)\fP , especially if you\(aqre unsure whether the
+initialization is thread safe on your platform.
+.SS Memory allocation functions
+.sp
+Memory allocation functions should be set at most once, and only on
+program startup. See \fIapiref\-custom\-memory\-allocation\fP\&.
+.SS Locale
+.sp
+Jansson works fine under any locale.
+.sp
+However, if the host program is multithreaded and uses \fBsetlocale()\fP
+to switch the locale in one thread while Jansson is currently encoding
+or decoding JSON data in another thread, the result may be wrong or
+the program may even crash.
+.sp
+Jansson uses locale specific functions for certain string conversions
+in the encoder and decoder, and then converts the locale specific
+values to/from the JSON representation. This fails if the locale
+changes between the string conversion and the locale\-to\-JSON
+conversion. This can only happen in multithreaded programs that use
+\fBsetlocale()\fP, because \fBsetlocale()\fP switches the locale for all
+running threads, not only the thread that calls \fBsetlocale()\fP\&.
+.sp
+If your program uses \fBsetlocale()\fP as described above, consider
+using the thread\-safe \fBuselocale()\fP instead.
+.SS API Reference
+.SS Preliminaries
+.sp
+All declarations are in \fBjansson.h\fP, so it\(aqs enough to
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+#include <jansson.h>
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+in each source file.
+.sp
+All constants are prefixed with \fBJSON_\fP (except for those describing
+the library version, prefixed with \fBJANSSON_\fP). Other identifiers
+are prefixed with \fBjson_\fP\&. Type names are suffixed with \fB_t\fP and
+\fBtypedef\fP\(aqd so that the \fBstruct\fP keyword need not be used.
+.SS Library Version
+.sp
+The Jansson version is of the form \fIA.B.C\fP, where \fIA\fP is the major
+version, \fIB\fP is the minor version and \fIC\fP is the micro version. If the
+micro version is zero, it\(aqs omitted from the version string, i.e. the
+version string is just \fIA.B\fP\&.
+.sp
+When a new release only fixes bugs and doesn\(aqt add new features or
+functionality, the micro version is incremented. When new features are
+added in a backwards compatible way, the minor version is incremented
+and the micro version is set to zero. When there are backwards
+incompatible changes, the major version is incremented and others are
+set to zero.
+.sp
+The following preprocessor constants specify the current version of
+the library:
+.INDENT 0.0
+.TP
+.B \fBJANSSON_MAJOR_VERSION\fP, \fBJANSSON_MINOR_VERSION\fP, \fBJANSSON_MICRO_VERSION\fP
+Integers specifying the major, minor and micro versions,
+respectively.
+.TP
+.B \fBJANSSON_VERSION\fP
+A string representation of the current version, e.g. \fB"1.2.1"\fP or
+\fB"1.3"\fP\&.
+.TP
+.B \fBJANSSON_VERSION_HEX\fP
+A 3\-byte hexadecimal representation of the version, e.g.
+\fB0x010201\fP for version 1.2.1 and \fB0x010300\fP for version 1.3.
+This is useful in numeric comparisions, e.g.:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+#if JANSSON_VERSION_HEX >= 0x010300
+/* Code specific to version 1.3 and above */
+#endif
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.SS Value Representation
+.sp
+The JSON specification (\fI\%RFC 4627\fP) defines the following data types:
+\fIobject\fP, \fIarray\fP, \fIstring\fP, \fInumber\fP, \fIboolean\fP, and \fInull\fP\&. JSON
+types are used dynamically; arrays and objects can hold any other data
+type, including themselves. For this reason, Jansson\(aqs type system is
+also dynamic in nature. There\(aqs one C type to represent all JSON
+values, and this structure knows the type of the JSON value it holds.
+.INDENT 0.0
+.TP
+.B json_t
+This data structure is used throughout the library to represent all
+JSON values. It always contains the type of the JSON value it holds
+and the value\(aqs reference count. The rest depends on the type of the
+value.
+.UNINDENT
+.sp
+Objects of \fBjson_t\fP are always used through a pointer. There
+are APIs for querying the type, manipulating the reference count, and
+for constructing and manipulating values of different types.
+.sp
+Unless noted otherwise, all API functions return an error value if an
+error occurs. Depending on the function\(aqs signature, the error value
+is either \fINULL\fP or \-1. Invalid arguments or invalid input are
+apparent sources for errors. Memory allocation and I/O operations may
+also cause errors.
+.SS Type
+.sp
+The type of a JSON value is queried and tested using the following
+functions:
+.INDENT 0.0
+.TP
+.B enum json_type
+The type of a JSON value. The following members are defined:
+.TS
+center;
+|l|.
+_
+T{
+\fBJSON_OBJECT\fP
+T}
+_
+T{
+\fBJSON_ARRAY\fP
+T}
+_
+T{
+\fBJSON_STRING\fP
+T}
+_
+T{
+\fBJSON_INTEGER\fP
+T}
+_
+T{
+\fBJSON_REAL\fP
+T}
+_
+T{
+\fBJSON_TRUE\fP
+T}
+_
+T{
+\fBJSON_FALSE\fP
+T}
+_
+T{
+\fBJSON_NULL\fP
+T}
+_
+.TE
+.sp
+These correspond to JSON object, array, string, number, boolean and
+null. A number is represented by either a value of the type
+\fBJSON_INTEGER\fP or of the type \fBJSON_REAL\fP\&. A true boolean value
+is represented by a value of the type \fBJSON_TRUE\fP and false by a
+value of the type \fBJSON_FALSE\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_typeof(const json_t\fI\ *json\fP)
+Return the type of the JSON value (a \fBjson_type\fP cast to
+\fBint\fP). \fIjson\fP MUST NOT be \fINULL\fP\&. This function is actually
+implemented as a macro for speed.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_is_object(const json_t\fI\ *json\fP)
+.TP
+.B json_is_array(const json_t\fI\ *json\fP)
+.TP
+.B json_is_string(const json_t\fI\ *json\fP)
+.TP
+.B json_is_integer(const json_t\fI\ *json\fP)
+.TP
+.B json_is_real(const json_t\fI\ *json\fP)
+.TP
+.B json_is_true(const json_t\fI\ *json\fP)
+.TP
+.B json_is_false(const json_t\fI\ *json\fP)
+.TP
+.B json_is_null(const json_t\fI\ *json\fP)
+These functions (actually macros) return true (non\-zero) for values
+of the given type, and false (zero) for values of other types and
+for \fINULL\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_is_number(const json_t\fI\ *json\fP)
+Returns true for values of types \fBJSON_INTEGER\fP and
+\fBJSON_REAL\fP, and false for other types and for \fINULL\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_is_boolean(const json_t\fI\ *json\fP)
+Returns true for types \fBJSON_TRUE\fP and \fBJSON_FALSE\fP, and false
+for values of other types and for \fINULL\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_boolean_value(const json_t\fI\ *json\fP)
+Alias of \fBjson_is_true()\fP, i.e. returns 1 for \fBJSON_TRUE\fP
+and 0 otherwise.
+.sp
+New in version 2.7.
+
+.UNINDENT
+.SS Reference Count
+.sp
+The reference count is used to track whether a value is still in use
+or not. When a value is created, it\(aqs reference count is set to 1. If
+a reference to a value is kept (e.g. a value is stored somewhere for
+later use), its reference count is incremented, and when the value is
+no longer needed, the reference count is decremented. When the
+reference count drops to zero, there are no references left, and the
+value can be destroyed.
+.sp
+The following functions are used to manipulate the reference count.
+.INDENT 0.0
+.TP
+.B json_t *json_incref(json_t\fI\ *json\fP)
+Increment the reference count of \fIjson\fP if it\(aqs not \fINULL\fP\&.
+Returns \fIjson\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void json_decref(json_t\fI\ *json\fP)
+Decrement the reference count of \fIjson\fP\&. As soon as a call to
+\fBjson_decref()\fP drops the reference count to zero, the value
+is destroyed and it can no longer be used.
+.UNINDENT
+.sp
+Functions creating new JSON values set the reference count to 1. These
+functions are said to return a \fBnew reference\fP\&. Other functions
+returning (existing) JSON values do not normally increase the
+reference count. These functions are said to return a \fBborrowed
+reference\fP\&. So, if the user will hold a reference to a value returned
+as a borrowed reference, he must call \fBjson_incref()\fP\&. As soon as
+the value is no longer needed, \fBjson_decref()\fP should be called
+to release the reference.
+.sp
+Normally, all functions accepting a JSON value as an argument will
+manage the reference, i.e. increase and decrease the reference count
+as needed. However, some functions \fBsteal\fP the reference, i.e. they
+have the same result as if the user called \fBjson_decref()\fP on
+the argument right after calling the function. These functions are
+suffixed with \fB_new\fP or have \fB_new_\fP somewhere in their name.
+.sp
+For example, the following code creates a new JSON array and appends
+an integer to it:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+json_t *array, *integer;
+
+array = json_array();
+integer = json_integer(42);
+
+json_array_append(array, integer);
+json_decref(integer);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Note how the caller has to release the reference to the integer value
+by calling \fBjson_decref()\fP\&. By using a reference stealing
+function \fBjson_array_append_new()\fP instead of
+\fBjson_array_append()\fP, the code becomes much simpler:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+json_t *array = json_array();
+json_array_append_new(array, json_integer(42));
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+In this case, the user doesn\(aqt have to explicitly release the
+reference to the integer value, as \fBjson_array_append_new()\fP
+steals the reference when appending the value to the array.
+.sp
+In the following sections it is clearly documented whether a function
+will return a new or borrowed reference or steal a reference to its
+argument.
+.SS Circular References
+.sp
+A circular reference is created when an object or an array is,
+directly or indirectly, inserted inside itself. The direct case is
+simple:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+json_t *obj = json_object();
+json_object_set(obj, "foo", obj);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Jansson will refuse to do this, and \fBjson_object_set()\fP (and
+all the other such functions for objects and arrays) will return with
+an error status. The indirect case is the dangerous one:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+json_t *arr1 = json_array(), *arr2 = json_array();
+json_array_append(arr1, arr2);
+json_array_append(arr2, arr1);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+In this example, the array \fBarr2\fP is contained in the array
+\fBarr1\fP, and vice versa. Jansson cannot check for this kind of
+indirect circular references without a performance hit, so it\(aqs up to
+the user to avoid them.
+.sp
+If a circular reference is created, the memory consumed by the values
+cannot be freed by \fBjson_decref()\fP\&. The reference counts never
+drops to zero because the values are keeping the references to each
+other. Moreover, trying to encode the values with any of the encoding
+functions will fail. The encoder detects circular references and
+returns an error status.
+.SS True, False and Null
+.sp
+These three values are implemented as singletons, so the returned
+pointers won\(aqt change between invocations of these functions.
+.INDENT 0.0
+.TP
+.B json_t *json_true(void)
+Return value: New reference.
+.sp
+Returns the JSON true value.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_false(void)
+Return value: New reference.
+.sp
+Returns the JSON false value.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_boolean(val)
+Return value: New reference.
+.sp
+Returns JSON false if \fBval\fP is zero, and JSON true otherwise.
+This is a macro, and equivalent to \fBval ? json_true() :
+json_false()\fP\&.
+.sp
+New in version 2.4.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_null(void)
+Return value: New reference.
+.sp
+Returns the JSON null value.
+.UNINDENT
+.SS String
+.sp
+Jansson uses UTF\-8 as the character encoding. All JSON strings must be
+valid UTF\-8 (or ASCII, as it\(aqs a subset of UTF\-8). All Unicode
+codepoints U+0000 through U+10FFFF are allowed, but you must use
+length\-aware functions if you wish to embed NUL bytes in strings.
+.INDENT 0.0
+.TP
+.B json_t *json_string(const char\fI\ *value\fP)
+Return value: New reference.
+.sp
+Returns a new JSON string, or \fINULL\fP on error. \fIvalue\fP must be a
+valid null terminated UTF\-8 encoded Unicode string.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_stringn(const char\fI\ *value\fP, size_t\fI\ len\fP)
+Return value: New reference.
+.sp
+Like \fBjson_string()\fP, but with explicit length, so \fIvalue\fP may
+contain null characters or not be null terminated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_string_nocheck(const char\fI\ *value\fP)
+Return value: New reference.
+.sp
+Like \fBjson_string()\fP, but doesn\(aqt check that \fIvalue\fP is valid
+UTF\-8. Use this function only if you are certain that this really
+is the case (e.g. you have already checked it by other means).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_stringn_nocheck(const char\fI\ *value\fP, size_t\fI\ len\fP)
+Return value: New reference.
+.sp
+Like \fBjson_string_nocheck()\fP, but with explicit length, so
+\fIvalue\fP may contain null characters or not be null terminated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B const char *json_string_value(const json_t\fI\ *string\fP)
+Returns the associated value of \fIstring\fP as a null terminated UTF\-8
+encoded string, or \fINULL\fP if \fIstring\fP is not a JSON string.
+.sp
+The retuned value is read\-only and must not be modified or freed by
+the user. It is valid as long as \fIstring\fP exists, i.e. as long as
+its reference count has not dropped to zero.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B size_t json_string_length(const json_t\fI\ *string\fP)
+Returns the length of \fIstring\fP in its UTF\-8 presentation, or zero
+if \fIstring\fP is not a JSON string.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_string_set(const json_t\fI\ *string\fP, const char\fI\ *value\fP)
+Sets the associated value of \fIstring\fP to \fIvalue\fP\&. \fIvalue\fP must be a
+valid UTF\-8 encoded Unicode string. Returns 0 on success and \-1 on
+error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_string_setn(json_t\fI\ *string\fP, const char\fI\ *value\fP, size_t\fI\ len\fP)
+Like \fBjson_string_set()\fP, but with explicit length, so \fIvalue\fP
+may contain null characters or not be null terminated.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_string_set_nocheck(const json_t\fI\ *string\fP, const char\fI\ *value\fP)
+Like \fBjson_string_set()\fP, but doesn\(aqt check that \fIvalue\fP is
+valid UTF\-8. Use this function only if you are certain that this
+really is the case (e.g. you have already checked it by other
+means).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_string_setn_nocheck(json_t\fI\ *string\fP, const char\fI\ *value\fP, size_t\fI\ len\fP)
+Like \fBjson_string_set_nocheck()\fP, but with explicit length,
+so \fIvalue\fP may contain null characters or not be null terminated.
+.UNINDENT
+.SS Number
+.sp
+The JSON specification only contains one numeric type, "number". The C
+programming language has distinct types for integer and floating\-point
+numbers, so for practical reasons Jansson also has distinct types for
+the two. They are called "integer" and "real", respectively. For more
+information, see \fIrfc\-conformance\fP\&.
+.INDENT 0.0
+.TP
+.B json_int_t
+This is the C type that is used to store JSON integer values. It
+represents the widest integer type available on your system. In
+practice it\(aqs just a typedef of \fBlong long\fP if your compiler
+supports it, otherwise \fBlong\fP\&.
+.sp
+Usually, you can safely use plain \fBint\fP in place of
+\fBjson_int_t\fP, and the implicit C integer conversion handles the
+rest. Only when you know that you need the full 64\-bit range, you
+should use \fBjson_int_t\fP explicitly.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B \fBJSON_INTEGER_IS_LONG_LONG\fP
+This is a preprocessor variable that holds the value 1 if
+\fBjson_int_t\fP is \fBlong long\fP, and 0 if it\(aqs \fBlong\fP\&. It
+can be used as follows:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+#if JSON_INTEGER_IS_LONG_LONG
+/* Code specific for long long */
+#else
+/* Code specific for long */
+#endif
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.TP
+.B \fBJSON_INTEGER_FORMAT\fP
+This is a macro that expands to a \fBprintf()\fP conversion
+specifier that corresponds to \fBjson_int_t\fP, without the
+leading \fB%\fP sign, i.e. either \fB"lld"\fP or \fB"ld"\fP\&. This macro
+is required because the actual type of \fBjson_int_t\fP can be
+either \fBlong\fP or \fBlong long\fP, and \fBprintf()\fP reuiqres
+different length modifiers for the two.
+.sp
+Example:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+json_int_t x = 123123123;
+printf("x is %" JSON_INTEGER_FORMAT "\en", x);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_integer(json_int_t\fI\ value\fP)
+Return value: New reference.
+.sp
+Returns a new JSON integer, or \fINULL\fP on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_int_t json_integer_value(const json_t\fI\ *integer\fP)
+Returns the associated value of \fIinteger\fP, or 0 if \fIjson\fP is not a
+JSON integer.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_integer_set(const json_t\fI\ *integer\fP, json_int_t\fI\ value\fP)
+Sets the associated value of \fIinteger\fP to \fIvalue\fP\&. Returns 0 on
+success and \-1 if \fIinteger\fP is not a JSON integer.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_real(double\fI\ value\fP)
+Return value: New reference.
+.sp
+Returns a new JSON real, or \fINULL\fP on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B double json_real_value(const json_t\fI\ *real\fP)
+Returns the associated value of \fIreal\fP, or 0.0 if \fIreal\fP is not a
+JSON real.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_real_set(const json_t\fI\ *real\fP, double\fI\ value\fP)
+Sets the associated value of \fIreal\fP to \fIvalue\fP\&. Returns 0 on
+success and \-1 if \fIreal\fP is not a JSON real.
+.UNINDENT
+.sp
+In addition to the functions above, there\(aqs a common query function
+for integers and reals:
+.INDENT 0.0
+.TP
+.B double json_number_value(const json_t\fI\ *json\fP)
+Returns the associated value of the JSON integer or JSON real
+\fIjson\fP, cast to double regardless of the actual type. If \fIjson\fP is
+neither JSON real nor JSON integer, 0.0 is returned.
+.UNINDENT
+.SS Array
+.sp
+A JSON array is an ordered collection of other JSON values.
+.INDENT 0.0
+.TP
+.B json_t *json_array(void)
+Return value: New reference.
+.sp
+Returns a new JSON array, or \fINULL\fP on error. Initially, the array
+is empty.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B size_t json_array_size(const json_t\fI\ *array\fP)
+Returns the number of elements in \fIarray\fP, or 0 if \fIarray\fP is NULL
+or not a JSON array.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_array_get(const json_t\fI\ *array\fP, size_t\fI\ index\fP)
+Return value: Borrowed reference.
+.sp
+Returns the element in \fIarray\fP at position \fIindex\fP\&. The valid range
+for \fIindex\fP is from 0 to the return value of
+\fBjson_array_size()\fP minus 1. If \fIarray\fP is not a JSON array,
+if \fIarray\fP is \fINULL\fP, or if \fIindex\fP is out of range, \fINULL\fP is
+returned.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_set(json_t\fI\ *array\fP, size_t\fI\ index\fP, json_t\fI\ *value\fP)
+Replaces the element in \fIarray\fP at position \fIindex\fP with \fIvalue\fP\&.
+The valid range for \fIindex\fP is from 0 to the return value of
+\fBjson_array_size()\fP minus 1. Returns 0 on success and \-1 on
+error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_set_new(json_t\fI\ *array\fP, size_t\fI\ index\fP, json_t\fI\ *value\fP)
+Like \fBjson_array_set()\fP but steals the reference to \fIvalue\fP\&.
+This is useful when \fIvalue\fP is newly created and not used after
+the call.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_append(json_t\fI\ *array\fP, json_t\fI\ *value\fP)
+Appends \fIvalue\fP to the end of \fIarray\fP, growing the size of \fIarray\fP
+by 1. Returns 0 on success and \-1 on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_append_new(json_t\fI\ *array\fP, json_t\fI\ *value\fP)
+Like \fBjson_array_append()\fP but steals the reference to
+\fIvalue\fP\&. This is useful when \fIvalue\fP is newly created and not used
+after the call.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_insert(json_t\fI\ *array\fP, size_t\fI\ index\fP, json_t\fI\ *value\fP)
+Inserts \fIvalue\fP to \fIarray\fP at position \fIindex\fP, shifting the
+elements at \fIindex\fP and after it one position towards the end of
+the array. Returns 0 on success and \-1 on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_insert_new(json_t\fI\ *array\fP, size_t\fI\ index\fP, json_t\fI\ *value\fP)
+Like \fBjson_array_insert()\fP but steals the reference to
+\fIvalue\fP\&. This is useful when \fIvalue\fP is newly created and not used
+after the call.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_remove(json_t\fI\ *array\fP, size_t\fI\ index\fP)
+Removes the element in \fIarray\fP at position \fIindex\fP, shifting the
+elements after \fIindex\fP one position towards the start of the array.
+Returns 0 on success and \-1 on error. The reference count of the
+removed value is decremented.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_clear(json_t\fI\ *array\fP)
+Removes all elements from \fIarray\fP\&. Returns 0 on sucess and \-1 on
+error. The reference count of all removed values are decremented.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_array_extend(json_t\fI\ *array\fP, json_t\fI\ *other_array\fP)
+Appends all elements in \fIother_array\fP to the end of \fIarray\fP\&.
+Returns 0 on success and \-1 on error.
+.UNINDENT
+.sp
+The following macro can be used to iterate through all elements
+in an array.
+.INDENT 0.0
+.TP
+.B json_array_foreach(array, index, value)
+Iterate over every element of \fBarray\fP, running the block
+of code that follows each time with the proper values set to
+variables \fBindex\fP and \fBvalue\fP, of types \fBsize_t\fP and
+\fBjson_t *\fP respectively. Example:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+/* array is a JSON array */
+size_t index;
+json_t *value;
+
+json_array_foreach(array, index, value) {
+ /* block of code that uses index and value */
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The items are returned in increasing index order.
+.sp
+This macro expands to an ordinary \fBfor\fP statement upon
+preprocessing, so its performance is equivalent to that of
+hand\-written code using the array access functions.
+The main advantage of this macro is that it abstracts
+away the complexity, and makes for shorter, more
+concise code.
+.sp
+New in version 2.5.
+
+.UNINDENT
+.SS Object
+.sp
+A JSON object is a dictionary of key\-value pairs, where the key is a
+Unicode string and the value is any JSON value.
+.sp
+Even though NUL bytes are allowed in string values, they are not
+allowed in object keys.
+.INDENT 0.0
+.TP
+.B json_t *json_object(void)
+Return value: New reference.
+.sp
+Returns a new JSON object, or \fINULL\fP on error. Initially, the
+object is empty.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B size_t json_object_size(const json_t\fI\ *object\fP)
+Returns the number of elements in \fIobject\fP, or 0 if \fIobject\fP is not
+a JSON object.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_object_get(const json_t\fI\ *object\fP, const char\fI\ *key\fP)
+Return value: Borrowed reference.
+.sp
+Get a value corresponding to \fIkey\fP from \fIobject\fP\&. Returns \fINULL\fP if
+\fIkey\fP is not found and on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_set(json_t\fI\ *object\fP, const char\fI\ *key\fP, json_t\fI\ *value\fP)
+Set the value of \fIkey\fP to \fIvalue\fP in \fIobject\fP\&. \fIkey\fP must be a
+valid null terminated UTF\-8 encoded Unicode string. If there
+already is a value for \fIkey\fP, it is replaced by the new value.
+Returns 0 on success and \-1 on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_set_nocheck(json_t\fI\ *object\fP, const char\fI\ *key\fP, json_t\fI\ *value\fP)
+Like \fBjson_object_set()\fP, but doesn\(aqt check that \fIkey\fP is
+valid UTF\-8. Use this function only if you are certain that this
+really is the case (e.g. you have already checked it by other
+means).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_set_new(json_t\fI\ *object\fP, const char\fI\ *key\fP, json_t\fI\ *value\fP)
+Like \fBjson_object_set()\fP but steals the reference to
+\fIvalue\fP\&. This is useful when \fIvalue\fP is newly created and not used
+after the call.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_set_new_nocheck(json_t\fI\ *object\fP, const char\fI\ *key\fP, json_t\fI\ *value\fP)
+Like \fBjson_object_set_new()\fP, but doesn\(aqt check that \fIkey\fP is
+valid UTF\-8. Use this function only if you are certain that this
+really is the case (e.g. you have already checked it by other
+means).
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_del(json_t\fI\ *object\fP, const char\fI\ *key\fP)
+Delete \fIkey\fP from \fIobject\fP if it exists. Returns 0 on success, or
+\-1 if \fIkey\fP was not found. The reference count of the removed value
+is decremented.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_clear(json_t\fI\ *object\fP)
+Remove all elements from \fIobject\fP\&. Returns 0 on success and \-1 if
+\fIobject\fP is not a JSON object. The reference count of all removed
+values are decremented.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_update(json_t\fI\ *object\fP, json_t\fI\ *other\fP)
+Update \fIobject\fP with the key\-value pairs from \fIother\fP, overwriting
+existing keys. Returns 0 on success or \-1 on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_update_existing(json_t\fI\ *object\fP, json_t\fI\ *other\fP)
+Like \fBjson_object_update()\fP, but only the values of existing
+keys are updated. No new keys are created. Returns 0 on success or
+\-1 on error.
+.sp
+New in version 2.3.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_update_missing(json_t\fI\ *object\fP, json_t\fI\ *other\fP)
+Like \fBjson_object_update()\fP, but only new keys are created.
+The value of any existing key is not changed. Returns 0 on success
+or \-1 on error.
+.sp
+New in version 2.3.
+
+.UNINDENT
+.sp
+The following macro can be used to iterate through all key\-value pairs
+in an object.
+.INDENT 0.0
+.TP
+.B json_object_foreach(object, key, value)
+Iterate over every key\-value pair of \fBobject\fP, running the block
+of code that follows each time with the proper values set to
+variables \fBkey\fP and \fBvalue\fP, of types \fBconst char *\fP and
+\fBjson_t *\fP respectively. Example:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+/* obj is a JSON object */
+const char *key;
+json_t *value;
+
+json_object_foreach(obj, key, value) {
+ /* block of code that uses key and value */
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+The items are not returned in any particular order.
+.sp
+This macro expands to an ordinary \fBfor\fP statement upon
+preprocessing, so its performance is equivalent to that of
+hand\-written iteration code using the object iteration protocol
+(see below). The main advantage of this macro is that it abstracts
+away the complexity behind iteration, and makes for shorter, more
+concise code.
+.sp
+New in version 2.3.
+
+.UNINDENT
+.sp
+The following functions implement an iteration protocol for objects,
+allowing to iterate through all key\-value pairs in an object. The
+items are not returned in any particular order, as this would require
+sorting due to the internal hashtable implementation.
+.INDENT 0.0
+.TP
+.B void *json_object_iter(json_t\fI\ *object\fP)
+Returns an opaque iterator which can be used to iterate over all
+key\-value pairs in \fIobject\fP, or \fINULL\fP if \fIobject\fP is empty.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void *json_object_iter_at(json_t\fI\ *object\fP, const char\fI\ *key\fP)
+Like \fBjson_object_iter()\fP, but returns an iterator to the
+key\-value pair in \fIobject\fP whose key is equal to \fIkey\fP, or NULL if
+\fIkey\fP is not found in \fIobject\fP\&. Iterating forward to the end of
+\fIobject\fP only yields all key\-value pairs of the object if \fIkey\fP
+happens to be the first key in the underlying hash table.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void *json_object_iter_next(json_t\fI\ *object\fP, void\fI\ *iter\fP)
+Returns an iterator pointing to the next key\-value pair in \fIobject\fP
+after \fIiter\fP, or \fINULL\fP if the whole object has been iterated
+through.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B const char *json_object_iter_key(void\fI\ *iter\fP)
+Extract the associated key from \fIiter\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_object_iter_value(void\fI\ *iter\fP)
+Return value: Borrowed reference.
+.sp
+Extract the associated value from \fIiter\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_iter_set(json_t\fI\ *object\fP, void\fI\ *iter\fP, json_t\fI\ *value\fP)
+Set the value of the key\-value pair in \fIobject\fP, that is pointed to
+by \fIiter\fP, to \fIvalue\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_object_iter_set_new(json_t\fI\ *object\fP, void\fI\ *iter\fP, json_t\fI\ *value\fP)
+Like \fBjson_object_iter_set()\fP, but steals the reference to
+\fIvalue\fP\&. This is useful when \fIvalue\fP is newly created and not used
+after the call.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void *json_object_key_to_iter(const char\fI\ *key\fP)
+Like \fBjson_object_iter_at()\fP, but much faster. Only works for
+values returned by \fBjson_object_iter_key()\fP\&. Using other keys
+will lead to segfaults. This function is used internally to
+implement \fBjson_object_foreach()\fP\&.
+.sp
+New in version 2.3.
+
+.UNINDENT
+.sp
+The iteration protocol can be used for example as follows:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+/* obj is a JSON object */
+const char *key;
+json_t *value;
+
+void *iter = json_object_iter(obj);
+while(iter)
+{
+ key = json_object_iter_key(iter);
+ value = json_object_iter_value(iter);
+ /* use key and value ... */
+ iter = json_object_iter_next(obj, iter);
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void json_object_seed(size_t\fI\ seed\fP)
+Seed the hash function used in Jansson\(aqs hashtable implementation.
+The seed is used to randomize the hash function so that an
+attacker cannot control its output.
+.sp
+If \fIseed\fP is 0, Jansson generates the seed itselfy by reading
+random data from the operating system\(aqs entropy sources. If no
+entropy sources are available, falls back to using a combination
+of the current timestamp (with microsecond precision if possible)
+and the process ID.
+.sp
+If called at all, this function must be called before any calls to
+\fBjson_object()\fP, either explicit or implicit. If this
+function is not called by the user, the first call to
+\fBjson_object()\fP (either explicit or implicit) seeds the hash
+function. See \fIportability\-thread\-safety\fP for notes on thread
+safety.
+.sp
+If repeatable results are required, for e.g. unit tests, the hash
+function can be "unrandomized" by calling \fBjson_object_seed()\fP
+with a constant value on program startup, e.g.
+\fBjson_object_seed(1)\fP\&.
+.sp
+New in version 2.6.
+
+.UNINDENT
+.SS Error reporting
+.sp
+Jansson uses a single struct type to pass error information to the
+user. See sections \fIapiref\-decoding\fP, \fIapiref\-pack\fP and
+\fIapiref\-unpack\fP for functions that pass error information using
+this struct.
+.INDENT 0.0
+.TP
+.B json_error_t
+.INDENT 7.0
+.TP
+.B char text[]
+The error message (in UTF\-8), or an empty string if a message is
+not available.
+.UNINDENT
+.INDENT 7.0
+.TP
+.B char source[]
+Source of the error. This can be (a part of) the file name or a
+special identifier in angle brackers (e.g. \fB<string>\fP).
+.UNINDENT
+.INDENT 7.0
+.TP
+.B int line
+The line number on which the error occurred.
+.UNINDENT
+.INDENT 7.0
+.TP
+.B int column
+The column on which the error occurred. Note that this is the
+\fIcharacter column\fP, not the byte column, i.e. a multibyte UTF\-8
+character counts as one column.
+.UNINDENT
+.INDENT 7.0
+.TP
+.B size_t position
+The position in bytes from the start of the input. This is
+useful for debugging Unicode encoding problems.
+.UNINDENT
+.UNINDENT
+.sp
+The normal use of \fBjson_error_t\fP is to allocate it on the stack,
+and pass a pointer to a function. Example:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+int main() {
+ json_t *json;
+ json_error_t error;
+
+ json = json_load_file("/path/to/file.json", 0, &error);
+ if(!json) {
+ /* the error variable contains error information */
+ }
+ ...
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Also note that if the call succeeded (\fBjson != NULL\fP in the above
+example), the contents of \fBerror\fP are generally left unspecified.
+The decoding functions write to the \fBposition\fP member also on
+success. See \fIapiref\-decoding\fP for more info.
+.sp
+All functions also accept \fINULL\fP as the \fBjson_error_t\fP pointer,
+in which case no error information is returned to the caller.
+.SS Encoding
+.sp
+This sections describes the functions that can be used to encode
+values to JSON. By default, only objects and arrays can be encoded
+directly, since they are the only valid \fIroot\fP values of a JSON text.
+To encode any JSON value, use the \fBJSON_ENCODE_ANY\fP flag (see
+below).
+.sp
+By default, the output has no newlines, and spaces are used between
+array and object elements for a readable output. This behavior can be
+altered by using the \fBJSON_INDENT\fP and \fBJSON_COMPACT\fP flags
+described below. A newline is never appended to the end of the encoded
+JSON data.
+.sp
+Each function takes a \fIflags\fP parameter that controls some aspects of
+how the data is encoded. Its default value is 0. The following macros
+can be ORed together to obtain \fIflags\fP\&.
+.INDENT 0.0
+.TP
+.B \fBJSON_INDENT(n)\fP
+Pretty\-print the result, using newlines between array and object
+items, and indenting with \fIn\fP spaces. The valid range for \fIn\fP is
+between 0 and 31 (inclusive), other values result in an undefined
+output. If \fBJSON_INDENT\fP is not used or \fIn\fP is 0, no newlines are
+inserted between array and object items.
+.sp
+The \fBJSON_MAX_INDENT\fP constant defines the maximum indentation
+that can be used, and its value is 31.
+.sp
+Changed in version 2.7: Added \fBJSON_MAX_INDENT\fP\&.
+
+.TP
+.B \fBJSON_COMPACT\fP
+This flag enables a compact representation, i.e. sets the separator
+between array and object items to \fB","\fP and between object keys
+and values to \fB":"\fP\&. Without this flag, the corresponding
+separators are \fB", "\fP and \fB": "\fP for more readable output.
+.TP
+.B \fBJSON_ENSURE_ASCII\fP
+If this flag is used, the output is guaranteed to consist only of
+ASCII characters. This is achived by escaping all Unicode
+characters outside the ASCII range.
+.TP
+.B \fBJSON_SORT_KEYS\fP
+If this flag is used, all the objects in output are sorted by key.
+This is useful e.g. if two JSON texts are diffed or visually
+compared.
+.TP
+.B \fBJSON_PRESERVE_ORDER\fP
+If this flag is used, object keys in the output are sorted into the
+same order in which they were first inserted to the object. For
+example, decoding a JSON text and then encoding with this flag
+preserves the order of object keys.
+.TP
+.B \fBJSON_ENCODE_ANY\fP
+Specifying this flag makes it possible to encode any JSON value on
+its own. Without it, only objects and arrays can be passed as the
+\fIroot\fP value to the encoding functions.
+.sp
+\fBNote:\fP Encoding any value may be useful in some scenarios, but
+it\(aqs generally discouraged as it violates strict compatiblity with
+\fI\%RFC 4627\fP\&. If you use this flag, don\(aqt expect interoperatibility
+with other JSON systems.
+.sp
+New in version 2.1.
+
+.TP
+.B \fBJSON_ESCAPE_SLASH\fP
+Escape the \fB/\fP characters in strings with \fB\e/\fP\&.
+.sp
+New in version 2.4.
+
+.TP
+.B \fBJSON_REAL_PRECISION(n)\fP
+Output all real numbers with at most \fIn\fP digits of precision. The
+valid range for \fIn\fP is between 0 and 31 (inclusive), and other
+values result in an undefined behavior.
+.sp
+By default, the precision is 17, to correctly and losslessly encode
+all IEEE 754 double precision floating point numbers.
+.sp
+New in version 2.7.
+
+.UNINDENT
+.sp
+The following functions perform the actual JSON encoding. The result
+is in UTF\-8.
+.INDENT 0.0
+.TP
+.B char *json_dumps(const json_t\fI\ *root\fP, size_t\fI\ flags\fP)
+Returns the JSON representation of \fIroot\fP as a string, or \fINULL\fP on
+error. \fIflags\fP is described above. The return value must be freed
+by the caller using \fBfree()\fP\&.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_dumpf(const json_t\fI\ *root\fP, FILE\fI\ *output\fP, size_t\fI\ flags\fP)
+Write the JSON representation of \fIroot\fP to the stream \fIoutput\fP\&.
+\fIflags\fP is described above. Returns 0 on success and \-1 on error.
+If an error occurs, something may have already been written to
+\fIoutput\fP\&. In this case, the output is undefined and most likely not
+valid JSON.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_dump_file(const json_t\fI\ *json\fP, const char\fI\ *path\fP, size_t\fI\ flags\fP)
+Write the JSON representation of \fIroot\fP to the file \fIpath\fP\&. If
+\fIpath\fP already exists, it is overwritten. \fIflags\fP is described
+above. Returns 0 on success and \-1 on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_dump_callback_t
+A typedef for a function that\(aqs called by
+\fBjson_dump_callback()\fP:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+typedef int (*json_dump_callback_t)(const char *buffer, size_t size, void *data);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fIbuffer\fP points to a buffer containing a chunk of output, \fIsize\fP is
+the length of the buffer, and \fIdata\fP is the corresponding
+\fBjson_dump_callback()\fP argument passed through.
+.sp
+On error, the function should return \-1 to stop the encoding
+process. On success, it should return 0.
+.sp
+New in version 2.2.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_dump_callback(const json_t\fI\ *json\fP, json_dump_callback_t\fI\ callback\fP, void\fI\ *data\fP, size_t\fI\ flags\fP)
+Call \fIcallback\fP repeatedly, passing a chunk of the JSON
+representation of \fIroot\fP each time. \fIflags\fP is described above.
+Returns 0 on success and \-1 on error.
+.sp
+New in version 2.2.
+
+.UNINDENT
+.SS Decoding
+.sp
+This sections describes the functions that can be used to decode JSON
+text to the Jansson representation of JSON data. The JSON
+specification requires that a JSON text is either a serialized array
+or object, and this requirement is also enforced with the following
+functions. In other words, the top level value in the JSON text being
+decoded must be either array or object. To decode any JSON value, use
+the \fBJSON_DECODE_ANY\fP flag (see below).
+.sp
+See \fIrfc\-conformance\fP for a discussion on Jansson\(aqs conformance
+to the JSON specification. It explains many design decisions that
+affect especially the behavior of the decoder.
+.sp
+Each function takes a \fIflags\fP parameter that can be used to control
+the behavior of the decoder. Its default value is 0. The following
+macros can be ORed together to obtain \fIflags\fP\&.
+.INDENT 0.0
+.TP
+.B \fBJSON_REJECT_DUPLICATES\fP
+Issue a decoding error if any JSON object in the input text
+contains duplicate keys. Without this flag, the value of the last
+occurence of each key ends up in the result. Key equivalence is
+checked byte\-by\-byte, without special Unicode comparison
+algorithms.
+.sp
+New in version 2.1.
+
+.TP
+.B \fBJSON_DECODE_ANY\fP
+By default, the decoder expects an array or object as the input.
+With this flag enabled, the decoder accepts any valid JSON value.
+.sp
+\fBNote:\fP Decoding any value may be useful in some scenarios, but
+it\(aqs generally discouraged as it violates strict compatiblity with
+\fI\%RFC 4627\fP\&. If you use this flag, don\(aqt expect interoperatibility
+with other JSON systems.
+.sp
+New in version 2.3.
+
+.TP
+.B \fBJSON_DISABLE_EOF_CHECK\fP
+By default, the decoder expects that its whole input constitutes a
+valid JSON text, and issues an error if there\(aqs extra data after
+the otherwise valid JSON input. With this flag enabled, the decoder
+stops after decoding a valid JSON array or object, and thus allows
+extra data after the JSON text.
+.sp
+Normally, reading will stop when the last \fB]\fP or \fB}\fP in the
+JSON input is encountered. If both \fBJSON_DISABLE_EOF_CHECK\fP and
+\fBJSON_DECODE_ANY\fP flags are used, the decoder may read one extra
+UTF\-8 code unit (up to 4 bytes of input). For example, decoding
+\fB4true\fP correctly decodes the integer 4, but also reads the
+\fBt\fP\&. For this reason, if reading multiple consecutive values that
+are not arrays or objects, they should be separated by at least one
+whitespace character.
+.sp
+New in version 2.1.
+
+.TP
+.B \fBJSON_DECODE_INT_AS_REAL\fP
+JSON defines only one number type. Jansson distinguishes between
+ints and reals. For more information see \fIreal\-vs\-integer\fP\&.
+With this flag enabled the decoder interprets all numbers as real
+values. Integers that do not have an exact double representation
+will silently result in a loss of precision. Integers that cause
+a double overflow will cause an error.
+.sp
+New in version 2.5.
+
+.TP
+.B \fBJSON_ALLOW_NUL\fP
+Allow \fB\eu0000\fP escape inside string values. This is a safety
+measure; If you know your input can contain NUL bytes, use this
+flag. If you don\(aqt use this flag, you don\(aqt have to worry about NUL
+bytes inside strings unless you explicitly create themselves by
+using e.g. \fBjson_stringn()\fP or \fBs#\fP format specifier for
+\fBjson_pack()\fP\&.
+.sp
+Object keys cannot have embedded NUL bytes even if this flag is
+used.
+.sp
+New in version 2.6.
+
+.UNINDENT
+.sp
+Each function also takes an optional \fBjson_error_t\fP parameter
+that is filled with error information if decoding fails. It\(aqs also
+updated on success; the number of bytes of input read is written to
+its \fBposition\fP field. This is especially useful when using
+\fBJSON_DISABLE_EOF_CHECK\fP to read multiple consecutive JSON texts.
+.sp
+New in version 2.3: Number of bytes of input read is written to the \fBposition\fP field
+of the \fBjson_error_t\fP structure.
+
+.sp
+If no error or position information is needed, you can pass \fINULL\fP\&.
+.sp
+The following functions perform the actual JSON decoding.
+.INDENT 0.0
+.TP
+.B json_t *json_loads(const char\fI\ *input\fP, size_t\fI\ flags\fP, json_error_t\fI\ *error\fP)
+Return value: New reference.
+.sp
+Decodes the JSON string \fIinput\fP and returns the array or object it
+contains, or \fINULL\fP on error, in which case \fIerror\fP is filled with
+information about the error. \fIflags\fP is described above.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_loadb(const char\fI\ *buffer\fP, size_t\fI\ buflen\fP, size_t\fI\ flags\fP, json_error_t\fI\ *error\fP)
+Return value: New reference.
+.sp
+Decodes the JSON string \fIbuffer\fP, whose length is \fIbuflen\fP, and
+returns the array or object it contains, or \fINULL\fP on error, in
+which case \fIerror\fP is filled with information about the error. This
+is similar to \fBjson_loads()\fP except that the string doesn\(aqt
+need to be null\-terminated. \fIflags\fP is described above.
+.sp
+New in version 2.1.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_loadf(FILE\fI\ *input\fP, size_t\fI\ flags\fP, json_error_t\fI\ *error\fP)
+Return value: New reference.
+.sp
+Decodes the JSON text in stream \fIinput\fP and returns the array or
+object it contains, or \fINULL\fP on error, in which case \fIerror\fP is
+filled with information about the error. \fIflags\fP is described
+above.
+.sp
+This function will start reading the input from whatever position
+the input file was, without attempting to seek first. If an error
+occurs, the file position will be left indeterminate. On success,
+the file position will be at EOF, unless \fBJSON_DISABLE_EOF_CHECK\fP
+flag was used. In this case, the file position will be at the first
+character after the last \fB]\fP or \fB}\fP in the JSON input. This
+allows calling \fBjson_loadf()\fP on the same \fBFILE\fP object
+multiple times, if the input consists of consecutive JSON texts,
+possibly separated by whitespace.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_load_file(const char\fI\ *path\fP, size_t\fI\ flags\fP, json_error_t\fI\ *error\fP)
+Return value: New reference.
+.sp
+Decodes the JSON text in file \fIpath\fP and returns the array or
+object it contains, or \fINULL\fP on error, in which case \fIerror\fP is
+filled with information about the error. \fIflags\fP is described
+above.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_load_callback_t
+A typedef for a function that\(aqs called by
+\fBjson_load_callback()\fP to read a chunk of input data:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+typedef size_t (*json_load_callback_t)(void *buffer, size_t buflen, void *data);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+\fIbuffer\fP points to a buffer of \fIbuflen\fP bytes, and \fIdata\fP is the
+corresponding \fBjson_load_callback()\fP argument passed through.
+.sp
+On success, the function should return the number of bytes read; a
+returned value of 0 indicates that no data was read and that the
+end of file has been reached. On error, the function should return
+\fB(size_t)\-1\fP to abort the decoding process.
+.sp
+New in version 2.4.
+
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_load_callback(json_load_callback_t\fI\ callback\fP, void\fI\ *data\fP, size_t\fI\ flags\fP, json_error_t\fI\ *error\fP)
+Return value: New reference.
+.sp
+Decodes the JSON text produced by repeated calls to \fIcallback\fP, and
+returns the array or object it contains, or \fINULL\fP on error, in
+which case \fIerror\fP is filled with information about the error.
+\fIdata\fP is passed through to \fIcallback\fP on each call. \fIflags\fP is
+described above.
+.sp
+New in version 2.4.
+
+.UNINDENT
+.SS Building Values
+.sp
+This section describes functions that help to create, or \fIpack\fP,
+complex JSON values, especially nested objects and arrays. Value
+building is based on a \fIformat string\fP that is used to tell the
+functions about the expected arguments.
+.sp
+For example, the format string \fB"i"\fP specifies a single integer
+value, while the format string \fB"[ssb]"\fP or the equivalent \fB"[s, s,
+b]"\fP specifies an array value with two strings and a boolean as its
+items:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+/* Create the JSON integer 42 */
+json_pack("i", 42);
+
+/* Create the JSON array ["foo", "bar", true] */
+json_pack("[ssb]", "foo", "bar", 1);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Here\(aqs the full list of format specifiers. The type in parentheses
+denotes the resulting JSON type, and the type in brackets (if any)
+denotes the C type that is expected as the corresponding argument or
+arguments.
+.INDENT 0.0
+.TP
+.B \fBs\fP (string) [const char *]
+Convert a NULL terminated UTF\-8 string to a JSON string.
+.TP
+.B \fBs#\fP (string) [const char *, int]
+Convert a UTF\-8 buffer of a given length to a JSON string.
+.sp
+New in version 2.5.
+
+.TP
+.B \fBs%\fP (string) [const char *, size_t]
+Like \fBs#\fP but the length argument is of type \fBsize_t\fP\&.
+.sp
+New in version 2.6.
+
+.TP
+.B \fB+\fP [const char *]
+Like \fBs\fP, but concatenate to the previous string. Only valid
+after \fBs\fP, \fBs#\fP, \fB+\fP or \fB+#\fP\&.
+.sp
+New in version 2.5.
+
+.TP
+.B \fB+#\fP [const char *, int]
+Like \fBs#\fP, but concatenate to the previous string. Only valid
+after \fBs\fP, \fBs#\fP, \fB+\fP or \fB+#\fP\&.
+.sp
+New in version 2.5.
+
+.TP
+.B \fB+%\fP (string) [const char *, size_t]
+Like \fB+#\fP but the length argument is of type \fBsize_t\fP\&.
+.sp
+New in version 2.6.
+
+.TP
+.B \fBn\fP (null)
+Output a JSON null value. No argument is consumed.
+.TP
+.B \fBb\fP (boolean) [int]
+Convert a C \fBint\fP to JSON boolean value. Zero is converted
+to \fBfalse\fP and non\-zero to \fBtrue\fP\&.
+.TP
+.B \fBi\fP (integer) [int]
+Convert a C \fBint\fP to JSON integer.
+.TP
+.B \fBI\fP (integer) [json_int_t]
+Convert a C \fBjson_int_t\fP to JSON integer.
+.TP
+.B \fBf\fP (real) [double]
+Convert a C \fBdouble\fP to JSON real.
+.TP
+.B \fBo\fP (any value) [json_t *]
+Output any given JSON value as\-is. If the value is added to an
+array or object, the reference to the value passed to \fBo\fP is
+stolen by the container.
+.TP
+.B \fBO\fP (any value) [json_t *]
+Like \fBo\fP, but the argument\(aqs reference count is incremented.
+This is useful if you pack into an array or object and want to
+keep the reference for the JSON value consumed by \fBO\fP to
+yourself.
+.TP
+.B \fB[fmt]\fP (array)
+Build an array with contents from the inner format string. \fBfmt\fP
+may contain objects and arrays, i.e. recursive value building is
+supported.
+.TP
+.B \fB{fmt}\fP (object)
+Build an object with contents from the inner format string
+\fBfmt\fP\&. The first, third, etc. format specifier represent a key,
+and must be a string (see \fBs\fP, \fBs#\fP, \fB+\fP and \fB+#\fP above),
+as object keys are always strings. The second, fourth, etc. format
+specifier represent a value. Any value may be an object or array,
+i.e. recursive value building is supported.
+.UNINDENT
+.sp
+Whitespace, \fB:\fP and \fB,\fP are ignored.
+.sp
+The following functions compose the value building API:
+.INDENT 0.0
+.TP
+.B json_t *json_pack(const char\fI\ *fmt\fP, \&...)
+Return value: New reference.
+.sp
+Build a new JSON value according to the format string \fIfmt\fP\&. For
+each format specifier (except for \fB{}[]n\fP), one or more arguments
+are consumed and used to build the corresponding value. Returns
+\fINULL\fP on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_pack_ex(json_error_t\fI\ *error\fP, size_t\fI\ flags\fP, const char\fI\ *fmt\fP, \&...)
+.TP
+.B json_t *json_vpack_ex(json_error_t\fI\ *error\fP, size_t\fI\ flags\fP, const char\fI\ *fmt\fP, va_list\fI\ ap\fP)
+Return value: New reference.
+.sp
+Like \fBjson_pack()\fP, but an in the case of an error, an error
+message is written to \fIerror\fP, if it\(aqs not \fINULL\fP\&. The \fIflags\fP
+parameter is currently unused and should be set to 0.
+.sp
+As only the errors in format string (and out\-of\-memory errors) can
+be caught by the packer, these two functions are most likely only
+useful for debugging format strings.
+.UNINDENT
+.sp
+More examples:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+/* Build an empty JSON object */
+json_pack("{}");
+
+/* Build the JSON object {"foo": 42, "bar": 7} */
+json_pack("{sisi}", "foo", 42, "bar", 7);
+
+/* Like above, \(aq:\(aq, \(aq,\(aq and whitespace are ignored */
+json_pack("{s:i, s:i}", "foo", 42, "bar", 7);
+
+/* Build the JSON array [[1, 2], {"cool": true}] */
+json_pack("[[i,i],{s:b}]", 1, 2, "cool", 1);
+
+/* Build a string from a non\-NUL terminated buffer */
+char buffer[4] = {\(aqt\(aq, \(aqe\(aq, \(aqs\(aq, \(aqt\(aq};
+json_pack("s#", buffer, 4);
+
+/* Concatentate strings together to build the JSON string "foobarbaz" */
+json_pack("s++", "foo", "bar", "baz");
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Parsing and Validating Values
+.sp
+This section describes functions that help to validate complex values
+and extract, or \fIunpack\fP, data from them. Like \fIbuilding values\fP, this is also based on format strings.
+.sp
+While a JSON value is unpacked, the type specified in the format
+string is checked to match that of the JSON value. This is the
+validation part of the process. In addition to this, the unpacking
+functions can also check that all items of arrays and objects are
+unpacked. This check be enabled with the format specifier \fB!\fP or by
+using the flag \fBJSON_STRICT\fP\&. See below for details.
+.sp
+Here\(aqs the full list of format specifiers. The type in parentheses
+denotes the JSON type, and the type in brackets (if any) denotes the C
+type whose address should be passed.
+.INDENT 0.0
+.TP
+.B \fBs\fP (string) [const char *]
+Convert a JSON string to a pointer to a NULL terminated UTF\-8
+string. The resulting string is extracted by using
+\fBjson_string_value()\fP internally, so it exists as long as
+there are still references to the corresponding JSON string.
+.TP
+.B \fBs%\fP (string) [const char *, size_t *]
+Convert a JSON string to a pointer to a NULL terminated UTF\-8
+string and its length.
+.sp
+New in version 2.6.
+
+.TP
+.B \fBn\fP (null)
+Expect a JSON null value. Nothing is extracted.
+.TP
+.B \fBb\fP (boolean) [int]
+Convert a JSON boolean value to a C \fBint\fP, so that \fBtrue\fP
+is converted to 1 and \fBfalse\fP to 0.
+.TP
+.B \fBi\fP (integer) [int]
+Convert a JSON integer to C \fBint\fP\&.
+.TP
+.B \fBI\fP (integer) [json_int_t]
+Convert a JSON integer to C \fBjson_int_t\fP\&.
+.TP
+.B \fBf\fP (real) [double]
+Convert a JSON real to C \fBdouble\fP\&.
+.TP
+.B \fBF\fP (integer or real) [double]
+Convert a JSON number (integer or real) to C \fBdouble\fP\&.
+.TP
+.B \fBo\fP (any value) [json_t *]
+Store a JSON value with no conversion to a \fBjson_t\fP pointer.
+.TP
+.B \fBO\fP (any value) [json_t *]
+Like \fBO\fP, but the JSON value\(aqs reference count is incremented.
+.TP
+.B \fB[fmt]\fP (array)
+Convert each item in the JSON array according to the inner format
+string. \fBfmt\fP may contain objects and arrays, i.e. recursive
+value extraction is supporetd.
+.TP
+.B \fB{fmt}\fP (object)
+Convert each item in the JSON object according to the inner format
+string \fBfmt\fP\&. The first, third, etc. format specifier represent
+a key, and must be \fBs\fP\&. The corresponding argument to unpack
+functions is read as the object key. The second fourth, etc.
+format specifier represent a value and is written to the address
+given as the corresponding argument. \fBNote\fP that every other
+argument is read from and every other is written to.
+.sp
+\fBfmt\fP may contain objects and arrays as values, i.e. recursive
+value extraction is supporetd.
+.sp
+New in version 2.3: Any \fBs\fP representing a key may be suffixed with a \fB?\fP to
+make the key optional. If the key is not found, nothing is
+extracted. See below for an example.
+
+.TP
+.B \fB!\fP
+This special format specifier is used to enable the check that
+all object and array items are accessed, on a per\-value basis. It
+must appear inside an array or object as the last format specifier
+before the closing bracket or brace. To enable the check globally,
+use the \fBJSON_STRICT\fP unpacking flag.
+.TP
+.B \fB*\fP
+This special format specifier is the opposite of \fB!\fP\&. If the
+\fBJSON_STRICT\fP flag is used, \fB*\fP can be used to disable the
+strict check on a per\-value basis. It must appear inside an array
+or object as the last format specifier before the closing bracket
+or brace.
+.UNINDENT
+.sp
+Whitespace, \fB:\fP and \fB,\fP are ignored.
+.sp
+The following functions compose the parsing and validation API:
+.INDENT 0.0
+.TP
+.B int json_unpack(json_t\fI\ *root\fP, const char\fI\ *fmt\fP, \&...)
+Validate and unpack the JSON value \fIroot\fP according to the format
+string \fIfmt\fP\&. Returns 0 on success and \-1 on failure.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B int json_unpack_ex(json_t\fI\ *root\fP, json_error_t\fI\ *error\fP, size_t\fI\ flags\fP, const char\fI\ *fmt\fP, \&...)
+.TP
+.B int json_vunpack_ex(json_t\fI\ *root\fP, json_error_t\fI\ *error\fP, size_t\fI\ flags\fP, const char\fI\ *fmt\fP, va_list\fI\ ap\fP)
+Validate and unpack the JSON value \fIroot\fP according to the format
+string \fIfmt\fP\&. If an error occurs and \fIerror\fP is not \fINULL\fP, write
+error information to \fIerror\fP\&. \fIflags\fP can be used to control the
+behaviour of the unpacker, see below for the flags. Returns 0 on
+success and \-1 on failure.
+.UNINDENT
+.sp
+\fBNOTE:\fP
+.INDENT 0.0
+.INDENT 3.5
+The first argument of all unpack functions is \fBjson_t *root\fP
+instead of \fBconst json_t *root\fP, because the use of \fBO\fP format
+specifier causes the reference count of \fBroot\fP, or some value
+reachable from \fBroot\fP, to be increased. Furthermore, the \fBo\fP
+format specifier may be used to extract a value as\-is, which allows
+modifying the structure or contents of a value reachable from
+\fBroot\fP\&.
+.sp
+If the \fBO\fP and \fBo\fP format specifiers are not used, it\(aqs
+perfectly safe to cast a \fBconst json_t *\fP variable to plain
+\fBjson_t *\fP when used with these functions.
+.UNINDENT
+.UNINDENT
+.sp
+The following unpacking flags are available:
+.INDENT 0.0
+.TP
+.B \fBJSON_STRICT\fP
+Enable the extra validation step checking that all object and
+array items are unpacked. This is equivalent to appending the
+format specifier \fB!\fP to the end of every array and object in the
+format string.
+.TP
+.B \fBJSON_VALIDATE_ONLY\fP
+Don\(aqt extract any data, just validate the JSON value against the
+given format string. Note that object keys must still be specified
+after the format string.
+.UNINDENT
+.sp
+Examples:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+/* root is the JSON integer 42 */
+int myint;
+json_unpack(root, "i", &myint);
+assert(myint == 42);
+
+/* root is the JSON object {"foo": "bar", "quux": true} */
+const char *str;
+int boolean;
+json_unpack(root, "{s:s, s:b}", "foo", &str, "quux", &boolean);
+assert(strcmp(str, "bar") == 0 && boolean == 1);
+
+/* root is the JSON array [[1, 2], {"baz": null} */
+json_error_t error;
+json_unpack_ex(root, &error, JSON_VALIDATE_ONLY, "[[i,i], {s:n}]", "baz");
+/* returns 0 for validation success, nothing is extracted */
+
+/* root is the JSON array [1, 2, 3, 4, 5] */
+int myint1, myint2;
+json_unpack(root, "[ii!]", &myint1, &myint2);
+/* returns \-1 for failed validation */
+
+/* root is an empty JSON object */
+int myint = 0, myint2 = 0;
+json_unpack(root, "{s?i, s?[ii]}",
+ "foo", &myint1,
+ "bar", &myint2, &myint3);
+/* myint1, myint2 or myint3 is no touched as "foo" and "bar" don\(aqt exist */
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.SS Equality
+.sp
+Testing for equality of two JSON values cannot, in general, be
+achieved using the \fB==\fP operator. Equality in the terms of the
+\fB==\fP operator states that the two \fBjson_t\fP pointers point to
+exactly the same JSON value. However, two JSON values can be equal not
+only if they are exactly the same value, but also if they have equal
+"contents":
+.INDENT 0.0
+.IP \(bu 2
+Two integer or real values are equal if their contained numeric
+values are equal. An integer value is never equal to a real value,
+though.
+.IP \(bu 2
+Two strings are equal if their contained UTF\-8 strings are equal,
+byte by byte. Unicode comparison algorithms are not implemented.
+.IP \(bu 2
+Two arrays are equal if they have the same number of elements and
+each element in the first array is equal to the corresponding
+element in the second array.
+.IP \(bu 2
+Two objects are equal if they have exactly the same keys and the
+value for each key in the first object is equal to the value of the
+corresponding key in the second object.
+.IP \(bu 2
+Two true, false or null values have no "contents", so they are equal
+if their types are equal. (Because these values are singletons,
+their equality can actually be tested with \fB==\fP\&.)
+.UNINDENT
+.sp
+The following function can be used to test whether two JSON values are
+equal.
+.INDENT 0.0
+.TP
+.B int json_equal(json_t\fI\ *value1\fP, json_t\fI\ *value2\fP)
+Returns 1 if \fIvalue1\fP and \fIvalue2\fP are equal, as defined above.
+Returns 0 if they are inequal or one or both of the pointers are
+\fINULL\fP\&.
+.UNINDENT
+.SS Copying
+.sp
+Because of reference counting, passing JSON values around doesn\(aqt
+require copying them. But sometimes a fresh copy of a JSON value is
+needed. For example, if you need to modify an array, but still want to
+use the original afterwards, you should take a copy of it first.
+.sp
+Jansson supports two kinds of copying: shallow and deep. There is a
+difference between these methods only for arrays and objects. Shallow
+copying only copies the first level value (array or object) and uses
+the same child values in the copied value. Deep copying makes a fresh
+copy of the child values, too. Moreover, all the child values are deep
+copied in a recursive fashion.
+.INDENT 0.0
+.TP
+.B json_t *json_copy(json_t\fI\ *value\fP)
+Return value: New reference.
+.sp
+Returns a shallow copy of \fIvalue\fP, or \fINULL\fP on error.
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_t *json_deep_copy(const json_t\fI\ *value\fP)
+Return value: New reference.
+.sp
+Returns a deep copy of \fIvalue\fP, or \fINULL\fP on error.
+.UNINDENT
+.SS Custom Memory Allocation
+.sp
+By default, Jansson uses \fBmalloc()\fP and \fBfree()\fP for
+memory allocation. These functions can be overridden if custom
+behavior is needed.
+.INDENT 0.0
+.TP
+.B json_malloc_t
+A typedef for a function pointer with \fBmalloc()\fP\(aqs
+signature:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+typedef void *(*json_malloc_t)(size_t);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B json_free_t
+A typedef for a function pointer with \fBfree()\fP\(aqs
+signature:
+.INDENT 7.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+typedef void (*json_free_t)(void *);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.UNINDENT
+.INDENT 0.0
+.TP
+.B void json_set_alloc_funcs(json_malloc_t\fI\ malloc_fn\fP, json_free_t\fI\ free_fn\fP)
+Use \fImalloc_fn\fP instead of \fBmalloc()\fP and \fIfree_fn\fP instead
+of \fBfree()\fP\&. This function has to be called before any other
+Jansson\(aqs API functions to ensure that all memory operations use
+the same functions.
+.UNINDENT
+.sp
+\fBExamples:\fP
+.sp
+Circumvent problems with different CRT heaps on Windows by using
+application\(aqs \fBmalloc()\fP and \fBfree()\fP:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+json_set_alloc_funcs(malloc, free);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Use the \fI\%Boehm\(aqs conservative garbage collector\fP for memory
+operations:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+json_set_alloc_funcs(GC_malloc, GC_free);
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Allow storing sensitive data (e.g. passwords or encryption keys) in
+JSON structures by zeroing all memory when freed:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft CW
+static void *secure_malloc(size_t size)
+{
+ /* Store the memory area size in the beginning of the block */
+ void *ptr = malloc(size + 8);
+ *((size_t *)ptr) = size;
+ return ptr + 8;
+}
+
+static void secure_free(void *ptr)
+{
+ size_t size;
+
+ ptr \-= 8;
+ size = *((size_t *)ptr);
+
+ guaranteed_memset(ptr, 0, size + 8);
+ free(ptr);
+}
+
+int main()
+{
+ json_set_alloc_funcs(secure_malloc, secure_free);
+ /* ... */
+}
+.ft R
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+For more information about the issues of storing sensitive data in
+memory, see
+\fI\%http://www.dwheeler.com/secure\-programs/Secure\-Programs\-HOWTO/protect\-secrets.html\fP\&.
+The page also explains the \fBguaranteed_memset()\fP function used
+in the example and gives a sample implementation for it.
+.SS Changes in Jansson
+.SS Version 2.7
+.sp
+Released 2014\-10\-02
+.INDENT 0.0
+.IP \(bu 2
+New features:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_pack()\fP and friends: Add format specifiers \fBs%\fP and \fB+%\fP
+for a size_t string length (#141).
+.IP \(bu 2
+\fBjson_unpack()\fP and friends: Add format specifier \fBs%\fP for
+unpacking the string length along with the string itself (#141).
+.IP \(bu 2
+Add length\-aware string constructors \fBjson_stringn()\fP and
+\fBjson_stringn_nocheck()\fP, length\-aware string mutators
+\fBjson_string_setn()\fP and \fBjson_string_setn_nocheck()\fP, and a
+function for getting string\(aqs length \fBjson_string_length()\fP (#141,
+#143).
+.IP \(bu 2
+Support \fB\eu0000\fP escapes in the decoder. The support can be
+enabled by using the \fBJSON_ALLOW_NUL\fP decoding flag (#141).
+.IP \(bu 2
+Add \fBjson_boolean_value()\fP as an alias for \fBjson_is_true()\fP
+(#146).
+.IP \(bu 2
+Add JSON_REAL_PRECISION encoding flag/macro for controlling real
+number precision (#178).
+.IP \(bu 2
+Define the maximum indentation as JSON_MAX_INDENT (#191).
+.UNINDENT
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Some malformed \fB\euNNNN\fP escapes could crash the decoder with an
+assertion failure.
+.IP \(bu 2
+Avoid integer overflows with very long strings in UTF\-8 decoder and
+hashtable.
+.IP \(bu 2
+Check for \fINULL\fP key in \fBjson_object_get()\fP and
+\fBjson_object_del()\fP (#151).
+.IP \(bu 2
+Enhance hashtable seeding on Windows (#162).
+.IP \(bu 2
+\fBjson_unpack()\fP: Allow mixing JSON_STRICT with optional keys
+(#162, #163).
+.IP \(bu 2
+Fix int/int32 mismatch (#142).
+.IP \(bu 2
+Parse subnormal numbers correctly (#202).
+.UNINDENT
+.IP \(bu 2
+Build:
+.INDENT 2.0
+.IP \(bu 2
+Remove VS2010 build files. CMake should be used on Windows instead
+(#165).
+.IP \(bu 2
+Fix CMake build flags for MinGW (#193).
+.IP \(bu 2
+Add CMake config files for find_package. Rename config.h to
+jansson_private_config.h (#157, #159).
+.IP \(bu 2
+Make Valgrind checks work with CMake (#160).
+.IP \(bu 2
+Fix feature checks to use correct __ATOMIC flags.
+.IP \(bu 2
+Fix CMake checks for uint16_t and uint8_t support (#177).
+.IP \(bu 2
+Make Jansson build on SmartOS/Solaris (#171).
+.IP \(bu 2
+Work around a GCC bug on Solaris (#175).
+.IP \(bu 2
+Fix autoreconf on Debian (#182).
+.IP \(bu 2
+Don\(aqt use GNU make specific export for global AM_CFLAGS (#203,
+#204).
+.IP \(bu 2
+Fix building on Android using the supplied Android.mk (#166,
+#174).
+.IP \(bu 2
+Android.mk: Add \-DHAVE_STDINT_H to LOCAL_CFLAGS (#200).
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Document JANSSON_BUILD_SHARED_LIBS CMake option (#187).
+.UNINDENT
+.IP \(bu 2
+Tests:
+.INDENT 2.0
+.IP \(bu 2
+Close file handles correctly (#198).
+.UNINDENT
+.IP \(bu 2
+Other changes:
+.INDENT 2.0
+.IP \(bu 2
+\fB\euNNNN\fP escapes are now encoded in upper case for better
+readability.
+.IP \(bu 2
+Enable usage of AddressSanitizer (#180).
+.UNINDENT
+.UNINDENT
+.SS Version 2.6
+.sp
+Released 2014\-02\-11
+.INDENT 0.0
+.IP \(bu 2
+Security:
+.INDENT 2.0
+.IP \(bu 2
+CVE\-2013\-6401: The hash function used by the hashtable
+implementation has been changed, and is automatically seeded with
+random data when the first JSON object is created. This prevents
+an attacker from causing large JSON objects with specially crafted
+keys perform poorly.
+.UNINDENT
+.IP \(bu 2
+New features:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_object_seed()\fP: Set the seed value of the hash function.
+.UNINDENT
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Include CMake specific files in the release tarball.
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Fix tutorial source to send a User\-Agent header, which is now
+required by the GitHub API.
+.IP \(bu 2
+Set all memory to zero in secure_free() example.
+.UNINDENT
+.UNINDENT
+.SS Version 2.5
+.sp
+Released 2013\-09\-19
+.INDENT 0.0
+.IP \(bu 2
+New features:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_pack()\fP and friends: Add format specifiers \fBs#\fP, \fB+\fP and
+\fB+#\fP\&.
+.IP \(bu 2
+Add \fBJSON_DECODE_INT_AS_REAL\fP decoding flag to treat all numbers
+as real in the decoder (#123).
+.IP \(bu 2
+Add \fBjson_array_foreach()\fP, paralleling \fBjson_object_foreach()\fP
+(#118).
+.UNINDENT
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_dumps()\fP and friends: Don\(aqt crash if json is \fINULL\fP and
+\fBJSON_ENCODE_ANY\fP is set.
+.IP \(bu 2
+Fix a theoretical integer overflow in \fBjsonp_strdup()\fP\&.
+.IP \(bu 2
+Fix \fBl_isxdigit()\fP macro (#97).
+.IP \(bu 2
+Fix an off\-by\-one error in \fBjson_array_remove()\fP\&.
+.UNINDENT
+.IP \(bu 2
+Build:
+.INDENT 2.0
+.IP \(bu 2
+Support CMake in addition to GNU Autotools (#106, #107, #112,
+#115, #120, #127).
+.IP \(bu 2
+Support building for Android (#109).
+.IP \(bu 2
+Don\(aqt use \fB\-Werror\fP by default.
+.IP \(bu 2
+Support building and testing with VPATH (#93).
+.IP \(bu 2
+Fix compilation when \fBNDEBUG\fP is defined (#128)
+.UNINDENT
+.IP \(bu 2
+Tests:
+.INDENT 2.0
+.IP \(bu 2
+Fix a refleak in \fBtest/bin/json_process.c\fP\&.
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Clarify the return value of \fBjson_load_callback_t()\fP\&.
+.IP \(bu 2
+Document how to circumvent problems with separate heaps on Windows.
+.IP \(bu 2
+Fix memory leaks and warnings in \fBgithub_commits.c\fP\&.
+.IP \(bu 2
+Use \fBjson_decref()\fP properly in tutorial.
+.UNINDENT
+.IP \(bu 2
+Other:
+.INDENT 2.0
+.IP \(bu 2
+Make it possible to forward declare \fBstruct json_t\fP\&.
+.UNINDENT
+.UNINDENT
+.SS Version 2.4
+.sp
+Released 2012\-09\-23
+.INDENT 0.0
+.IP \(bu 2
+New features:
+.INDENT 2.0
+.IP \(bu 2
+Add \fBjson_boolean()\fP macro that returns the JSON true or false
+value based on its argument (#86).
+.IP \(bu 2
+Add \fBjson_load_callback()\fP that calls a callback function
+repeatedly to read the JSON input (#57).
+.IP \(bu 2
+Add JSON_ESCAPE_SLASH encoding flag to escape all occurences of
+\fB/\fP with \fB\e/\fP\&.
+.UNINDENT
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Check for and reject NaN and Inf values for reals. Encoding these
+values resulted in invalid JSON.
+.IP \(bu 2
+Fix \fBjson_real_set()\fP to return \-1 on error.
+.UNINDENT
+.IP \(bu 2
+Build:
+.INDENT 2.0
+.IP \(bu 2
+Jansson now builds on Windows with Visual Studio 2010, and
+includes solution and project files in \fBwin32/vs2010/\fP
+directory.
+.IP \(bu 2
+Fix build warnings (#77, #78).
+.IP \(bu 2
+Add \fB\-no\-undefined\fP to LDFLAGS (#90).
+.UNINDENT
+.IP \(bu 2
+Tests:
+.INDENT 2.0
+.IP \(bu 2
+Fix the symbol exports test on Linux/PPC64 (#88).
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Fix typos (#73, #84).
+.UNINDENT
+.UNINDENT
+.SS Version 2.3.1
+.sp
+Released 2012\-04\-20
+.INDENT 0.0
+.IP \(bu 2
+Build issues:
+.INDENT 2.0
+.IP \(bu 2
+Only use \fBlong long\fP if \fBstrtoll()\fP is also available.
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Fix the names of library version constants in documentation. (#52)
+.IP \(bu 2
+Change the tutorial to use GitHub API v3. (#65)
+.UNINDENT
+.IP \(bu 2
+Tests:
+.INDENT 2.0
+.IP \(bu 2
+Make some tests locale independent. (#51)
+.IP \(bu 2
+Distribute the library exports test in the tarball.
+.IP \(bu 2
+Make test run on shells that don\(aqt support the \fBexport FOO=bar\fP
+syntax.
+.UNINDENT
+.UNINDENT
+.SS Version 2.3
+.sp
+Released 2012\-01\-27
+.INDENT 0.0
+.IP \(bu 2
+New features:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_unpack()\fP and friends: Add support for optional object keys
+with the \fB{s?o}\fP syntax.
+.IP \(bu 2
+Add \fBjson_object_update_existing()\fP and
+\fBjson_object_update_missing()\fP, for updating only existing keys or
+only adding missing keys to an object. (#37)
+.IP \(bu 2
+Add \fBjson_object_foreach()\fP for more convenient iteration over
+objects. (#45, #46)
+.IP \(bu 2
+When decoding JSON, write the number of bytes that were read from
+input to \fBerror.position\fP also on success. This is handy with
+\fBJSON_DISABLE_EOF_CHECK\fP\&.
+.IP \(bu 2
+Add support for decoding any JSON value, not just arrays or
+objects. The support is enabled with the new \fBJSON_DECODE_ANY\fP
+flag. Patch by Andrea Marchesini. (#4)
+.UNINDENT
+.IP \(bu 2
+Bug fixes
+.INDENT 2.0
+.IP \(bu 2
+Avoid problems with object\(aqs serial number growing too big. (#40,
+#41)
+.IP \(bu 2
+Decoding functions now return NULL if the first argument is NULL.
+Patch by Andrea Marchesini.
+.IP \(bu 2
+Include \fBjansson_config.h.win32\fP in the distribution tarball.
+.IP \(bu 2
+Remove \fB+\fP and leading zeros from exponents in the encoder.
+(#39)
+.IP \(bu 2
+Make Jansson build and work on MinGW. (#39, #38)
+.UNINDENT
+.IP \(bu 2
+Documentation
+.INDENT 2.0
+.IP \(bu 2
+Note that the same JSON values must not be encoded in parallel by
+separate threads. (#42)
+.IP \(bu 2
+Document MinGW support.
+.UNINDENT
+.UNINDENT
+.SS Version 2.2.1
+.sp
+Released 2011\-10\-06
+.INDENT 0.0
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Fix real number encoding and decoding under non\-C locales. (#32)
+.IP \(bu 2
+Fix identifier decoding under non\-UTF\-8 locales. (#35)
+.IP \(bu 2
+\fBjson_load_file()\fP: Open the input file in binary mode for maximum
+compatiblity.
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Clarify the lifecycle of the result of the \fBs\fP fromat of
+\fBjson_unpack()\fP\&. (#31)
+.IP \(bu 2
+Add some portability info. (#36)
+.IP \(bu 2
+Little clarifications here and there.
+.UNINDENT
+.IP \(bu 2
+Other:
+.INDENT 2.0
+.IP \(bu 2
+Some style fixes, issues detected by static analyzers.
+.UNINDENT
+.UNINDENT
+.SS Version 2.2
+.sp
+Released 2011\-09\-03
+.INDENT 0.0
+.IP \(bu 2
+New features:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_dump_callback()\fP: Pass the encoder output to a callback
+function in chunks.
+.UNINDENT
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_string_set()\fP: Check that target is a string and value is
+not NULL.
+.UNINDENT
+.IP \(bu 2
+Other:
+.INDENT 2.0
+.IP \(bu 2
+Documentation typo fixes and clarifications.
+.UNINDENT
+.UNINDENT
+.SS Version 2.1
+.sp
+Released 2011\-06\-10
+.INDENT 0.0
+.IP \(bu 2
+New features:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_loadb()\fP: Decode a string with a given size, useful if the
+string is not null terminated.
+.IP \(bu 2
+Add \fBJSON_ENCODE_ANY\fP encoding flag to allow encoding any JSON
+value. By default, only arrays and objects can be encoded. (#19)
+.IP \(bu 2
+Add \fBJSON_REJECT_DUPLICATES\fP decoding flag to issue a decoding
+error if any JSON object in the input contins duplicate keys. (#3)
+.IP \(bu 2
+Add \fBJSON_DISABLE_EOF_CHECK\fP decoding flag to stop decoding after a
+valid JSON input. This allows other data after the JSON data.
+.UNINDENT
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Fix an additional memory leak when memory allocation fails in
+\fBjson_object_set()\fP and friends.
+.IP \(bu 2
+Clear errno before calling \fBstrtod()\fP for better portability. (#27)
+.UNINDENT
+.IP \(bu 2
+Building:
+.INDENT 2.0
+.IP \(bu 2
+Avoid set\-but\-not\-used warning/error in a test. (#20)
+.UNINDENT
+.IP \(bu 2
+Other:
+.INDENT 2.0
+.IP \(bu 2
+Minor clarifications to documentation.
+.UNINDENT
+.UNINDENT
+.SS Version 2.0.1
+.sp
+Released 2011\-03\-31
+.INDENT 0.0
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Replace a few \fBmalloc()\fP and \fBfree()\fP calls with their
+counterparts that support custom memory management.
+.IP \(bu 2
+Fix object key hashing in json_unpack() strict checking mode.
+.IP \(bu 2
+Fix the parentheses in \fBJANSSON_VERSION_HEX\fP macro.
+.IP \(bu 2
+Fix \fBjson_object_size()\fP return value.
+.IP \(bu 2
+Fix a few compilation issues.
+.UNINDENT
+.IP \(bu 2
+Portability:
+.INDENT 2.0
+.IP \(bu 2
+Enhance portability of \fBva_copy()\fP\&.
+.IP \(bu 2
+Test framework portability enhancements.
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Distribute \fBdoc/upgrading.rst\fP with the source tarball.
+.IP \(bu 2
+Build documentation in strict mode in \fBmake distcheck\fP\&.
+.UNINDENT
+.UNINDENT
+.SS Version 2.0
+.sp
+Released 2011\-02\-28
+.sp
+This release is backwards incompatible with the 1.x release series.
+See the chapter "Upgrading from older versions" in documentation for
+details.
+.INDENT 0.0
+.IP \(bu 2
+Backwards incompatible changes:
+.INDENT 2.0
+.IP \(bu 2
+Unify unsigned integer usage in the API: All occurences of
+unsigned int and unsigned long have been replaced with size_t.
+.IP \(bu 2
+Change JSON integer\(aqs underlying type to the widest signed integer
+type available, i.e. long long if it\(aqs supported, otherwise long.
+Add a typedef json_int_t that defines the type.
+.IP \(bu 2
+Change the maximum indentation depth to 31 spaces in encoder. This
+frees up bits from the flags parameter of encoding functions
+\fBjson_dumpf()\fP, \fBjson_dumps()\fP and \fBjson_dump_file()\fP\&.
+.IP \(bu 2
+For future needs, add a flags parameter to all decoding functions
+\fBjson_loadf()\fP, \fBjson_loads()\fP and \fBjson_load_file()\fP\&.
+.UNINDENT
+.IP \(bu 2
+New features
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_pack()\fP, \fBjson_pack_ex()\fP, \fBjson_vpack_ex()\fP: Create JSON
+values based on a format string.
+.IP \(bu 2
+\fBjson_unpack()\fP, \fBjson_unpack_ex()\fP, \fBjson_vunpack_ex()\fP: Simple
+value extraction and validation functionality based on a format
+string.
+.IP \(bu 2
+Add column, position and source fields to the \fBjson_error_t\fP
+struct.
+.IP \(bu 2
+Enhance error reporting in the decoder.
+.IP \(bu 2
+\fBJANSSON_VERSION\fP et al.: Preprocessor constants that define the
+library version.
+.IP \(bu 2
+\fBjson_set_alloc_funcs()\fP: Set custom memory allocation functions.
+.UNINDENT
+.IP \(bu 2
+Fix many portability issues, especially on Windows.
+.IP \(bu 2
+Configuration
+.INDENT 2.0
+.IP \(bu 2
+Add file \fBjansson_config.h\fP that contains site specific
+configuration. It\(aqs created automatically by the configure script,
+or can be created by hand if the configure script cannot be used.
+The file \fBjansson_config.h.win32\fP can be used without
+modifications on Windows systems.
+.IP \(bu 2
+Add a section to documentation describing how to build Jansson on
+Windows.
+.IP \(bu 2
+Documentation now requires Sphinx 1.0 or newer.
+.UNINDENT
+.UNINDENT
+.SS Version 1.3
+.sp
+Released 2010\-06\-13
+.INDENT 0.0
+.IP \(bu 2
+New functions:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_object_iter_set()\fP, \fBjson_object_iter_set_new()\fP: Change
+object contents while iterating over it.
+.IP \(bu 2
+\fBjson_object_iter_at()\fP: Return an iterator that points to a
+specific object item.
+.UNINDENT
+.IP \(bu 2
+New encoding flags:
+.INDENT 2.0
+.IP \(bu 2
+\fBJSON_PRESERVE_ORDER\fP: Preserve the insertion order of object
+keys.
+.UNINDENT
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Fix an error that occured when an array or object was first
+encoded as empty, then populated with some data, and then
+re\-encoded
+.IP \(bu 2
+Fix the situation like above, but when the first encoding resulted
+in an error
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Clarify the documentation on reference stealing, providing an
+example usage pattern
+.UNINDENT
+.UNINDENT
+.SS Version 1.2.1
+.sp
+Released 2010\-04\-03
+.INDENT 0.0
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Fix reference counting on \fBtrue\fP, \fBfalse\fP and \fBnull\fP
+.IP \(bu 2
+Estimate real number underflows in decoder with 0.0 instead of
+issuing an error
+.UNINDENT
+.IP \(bu 2
+Portability:
+.INDENT 2.0
+.IP \(bu 2
+Make \fBint32_t\fP available on all systems
+.IP \(bu 2
+Support compilers that don\(aqt have the \fBinline\fP keyword
+.IP \(bu 2
+Require Autoconf 2.60 (for \fBint32_t\fP)
+.UNINDENT
+.IP \(bu 2
+Tests:
+.INDENT 2.0
+.IP \(bu 2
+Print test names correctly when \fBVERBOSE=1\fP
+.IP \(bu 2
+\fBtest/suites/api\fP: Fail when a test fails
+.IP \(bu 2
+Enhance tests for iterators
+.IP \(bu 2
+Enhance tests for decoding texts that contain null bytes
+.UNINDENT
+.IP \(bu 2
+Documentation:
+.INDENT 2.0
+.IP \(bu 2
+Don\(aqt remove \fBchanges.rst\fP in \fBmake clean\fP
+.IP \(bu 2
+Add a chapter on RFC conformance
+.UNINDENT
+.UNINDENT
+.SS Version 1.2
+.sp
+Released 2010\-01\-21
+.INDENT 0.0
+.IP \(bu 2
+New functions:
+.INDENT 2.0
+.IP \(bu 2
+\fBjson_equal()\fP: Test whether two JSON values are equal
+.IP \(bu 2
+\fBjson_copy()\fP and \fBjson_deep_copy()\fP: Make shallow and deep copies
+of JSON values
+.IP \(bu 2
+Add a version of all functions taking a string argument that
+doesn\(aqt check for valid UTF\-8: \fBjson_string_nocheck()\fP,
+\fBjson_string_set_nocheck()\fP, \fBjson_object_set_nocheck()\fP,
+\fBjson_object_set_new_nocheck()\fP
+.UNINDENT
+.IP \(bu 2
+New encoding flags:
+.INDENT 2.0
+.IP \(bu 2
+\fBJSON_SORT_KEYS\fP: Sort objects by key
+.IP \(bu 2
+\fBJSON_ENSURE_ASCII\fP: Escape all non\-ASCII Unicode characters
+.IP \(bu 2
+\fBJSON_COMPACT\fP: Use a compact representation with all unneeded
+whitespace stripped
+.UNINDENT
+.IP \(bu 2
+Bug fixes:
+.INDENT 2.0
+.IP \(bu 2
+Revise and unify whitespace usage in encoder: Add spaces between
+array and object items, never append newline to output.
+.IP \(bu 2
+Remove const qualifier from the \fBjson_t\fP parameter in
+\fBjson_string_set()\fP, \fBjson_integer_set()\fP and \fBjson_real_set()\fP\&.
+.IP \(bu 2
+Use \fBint32_t\fP internally for representing Unicode code points
+(int is not enough on all platforms)
+.UNINDENT
+.IP \(bu 2
+Other changes:
+.INDENT 2.0
+.IP \(bu 2
+Convert \fBCHANGES\fP (this file) to reStructured text and add it to
+HTML documentation
+.IP \(bu 2
+The test system has been refactored. Python is no longer required
+to run the tests.
+.IP \(bu 2
+Documentation can now be built by invoking \fBmake html\fP
+.IP \(bu 2
+Support for pkg\-config
+.UNINDENT
+.UNINDENT
+.SS Version 1.1.3
+.sp
+Released 2009\-12\-18
+.INDENT 0.0
+.IP \(bu 2
+Encode reals correctly, so that first encoding and then decoding a
+real always produces the same value
+.IP \(bu 2
+Don\(aqt export private symbols in \fBlibjansson.so\fP
+.UNINDENT
+.SS Version 1.1.2
+.sp
+Released 2009\-11\-08
+.INDENT 0.0
+.IP \(bu 2
+Fix a bug where an error message was not produced if the input file
+could not be opened in \fBjson_load_file()\fP
+.IP \(bu 2
+Fix an assertion failure in decoder caused by a minus sign without a
+digit after it
+.IP \(bu 2
+Remove an unneeded include of \fBstdint.h\fP in \fBjansson.h\fP
+.UNINDENT
+.SS Version 1.1.1
+.sp
+Released 2009\-10\-26
+.INDENT 0.0
+.IP \(bu 2
+All documentation files were not distributed with v1.1; build
+documentation in make distcheck to prevent this in the future
+.IP \(bu 2
+Fix v1.1 release date in \fBCHANGES\fP
+.UNINDENT
+.SS Version 1.1
+.sp
+Released 2009\-10\-20
+.INDENT 0.0
+.IP \(bu 2
+API additions and improvements:
+.INDENT 2.0
+.IP \(bu 2
+Extend array and object APIs
+.IP \(bu 2
+Add functions to modify integer, real and string values
+.IP \(bu 2
+Improve argument validation
+.IP \(bu 2
+Use unsigned int instead of \fBuint32_t\fP for encoding flags
+.UNINDENT
+.IP \(bu 2
+Enhance documentation
+.INDENT 2.0
+.IP \(bu 2
+Add getting started guide and tutorial
+.IP \(bu 2
+Fix some typos
+.IP \(bu 2
+General clarifications and cleanup
+.UNINDENT
+.IP \(bu 2
+Check for integer and real overflows and underflows in decoder
+.IP \(bu 2
+Make singleton values thread\-safe (\fBtrue\fP, \fBfalse\fP and \fBnull\fP)
+.IP \(bu 2
+Enhance circular reference handling
+.IP \(bu 2
+Don\(aqt define \fB\-std=c99\fP in \fBAM_CFLAGS\fP
+.IP \(bu 2
+Add C++ guards to \fBjansson.h\fP
+.IP \(bu 2
+Minor performance and portability improvements
+.IP \(bu 2
+Expand test coverage
+.UNINDENT
+.SS Version 1.0.4
+.sp
+Released 2009\-10\-11
+.INDENT 0.0
+.IP \(bu 2
+Relax Autoconf version requirement to 2.59
+.IP \(bu 2
+Make Jansson compile on platforms where plain \fBchar\fP is unsigned
+.IP \(bu 2
+Fix API tests for object
+.UNINDENT
+.SS Version 1.0.3
+.sp
+Released 2009\-09\-14
+.INDENT 0.0
+.IP \(bu 2
+Check for integer and real overflows and underflows in decoder
+.IP \(bu 2
+Use the Python json module for tests, or simplejson if the json
+module is not found
+.IP \(bu 2
+Distribute changelog (this file)
+.UNINDENT
+.SS Version 1.0.2
+.sp
+Released 2009\-09\-08
+.INDENT 0.0
+.IP \(bu 2
+Handle EOF correctly in decoder
+.UNINDENT
+.SS Version 1.0.1
+.sp
+Released 2009\-09\-04
+.INDENT 0.0
+.IP \(bu 2
+Fixed broken \fBjson_is_boolean()\fP
+.UNINDENT
+.SS Version 1.0
+.sp
+Released 2009\-08\-25
+.INDENT 0.0
+.IP \(bu 2
+Initial release
+.UNINDENT
+.INDENT 0.0
+.IP \(bu 2
+\fIgenindex\fP
+.IP \(bu 2
+\fIsearch\fP
+.UNINDENT
+.sp
+.SH AUTHOR
+Petri Lehtinen
+.SH COPYRIGHT
+2009-2014, Petri Lehtinen
+.\" Generated by docutils manpage writer.
+.
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/jansson.p5m Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,92 @@
+#
+# CDDL HEADER START
+#
+# The contents of this file are subject to the terms of the
+# Common Development and Distribution License (the "License").
+# You may not use this file except in compliance with the License.
+#
+# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
+# or http://www.opensolaris.org/os/licensing.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+#
+# When distributing Covered Code, include this CDDL HEADER in each
+# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
+# If applicable, add the following below this CDDL HEADER, with the
+# fields enclosed by brackets "[]" replaced with your own identifying
+# information: Portions Copyright [yyyy] [name of copyright owner]
+#
+# CDDL HEADER END
+#
+# Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved.
+#
+
+<transform file path=usr.*/man/.+ -> default mangler.man.stability volatile>
+<transform file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/(.+)$ -> set action.hash doc/html/%<\1>>
+set name=pkg.fmri \
+ value=pkg:/library/jansson@$(IPS_COMPONENT_VERSION),$(BUILD_VERSION)
+set name=pkg.summary value="Jansson - C library for working with JSON data"
+set name=pkg.description \
+ value="Jansson is a C library for encoding, decoding and manipulating JSON data. It features a simple and intuitive API and data model, comprehensive documentation, full Unicode support (UTF-8), an extensive test suite and no dependencies on other libraries."
+set name=com.oracle.info.description value="the Jansson C library"
+set name=com.oracle.info.tpno value=$(TPNO)
+set name=info.classification \
+ value=org.opensolaris.category.2008:System/Libraries
+set name=info.source-url value=$(COMPONENT_ARCHIVE_URL)
+set name=info.upstream-url value=$(COMPONENT_PROJECT_URL)
+set name=org.opensolaris.arc-caseid value=PSARC/2014/362
+set name=org.opensolaris.consolidation value=$(CONSOLIDATION)
+file path=usr/include/jansson/jansson.h
+file path=usr/include/jansson/jansson_config.h
+link path=usr/lib/$(MACH64)/libjansson.so target=libjansson.so.4.7.0
+link path=usr/lib/$(MACH64)/libjansson.so.4 target=libjansson.so.4.7.0
+file path=usr/lib/$(MACH64)/libjansson.so.4.7.0
+file path=usr/lib/$(MACH64)/pkgconfig/jansson.pc
+link path=usr/lib/libjansson.so target=libjansson.so.4.7.0
+link path=usr/lib/libjansson.so.4 target=libjansson.so.4.7.0
+file path=usr/lib/libjansson.so.4.7.0
+file path=usr/lib/pkgconfig/jansson.pc
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_downloads/github_commits.c
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_downloads/github_commits.c
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_sources/apiref.txt
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_sources/changes.txt
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_sources/conformance.txt
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_sources/gettingstarted.txt
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_sources/index.txt
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_sources/portability.txt
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_sources/tutorial.txt
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_sources/upgrading.txt
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/ajax-loader.gif
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/basic.css
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/comment-bright.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/comment-close.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/comment.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/default.css
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/doctools.js
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/down-pressed.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/down.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/file.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/jquery.js
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/minus.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/plus.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/pygments.css
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/searchtools.js
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/sidebar.js
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/underscore.js
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/up-pressed.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/up.png
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/_static/websupport.js
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/apiref.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/changes.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/conformance.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/genindex.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/gettingstarted.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/index.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/portability.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/search.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/searchindex.js
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/tutorial.html
+file path=usr/share/doc/jansson-$(COMPONENT_VERSION)/html/upgrading.html
+file doc/man3lib/jansson.3lib path=usr/share/man/man3lib/jansson.3lib
+license LICENSE license=MIT
+
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/patches/001-usr-include-jansson.patch Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,16 @@
+Tomas Heran <[email protected]>
+Need to install header files to /usr/include/jansson
+This patch will not be reported upstream.
+
+diff -r fa5b56b77f9c -r 10395313a7ae jansson.pc.in
+--- a/jansson.pc.in Tue Oct 28 16:31:32 2014 +0100
++++ b/jansson.pc.in Tue Oct 28 17:05:35 2014 +0100
+@@ -1,7 +1,7 @@
+ prefix=@prefix@
+ exec_prefix=@exec_prefix@
+ libdir=@libdir@
+-includedir=${prefix}/include
++includedir=${prefix}/include/jansson
+
+ Name: Jansson
+ Description: Library for encoding, decoding and manipulating JSON data
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/components/jansson/resolve.deps Wed Oct 29 17:55:16 2014 +0100
@@ -0,0 +1,1 @@
+system/library
