#ifndef LIGHTNING_COMMON_JSON_H #define LIGHTNING_COMMON_JSON_H #include "config.h" #include #include #include #include #include #include #define JSMN_STRICT 1 # include /* Include " if it's a string. */ const char *json_tok_full(const char *buffer, const jsmntok_t *t); /* Include " if it's a string. */ int json_tok_full_len(const jsmntok_t *t); /* Is this a string equal to str? */ bool json_tok_streq(const char *buffer, const jsmntok_t *tok, const char *str); /* Allocate a tal string copy */ char *json_strdup(const tal_t *ctx, const char *buffer, const jsmntok_t *tok); /* Decode a hex-encoded binary */ u8 *json_tok_bin_from_hex(const tal_t *ctx, const char *buffer, const jsmntok_t *tok); /* Decode a hex-encoded payment preimage */ bool json_to_preimage(const char *buffer, const jsmntok_t *tok, struct preimage *preimage); /* Extract number from this (may be a string, or a number literal) */ bool json_to_number(const char *buffer, const jsmntok_t *tok, unsigned int *num); /* Extract number from this (may be a string, or a number literal) */ bool json_to_u64(const char *buffer, const jsmntok_t *tok, uint64_t *num); /* Extract number from this (may be a string, or a number literal) */ bool json_to_u32(const char *buffer, const jsmntok_t *tok, uint32_t *num); /* Extract number from this (may be a string, or a number literal) */ bool json_to_u16(const char *buffer, const jsmntok_t *tok, uint16_t *num); /* Extract double from this (must be a number literal) */ bool json_to_double(const char *buffer, const jsmntok_t *tok, double *num); /* Extract signed integer from this (may be a string, or a number literal) */ bool json_to_int(const char *buffer, const jsmntok_t *tok, int *num); /* Extract boolean from this */ bool json_to_bool(const char *buffer, const jsmntok_t *tok, bool *b); /* Extract a secret from this. */ bool json_to_secret(const char *buffer, const jsmntok_t *tok, struct secret *dest); /* Is this a number? [0..9]+ */ bool json_tok_is_num(const char *buffer, const jsmntok_t *tok); /* Is this the null primitive? */ bool json_tok_is_null(const char *buffer, const jsmntok_t *tok); /* Returns next token with same parent (WARNING: slow!). */ const jsmntok_t *json_next(const jsmntok_t *tok); /* Get top-level member. */ const jsmntok_t *json_get_member(const char *buffer, const jsmntok_t tok[], const char *label); /* Get index'th array member. */ const jsmntok_t *json_get_arr(const jsmntok_t tok[], size_t index); /* If input is complete and valid, return tokens. */ jsmntok_t *json_parse_input(const tal_t *ctx, const char *input, int len, bool *valid); /* Convert a jsmntype_t enum to a human readable string. */ const char *jsmntype_to_string(jsmntype_t t); /* Print a json value for debugging purposes. */ void json_tok_print(const char *buffer, const jsmntok_t *params); /* Return a copy of a json value as an array. */ jsmntok_t *json_tok_copy(const tal_t *ctx, const jsmntok_t *tok); /* * Remove @num json values from a json array or object @obj. @tok points * to the first value to remove. The array @tokens will be resized. */ void json_tok_remove(jsmntok_t **tokens, jsmntok_t *obj_or_array, const jsmntok_t *tok, size_t num); /* Guide is a string with . for members, [] around indexes. */ const jsmntok_t *json_delve(const char *buffer, const jsmntok_t *tok, const char *guide); /* Iterator macro for array: i is counter, t is token ptr, arr is JSMN_ARRAY */ #define json_for_each_arr(i, t, arr) \ for (i = 0, t = (arr) + 1; i < (arr)->size; t = json_next(t), i++) /* Iterator macro for object: i is counter, t is token ptr (t+1 is * contents of obj member), obj is JSMN_OBJECT */ #define json_for_each_obj(i, t, obj) \ for (i = 0, t = (obj) + 1; i < (obj)->size; t = json_next(t+1), i++) #endif /* LIGHTNING_COMMON_JSON_H */