mirror of
https://github.com/transmission/transmission
synced 2024-12-27 01:57:52 +00:00
152 lines
4.3 KiB
C
152 lines
4.3 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
|
|
|
|
/* Determine the integer type use to parse non-floating point numbers */
|
|
#if __STDC_VERSION__ >= 199901L || HAVE_LONG_LONG == 1
|
|
typedef long long JSON_int_t;
|
|
#define JSON_PARSER_INTEGER_SSCANF_TOKEN "%lld"
|
|
#define JSON_PARSER_INTEGER_SPRINTF_TOKEN "%lld"
|
|
#else
|
|
typedef long JSON_int_t;
|
|
#define JSON_PARSER_INTEGER_SSCANF_TOKEN "%ld"
|
|
#define JSON_PARSER_INTEGER_SPRINTF_TOKEN "%ld"
|
|
#endif
|
|
|
|
|
|
#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;
|
|
|
|
typedef struct JSON_parser_struct* JSON_parser;
|
|
|
|
/*! \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_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 JSON_parser new_JSON_parser(JSON_config* config);
|
|
|
|
/*! \brief Destroy a previously created JSON parser object. */
|
|
JSON_PARSER_DLL_API extern void delete_JSON_parser(JSON_parser 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(JSON_parser 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(JSON_parser 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 */
|