mirror of
https://github.com/Unidata/netcdf-c.git
synced 2025-01-18 15:55:12 +08:00
143 lines
4.3 KiB
C
143 lines
4.3 KiB
C
/* Copyright 2018, UCAR/Unidata.
|
|
See the COPYRIGHT file for more information.
|
|
*/
|
|
|
|
#ifndef NCJSON_H
|
|
#define NCJSON_H
|
|
|
|
#ifndef OPTEXPORT
|
|
#ifdef NETCDF_JSON_H
|
|
#define OPTEXPORT static
|
|
#else /*!NETCDF_JSON_H*/
|
|
#ifdef _WIN32
|
|
#define OPTEXPORT __declspec(dllexport)
|
|
#else
|
|
#define OPTEXPORT extern
|
|
#endif
|
|
#endif /*NETCDF_JSON_H*/
|
|
#endif /*OPTEXPORT*/
|
|
|
|
/**************************************************/
|
|
/* Json object sorts (note use of term sort rather than e.g. type or discriminant) */
|
|
#define NCJ_UNDEF 0
|
|
#define NCJ_STRING 1
|
|
#define NCJ_INT 2
|
|
#define NCJ_DOUBLE 3
|
|
#define NCJ_BOOLEAN 4
|
|
#define NCJ_DICT 5
|
|
#define NCJ_ARRAY 6
|
|
#define NCJ_NULL 7
|
|
|
|
#define NCJ_NSORTS 8
|
|
|
|
/* Define a struct to store primitive values as unquoted
|
|
strings. The sort will provide more info. Do not bother with
|
|
a union since the amount of saved space is minimal.
|
|
*/
|
|
|
|
typedef struct NCjson {
|
|
int sort; /* of this object */
|
|
char* string; /* sort != DICT|ARRAY */
|
|
struct NCjlist {
|
|
size_t len;
|
|
struct NCjson** contents;
|
|
} list; /* sort == DICT|ARRAY */
|
|
} NCjson;
|
|
|
|
/* Structure to hold result of convertinf one json sort to value of another type;
|
|
don't use union so we can know when to reclaim sval
|
|
*/
|
|
struct NCJconst {int bval; long long ival; double dval; char* sval;};
|
|
#define NCJconst_empty {0,0,0.0,NULL}
|
|
|
|
/**************************************************/
|
|
/* Extended API */
|
|
|
|
/* Return 0 if ok else -1 */
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* Parse a string to NCjson*/
|
|
OPTEXPORT int NCJparse(const char* text, unsigned flags, NCjson** jsonp);
|
|
|
|
/* Parse a counted string to NCjson*/
|
|
OPTEXPORT int NCJparsen(size_t len, const char* text, unsigned flags, NCjson** jsonp);
|
|
|
|
/* Reclaim a JSON tree */
|
|
OPTEXPORT void NCJreclaim(NCjson* json);
|
|
|
|
/* Create a new JSON node of a given sort */
|
|
OPTEXPORT int NCJnew(int sort, NCjson** objectp);
|
|
|
|
/* Create new json object with given string content */
|
|
OPTEXPORT int NCJnewstring(int sort, const char* value, NCjson** jsonp);
|
|
|
|
/* Create new json object with given counted string content */
|
|
OPTEXPORT int NCJnewstringn(int sort, size_t len, const char* value, NCjson** jsonp);
|
|
|
|
/* Get dict key value by name */
|
|
OPTEXPORT int NCJdictget(const NCjson* dict, const char* key, const NCjson** valuep);
|
|
|
|
/* Convert one json sort to value of another type; don't use union so we can know when to reclaim sval */
|
|
OPTEXPORT int NCJcvt(const NCjson* value, int outsort, struct NCJconst* output);
|
|
|
|
/* Insert an atomic value to an array or dict object. */
|
|
OPTEXPORT int NCJaddstring(NCjson* json, int sort, const char* s);
|
|
|
|
/* Append value to an array or dict object. */
|
|
OPTEXPORT int NCJappend(NCjson* object, NCjson* value);
|
|
|
|
/* Insert key-value pair into a dict object. key will be copied */
|
|
OPTEXPORT int NCJinsert(NCjson* object, const char* key, NCjson* value);
|
|
|
|
/* Insert key-value pair as strings into a dict object.
|
|
key and value will be copied */
|
|
OPTEXPORT int NCJinsertstring(NCjson* object, const char* key, const char* value);
|
|
|
|
/* Insert key-value pair where value is an int */
|
|
OPTEXPORT int NCJinsertint(NCjson* object, const char* key, long long ivalue);
|
|
|
|
/* Unparser to convert NCjson object to text in buffer */
|
|
OPTEXPORT int NCJunparse(const NCjson* json, unsigned flags, char** textp);
|
|
|
|
/* Deep clone a json object */
|
|
OPTEXPORT int NCJclone(const NCjson* json, NCjson** clonep);
|
|
|
|
#ifndef NETCDF_JSON_H
|
|
/* dump NCjson* object to output file */
|
|
OPTEXPORT void NCJdump(const NCjson* json, unsigned flags, FILE*);
|
|
/* convert NCjson* object to output string */
|
|
OPTEXPORT const char* NCJtotext(const NCjson* json);
|
|
#endif /*NETCDF_JSON_H*/
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
/* Getters */
|
|
#define NCJsort(x) ((x)->sort)
|
|
#define NCJstring(x) ((x)->string)
|
|
#define NCJlength(x) ((x)==NULL ? 0 : (x)->list.len)
|
|
#define NCJdictlength(x) ((x)==NULL ? 0 : (x)->list.len/2)
|
|
#define NCJcontents(x) ((x)->list.contents)
|
|
#define NCJith(x,i) ((x)->list.contents[i])
|
|
#define NCJdictith(x,i) ((x)->list.contents[2*i])
|
|
|
|
/* Setters */
|
|
#define NCJsetsort(x,s) (x)->sort=(s)
|
|
#define NCJsetstring(x,y) (x)->string=(y)
|
|
#define NCJsetcontents(x,c) (x)->list.contents=(c)
|
|
#define NCJsetlength(x,l) (x)->list.len=(l)
|
|
|
|
/* Misc */
|
|
#define NCJisatomic(j) ((j)->sort != NCJ_ARRAY && (j)->sort != NCJ_DICT && (j)->sort != NCJ_NULL && (j)->sort != NCJ_UNDEF)
|
|
|
|
/**************************************************/
|
|
|
|
#endif /*NCJSON_H*/
|
|
|
|
|
|
|