2 This file is part of GNUnet
3 Copyright (C) 2014, 2015, 2016 GNUnet e.V.
5 GNUnet is free software; you can redistribute it and/or modify it under the
6 terms of the GNU General Public License as published by the Free Software
7 Foundation; either version 3, or (at your option) any later version.
9 GNUnet is distributed in the hope that it will be useful, but WITHOUT ANY
10 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
11 A PARTICULAR PURPOSE. See the GNU General Public License for more details.
13 You should have received a copy of the GNU General Public License along with
14 GNUnet; see the file COPYING. If not, If not, see <http://www.gnu.org/licenses/>
18 * @brief functions to parse JSON snippets
19 * @author Florian Dold
20 * @author Benedikt Mueller
21 * @author Christian Grothoff
24 #include "gnunet_json_lib.h"
28 * Navigate and parse data in a JSON tree. Tries to parse the @a root
29 * to find all of the values given in the @a spec. If one of the
30 * entries in @a spec cannot be found or parsed, the name of the JSON
31 * field is returned in @a error_json_name, and the offset of the
32 * entry in @a spec is returned in @a error_line.
34 * @param root the JSON node to start the navigation at.
35 * @param spec parse specification array
36 * @param[out] error_json_name which JSON field was problematic
37 * @param[out] which index into @a spec did we encounter an error
38 * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
41 GNUNET_JSON_parse (const json_t *root,
42 struct GNUNET_JSON_Specification *spec,
43 const char **error_json_name,
44 unsigned int *error_line)
51 for (i=0;NULL != spec[i].parser;i++)
53 if (NULL == spec[i].field)
54 pos = (json_t *) root;
56 pos = json_object_get (root,
60 spec[i].parser (spec[i].cls,
64 if (NULL != error_json_name)
65 *error_json_name = spec[i].field;
66 if (NULL != error_line)
68 GNUNET_JSON_parse_free (spec);
72 return GNUNET_OK; /* all OK! */
77 * Frees all elements allocated during a #GNUNET_JSON_parse()
80 * @param spec specification of the parse operation
83 GNUNET_JSON_parse_free (struct GNUNET_JSON_Specification *spec)
87 for (i=0;NULL != spec[i].parser;i++)
88 if (NULL != spec[i].cleaner)
89 spec[i].cleaner (spec[i].cls,