--- libelwix/inc/elwix/ajson.h 2017/11/24 09:54:01 1.1 +++ libelwix/inc/elwix/ajson.h 2017/11/30 13:46:27 1.2 @@ -0,0 +1,278 @@ +/************************************************************************* +* (C) 2017 AITNET ltd - Sofia/Bulgaria - +* by Michael Pounov +* +* $Author: misho $ +* $Id: ajson.h,v 1.2 2017/11/30 13:46:27 misho Exp $ +* +************************************************************************** +The ELWIX and AITNET software is distributed under the following +terms: + +All of the documentation and software included in the ELWIX and AITNET +Releases is copyrighted by ELWIX - Sofia/Bulgaria + +Copyright 2004 - 2017 + by Michael Pounov . All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. +3. All advertising materials mentioning features or use of this software + must display the following acknowledgement: +This product includes software developed by Michael Pounov +ELWIX - Embedded LightWeight unIX and its contributors. +4. Neither the name of AITNET nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY AITNET AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. +*/ +#ifndef __AJSON_H +#define __AJSON_H + + +/* JSON type identifiers */ +typedef enum { + J_UNDEF = 0, + J_OBJECT = 1, + J_ARRAY = 2, + J_STRING = 3, + J_VALUE = 4 +} jtype_t; + +/* JSON error numbers */ +typedef enum { + J_ERR_OK = 0, + J_ERR_NOMEM = 1, + J_ERR_INVAL = 2, + J_ERR_PART = 3, + J_ERR_PARAM = 4 +} jerr_t; + +typedef struct _tagHandler { + unsigned long h_pos; + unsigned long h_next; + long h_parent; + void *h_alloc; + int h_strict; +} json_t; +#define json_toksnum(x) (x)->h_next + +typedef struct _tagToken { + long tok_idx; + jtype_t tok_type; + long tok_start; + long tok_end; + long tok_size; + long tok_parent; +} jtok_t; +#define json_toktype(x) (x)->tok_type +#define json_toksize(x) (x)->tok_size +#define json_toklen(x) ((x)->tok_end - (x)->tok_start) +#define json_tokstr(j, x) ((j) + (x)->tok_start) +#define json_tokstrcpy(d, j, x) { strncpy((d), json_tokstr((j), (x)), json_toklen(x)); \ + (d)[json_toklen(x)] = 0; } + + +/* + * json_init() - Initialize JSON handler + * + * @json = JSON handler, if there is NULL then dynamically will be allocated + * @jstrict = JSON strict mode, when we select strict mode every unquoted value is error + * return: =NULL error or !=NULL ready for use JSON handler and should be free with json_free() + */ +json_t *json_init(json_t * __restrict json, int jstrict); + +/* + * json_free() - Free JSON handler + * + * @json = JSON handler + * return: none + */ +void json_free(json_t * __restrict json); + +/* + * json_parse() - Parse JSON string + * + * @json = JSON handler + * @jstr = JSON string + * @jlen = JSON string length + * @jtoks = Token array + * @toksnum = Token array size, return number of allocated tokens in array + * return: -1 error or number of found tokens + */ +unsigned int json_parse(json_t * __restrict json, const char *jstr, size_t jlen, + jtok_t * __restrict jtoks, unsigned int toksnum); + +/* + * json_token2val() - Return token to AIT variable + * + * @jstr = JSON string + * @tok = Token for convert + * @return =NULL error or !=NULL variable, after use should be ait_freeVar() + */ +ait_val_t *json_token2val(const char *jstr, jtok_t * __restrict tok); +/* + * json_token2str() - Return token to string + * + * @jstr = JSON string + * @tok = Token for convert + * @return =NULL error or !=NULL allocated str, after use should be e_free() + */ +char *json_token2str(const char *jstr, jtok_t * __restrict tok); +/* + * json_token2num() - Return token to numeric + * + * @jstr = JSON string + * @tok = Token for convert + * @return number + */ +long json_token2num(const char *jstr, jtok_t * __restrict tok); +/* + * json_token2array() - Convert token to string array + * + * @jstr = JSON string + * @tok = Token for convert + * return: =NULL error or !=NULL allocated array with string variables, + * after use should be ait_freeVars() + */ +array_t *json_token2array(const char *jstr, jtok_t * __restrict tok); + +/* + * json_findbykey() - Find data by key + * + * @jstr = JSON string + * @key = Search key + * @toks = Parsed tokens + * @toksnum = Number of parsed tokens + * return: =NULL error or !=NULL data token found + */ +jtok_t *json_findbykey(const char *jstr, const char *key, + jtok_t * __restrict toks, int toksnum); + + +/* + * json_add_begin_object() - Adds begin of object { + * + * @jstr = JSON string + * @jlen = JSON string length + * @wspace = whitespace include + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_begin_object(char * __restrict jstr, int jlen, int wspace); +/* + * json_add_end_object() - Adds end of object } + * + * @jstr = JSON string + * @jlen = JSON string length + * @wspace = whitespace include + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_end_object(char * __restrict jstr, int jlen, int wspace); +/* + * json_add_begin_array() - Adds begin of array [ + * + * @jstr = JSON string + * @jlen = JSON string length + * @wspace = whitespace include + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_begin_array(char * __restrict jstr, int jlen, int wspace); +/* + * json_add_end_array() - Adds end of array ] + * + * @jstr = JSON string + * @jlen = JSON string length + * @wspace = whitespace include + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_end_array(char * __restrict jstr, int jlen, int wspace); +/* + * json_add_char() - Adds character + * + * @jstr = JSON string + * @jlen = JSON string length + * @ch = Character + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_char(char * __restrict jstr, int jlen, unsigned char ch); +/* + * json_add_colon() - Adds key/value pair delimiter colon : + * + * @jstr = JSON string + * @jlen = JSON string length + * @wspace = whitespace include + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_colon(char * __restrict jstr, int jlen, int wspace); +/* + * json_add_comma() - Adds value delimiter comma , + * + * @jstr = JSON string + * @jlen = JSON string length + * @wspace = whitespace include + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_comma(char * __restrict jstr, int jlen, int wspace); +/* + * json_add_string() - Adds string + * + * @jstr = JSON string + * @jlen = JSON string length + * @unquot = Unquoted string + * @str = String, it can't be NULL + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_string(char * __restrict jstr, int jlen, int unquot, const char *str); +/* + * json_add_value() - Adds value + * + * @jstr = JSON string + * @jlen = JSON string length + * @unquot = Unquoted number + * @num = Number + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_value(char * __restrict jstr, int jlen, int unquot, long num); +/* + * json_add_pair() - Adds key/value pair + * + * @jstr = JSON string + * @jlen = JSON string length + * @wspace = whitespace include + * @key = Key string + * @val = Value string + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_pair(char * __restrict jstr, int jlen, int wspace, + const char *key, const char *val); +/* + * json_add_array() - Adds array + * + * @jstr = JSON string + * @jlen = JSON string length + * @wspace = whitespace include + * @arr = Array with variables + * return: -1 error or !=-1 actual JSON string length + */ +int json_add_array(char * __restrict jstr, int jlen, int wspace, + array_t * __restrict arr); + + +#endif