Home

Awesome

🔋 JSON parser for C

Build Status Build status Documentation Status Codacy Badge

This is very simple and very powerful JSON parser. It creates DOM-like data structure and allows to iterate and process JSON objects very simple way. It does not alloc any memory for JSON itself, it only allocs memory for tokens. It also does not use recursive way to build data structure which makes it very fast to build DOM-like tree structure.

Documentation

Almost all functions (inline versions) and parameters are documented inside related headers. <br /> Complete documentation: http://json.readthedocs.io

Features

Object Map

Here a VERY UNIQUE and VERY COOL and VERY EASY and VERY FAST way to parse known JSON: objmap.

void
callback_1(json_t * __restrict json, void * __restrict obj) {
  printf("entered callback_1\n");
}

json = json_parse(/* JSON string */, true);

json_objmap_t objmap[] = {
    {
      .key = "key1",
      .foundFunc = {
        .func  = callback_1,
        .param = "callback 1 param" 
      }
    },
    {
      .key = "key2",
      .foundFunc = {
        .func = callback_1
      }
    }
};

/* or you can use macro helpers which is more readable if you don't need more details: */
json_objmap_t objmap[] = {
    JSON_OBJMAP_FN("key 1", func1, param1),
    JSON_OBJMAP_FN("key 2", func2, param2),
    JSON_OBJMAP_FN("key 3", func3, param3),
    /* ... */
};

json_objmap_call(json, objmap, ARRAY_LEN(objmap), NULL);

/* or use this to iterate objmap manually */
json_objmap(json, objmap, ARRAY_LEN(objmap));

In this way you don't have to compare keys in a loopi just map the keys with a function or with userdata. You don't have to use function in this way, you may use to map json object to userdata which may be a GOTO LABEL (to use compound gotos) or something else.

Important Note for Arrays

Important Note for keys and values

TODOs

Build

Unix (Autotools)

sh autogen.sh
./configure
make
[sudo] make install

you can grap library in .libs folder after build finished

Windows (MSBuild)

Windows related build files, project files are located in win folder, make sure you are inside tm/win folder. Code Analysis are enabled, it may take awhile to build

cd win
.\build.bat
Cmake options with Defaults:
option(JSON_SHARED "Shared build" ON)
option(JSON_STATIC "Static build" OFF)
option(JSON_USE_C99 "" OFF) # C11 
option(JSON_USE_TEST "Enable Tests" OFF) # for make check - make test
mkdir build && cd build
cmake ..
make
[sudo] make install

Header-only or Compiled Library

The functions has the jsonc_ prefix are compiled version which is called from library. To use this feature you must include json/call/json.h header.

To use header-only library you must include json/json.h header. The functions has the json_ prefix are forced to be inlined. When you use this, you don't have to compile the library.

todo.

Example usage

You can inspect json_print() to view usage in more detail. The example will be updated later to give more detail.

#include <json/json.h>
#include <json/print.h>

int main(int argc, const char * argv[]) {
  json_doc_t *doc;
  json_t     *root;
  
  doc  = json_parse(/* JSON string */, true);
  root = doc->root;

  json_print_human(stderr, root);

  json_free(doc);

  return 0;
}


const json_doc_t *jsonDoc;
const json_t         *json;

jsonDoc = json_parse(/* JSON string */, true);
json    = jsonDoc->root->value;

/* already defined in util.h */
JSON_INLINE
bool
json_key_eq(const json_t * __restrict obj, const char * __restrict str) {
  return strncmp(str, obj->key, obj->keySize) == 0;
}

while (json) {
    if (json_key_eq(json, "key 1")) {
      int aNumber;

     aNumber = json_int32(json, 0);

     /* ... */
    } else if (json_key_eq(json, "key 2")) {
      const char *nonNullTerminatedString;
      const char *nullTerminatedString;

      /* just pointer */
      nonNullTerminatedString = json_string(json);

       /* null-terminated string (strdup), needs to be freed */
      nullTerminatedString    = json_string_dup(json);

     /* ... */
    } else if (json_key_eq(json,"key 3")) {
      json_t *aChild;
      
      aChild = json->value;
      while (aChild) {
          /* handle child node */
          aChild = aChild->next;
      }
    }

    json = json->next;
}

Using Object Map

Here a VERY UNIQUE and VERY COOL and VERY EASY and VERY FAST way to parse known JSON: objmap.

void
callback_1(json_t * __restrict json, void * __restrict obj) {
  printf("entered callback_1\n");
}

json = json_parse(/* JSON string */, true);

json_objmap_t objmap[] = {
    {
      .key = "key1",
      .foundFunc = {
        .func = callback_1
      }
    },
    {
      .key = "key2",
      .foundFunc = {
        .func = callback_1
      }
    }
};

/* or you can use macro helpers which is more readable if you don't need more details: */
json_objmap_t objmap[] = {
    JSON_OBJMAP_FN("key 1", func1, param1),
    JSON_OBJMAP_FN("key 2", func2, param2),
    JSON_OBJMAP_FN("key 3", func3, param3),
    /* ... */
};

json_objmap_call(json, objmap, ARRAY_LEN(objmap), NULL);

In this way you don't have to compare keys in a loopi just map the keys with a function or with userdata. You don't have to use function in this way, you may use to map json object to userdata which may be a GOTO LABEL (to use compound gotos) or something else.

License

MIT. check the LICENSE file