src/json/json.c

   1 /*
   2   This file is part of GNUnet
   3   Copyright (C) 2014, 2015, 2016 GNUnet e.V.
   4
   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.
   8
   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.
  12
  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/>
  15 */
  16 /**
  17  * @file json/json.c
  18  * @brief functions to parse JSON snippets
  19  * @author Florian Dold
  20  * @author Benedikt Mueller
  21  * @author Christian Grothoff
  22  */
  23 #include "platform.h"
  24 #include "gnunet_json_lib.h"
  25
  26
  27 /**
  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.
  33  *
  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
  39  */
  40 int
  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)
  45 {
  46   unsigned int i;
  47   json_t *pos;
  48
  49   if (NULL == root)
  50     return GNUNET_SYSERR;
  51   for (i=0;NULL != spec[i].parser;i++)
  52   {
  53     if (NULL == spec[i].field)
  54       pos = (json_t *) root;
  55     else
  56       pos = json_object_get (root,
  57                              spec[i].field);
  58     if ( (NULL == pos) ||
  59          (GNUNET_OK !=
  60           spec[i].parser (spec[i].cls,
  61                           pos,
  62                           &spec[i])) )
  63     {
  64       if (NULL != error_json_name)
  65         *error_json_name = spec[i].field;
  66       if (NULL != error_line)
  67         *error_line = i;
  68       GNUNET_JSON_parse_free (spec);
  69       return GNUNET_SYSERR;
  70     }
  71   }
  72   return GNUNET_OK; /* all OK! */
  73 }
  74
  75
  76 /**
  77  * Frees all elements allocated during a #GNUNET_JSON_parse()
  78  * operation.
  79  *
  80  * @param spec specification of the parse operation
  81  */
  82 void
  83 GNUNET_JSON_parse_free (struct GNUNET_JSON_Specification *spec)
  84 {
  85   unsigned int i;
  86
  87   for (i=0;NULL != spec[i].parser;i++)
  88     if (NULL != spec[i].cleaner)
  89       spec[i].cleaner (spec[i].cls,
  90                        &spec[i]);
  91 }
  92
  93
  94 /* end of json.c */