175 lines
4.4 KiB
C
175 lines
4.4 KiB
C
#ifndef JSON_PARSER_H
|
|
#define JSON_PARSER_H
|
|
|
|
/* JSON_parser.h */
|
|
|
|
|
|
#include <stddef.h>
|
|
|
|
/* Windows DLL stuff */
|
|
/*
|
|
#ifdef _WIN32
|
|
# ifdef JSON_PARSER_DLL_EXPORTS
|
|
# define JSON_PARSER_DLL_API __declspec(dllexport)
|
|
# else
|
|
# define JSON_PARSER_DLL_API __declspec(dllimport)
|
|
# endif
|
|
#else
|
|
*/
|
|
#define JSON_PARSER_DLL_API
|
|
/*
|
|
#endif
|
|
*/
|
|
|
|
#include <inttypes.h>
|
|
typedef int64_t JSON_int_t;
|
|
#define JSON_PARSER_INTEGER_SSCANF_TOKEN "%" PRId64
|
|
#define JSON_PARSER_INTEGER_SPRINTF_TOKEN "%" PRId64
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef enum
|
|
{
|
|
JSON_T_NONE = 0,
|
|
JSON_T_ARRAY_BEGIN,
|
|
JSON_T_ARRAY_END,
|
|
JSON_T_OBJECT_BEGIN,
|
|
JSON_T_OBJECT_END,
|
|
JSON_T_INTEGER,
|
|
JSON_T_FLOAT,
|
|
JSON_T_NULL,
|
|
JSON_T_TRUE,
|
|
JSON_T_FALSE,
|
|
JSON_T_STRING,
|
|
JSON_T_KEY,
|
|
JSON_T_MAX
|
|
} JSON_type;
|
|
|
|
typedef struct JSON_value_struct
|
|
{
|
|
union
|
|
{
|
|
JSON_int_t integer_value;
|
|
|
|
long double float_value;
|
|
|
|
struct
|
|
{
|
|
const char* value;
|
|
size_t length;
|
|
} str;
|
|
} vu;
|
|
} JSON_value;
|
|
|
|
/*! \brief JSON parser callback
|
|
|
|
\param ctx The pointer passed to new_JSON_parser.
|
|
\param type An element of JSON_type but not JSON_T_NONE.
|
|
\param value A representation of the parsed value. This parameter is NULL
|
|
for
|
|
JSON_T_ARRAY_BEGIN, JSON_T_ARRAY_END, JSON_T_OBJECT_BEGIN,
|
|
JSON_T_OBJECT_END,
|
|
JSON_T_NULL, JSON_T_TRUE, and SON_T_FALSE. String values are always
|
|
returned
|
|
as zero-terminated C strings.
|
|
|
|
\return Non-zero if parsing should continue, else zero.
|
|
*/
|
|
typedef int ( *JSON_parser_callback )( void* ctx, int type,
|
|
const struct JSON_value_struct*
|
|
value );
|
|
|
|
|
|
/*! \brief The structure used to configure a JSON parser object
|
|
|
|
\param depth If negative, the parser can parse arbitrary levels of JSON,
|
|
otherwise
|
|
the depth is the limit
|
|
\param Pointer to a callback. This parameter may be NULL. In this case the
|
|
input is merely checked for validity.
|
|
\param Callback context. This parameter may be NULL.
|
|
\param depth. Specifies the levels of nested JSON to allow. Negative numbers
|
|
yield unlimited nesting.
|
|
\param allowComments. To allow C style comments in JSON, set to non-zero.
|
|
\param handleFloatsManually. To decode floating point numbers manually set
|
|
this parameter to non-zero.
|
|
|
|
\return The parser object.
|
|
*/
|
|
typedef struct JSON_config_struct
|
|
{
|
|
JSON_parser_callback callback;
|
|
void* callback_ctx;
|
|
int depth;
|
|
int allow_comments;
|
|
int handle_floats_manually;
|
|
} JSON_config;
|
|
|
|
|
|
/*! \brief Initializes the JSON parser configuration structure to default
|
|
values.
|
|
|
|
The default configuration is
|
|
- 127 levels of nested JSON (depends on JSON_PARSER_STACK_SIZE, see
|
|
json_parser.c)
|
|
- no parsing, just checking for JSON syntax
|
|
- no comments
|
|
|
|
\param config. Used to configure the parser.
|
|
*/
|
|
JSON_PARSER_DLL_API void init_JSON_config(
|
|
JSON_config* config );
|
|
|
|
/*! \brief Create a JSON parser object
|
|
|
|
\param config. Used to configure the parser. Set to NULL to use the default
|
|
configuration.
|
|
See init_JSON_config
|
|
|
|
\return The parser object.
|
|
*/
|
|
JSON_PARSER_DLL_API extern struct JSON_parser_struct* new_JSON_parser(
|
|
JSON_config* config );
|
|
|
|
/*! \brief Destroy a previously created JSON parser object. */
|
|
JSON_PARSER_DLL_API extern void delete_JSON_parser(
|
|
struct JSON_parser_struct* jc );
|
|
|
|
/*! \brief Parse a character.
|
|
|
|
\return Non-zero, if all characters passed to this function are part of are
|
|
valid JSON.
|
|
*/
|
|
JSON_PARSER_DLL_API extern int JSON_parser_char(
|
|
struct JSON_parser_struct* jc,
|
|
int
|
|
next_char );
|
|
|
|
/*! \brief Finalize parsing.
|
|
|
|
Call this method once after all input characters have been consumed.
|
|
|
|
\return Non-zero, if all parsed characters are valid JSON, zero otherwise.
|
|
*/
|
|
JSON_PARSER_DLL_API extern int JSON_parser_done(
|
|
struct JSON_parser_struct* jc );
|
|
|
|
/*! \brief Determine if a given string is valid JSON white space
|
|
|
|
\return Non-zero if the string is valid, zero otherwise.
|
|
*/
|
|
JSON_PARSER_DLL_API extern int
|
|
JSON_parser_is_legal_white_space_string(
|
|
const char* s );
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif /* JSON_PARSER_H */
|