JSON library based on JSMN lib

Dependents:   ATT_WNCInterface_Info WNCInterface_HTTP_example NerfUS-Coord Mbed_Prototype_copy_4_INNO_day_15_6_2017 ... more

C++ JSON wrapper over JSMN lib (https://github.com/zserge/jsmn).

This C++ Class is a set of common tools/procedures as a C++ wrapper over JSMN JSON parser library. It is intended to provide the boiler-plate code, with intentions to reduce code clutter, in more of C++ fashion.

In contrast to original library, Json is intended to work strictly with valid JSON structures. Non-standard JSON structures should result in an error.

This class works explicitly on the indices returned by underlying JSMN library. In the scope of this class, its function parameters, return types, and documentation, the term 'index' will always mean the index of JSMN tokens, parsed by the Json constructor, unless and until explicitly mentioned otherwise.

jsmn.h

Committer:
faheem_chaudhary
Date:
2016-08-16
Revision:
7:8aa4d0e98eb0
Parent:
5:dd98cf00ed9b

File content as of revision 7:8aa4d0e98eb0:

/* Author: Faheem Inayat
 * Created by "Night Crue" Team @ TechShop San Jose, CA
 *
 * --- DISCLAIMER ---
 * This code is a modified version of original JSMN lirary, written by
 *    *** Serge A. Zaitsev ***
 * and hosted at https://github.com/zserge/jsmn
 * Any modification to the original source is not guaranteed to be included
 * in this version.  As of writing of this file, the original source is 
 * licensed under MIT License
 * (http://www.opensource.org/licenses/mit-license.php).
 */

#ifndef __JSMN_H_
#define __JSMN_H_

#include <stddef.h>

#ifdef __cplusplus
extern "C"
{
#endif
/*
  Modified version of original jsmn lib ... added a type "JSMN_KEY" and enabled
  parent-pointers and strict JSON check.
*/
    /**
     * JSON type identifier. Basic types are:
     *  o Object
     *  o Array
     *  o String
     *  o Other primitive: number, boolean (true/false) or null
     */
    typedef enum
    {
        JSMN_UNDEFINED = 0,
        JSMN_OBJECT = 1,
        JSMN_ARRAY = 2,
        JSMN_STRING = 3,
        JSMN_PRIMITIVE = 4,
        JSMN_KEY = 5
    } jsmntype_t;

    enum jsmnerr
    {
        /* Not enough tokens were provided */
        JSMN_ERROR_NOMEM = -1,
        /* Invalid character inside JSON string */
        JSMN_ERROR_INVAL = -2,
        /* The string is not a full JSON packet, more bytes expected */
        JSMN_ERROR_PART = -3
    };

    /**
     * JSON token description.
     * @param       type    type (object, array, string etc.)
     * @param       start   start position in JSON data string
     * @param       end     end position in JSON data string
     */
    typedef struct
    {
            jsmntype_t type;
            int start;
            int end;
            int parent;
            int childCount;
    } jsmntok_t;

    /**
     * JSON parser. Contains an array of token blocks available. Also stores
     * the string being parsed now and current position in that string
     */
    typedef struct
    {
            unsigned int pos; /* offset in the JSON string */
            unsigned int toknext; /* next token to allocate */
            int toksuper; /* superior token node, e.g parent object or array */
    } jsmn_parser;

    /**
     * Create JSON parser over an array of tokens
     */
    void jsmn_init ( jsmn_parser *parser );

    /**
     * Run JSON parser. It parses a JSON data string into and array of tokens, each describing
     * a single JSON object.
     */
    int jsmn_parse ( jsmn_parser *parser, const char *js, size_t len, jsmntok_t *tokens, unsigned int num_tokens );

#ifdef __cplusplus
}
#endif

#endif /* __JSMN_H_ */