base/libs/json/json.h

Go to the documentation of this file.

/***************************************************************************
 *   Copyright (C) 2007 by Rui Maciel   *
 *   rui.maciel@gmail.com   *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU Library General Public License as       *
 *   published by the Free Software Foundation; either version 2 of the    *
 *   License, or (at your option) any later version.                       *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU Library General Public     *
 *   License along with this program; if not, write to the                 *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/

#include <wchar.h>
#include <stdint.h>

#ifndef JSON_H
#define JSON_H

#ifdef __cplusplus
extern "C"
{
#endif

#define JSON_MAX_STRING_LENGTH SIZE_MAX-1

    enum json_value_type
    { JSON_STRING = 0, JSON_NUMBER, JSON_OBJECT, JSON_ARRAY, JSON_TRUE, JSON_FALSE, JSON_NULL };


    enum json_error
    {
        JSON_OK = 1,    
        JSON_INCOMPLETE_DOCUMENT,   
        JSON_WAITING_FOR_EOF,   
        JSON_MALFORMED_DOCUMENT,    /* the JSON document which was fed to this parser is malformed */
        JSON_INCOMPATIBLE_TYPE, 
        JSON_MEMORY,    
        JSON_ILLEGAL_CHARACTER, 
        JSON_BAD_TREE_STRUCTURE,    
        JSON_MAXIMUM_LENGTH,    
        JSON_UNKNOWN_PROBLEM    
    };


    struct json_value
    {
        enum json_value_type type;  
        char *text; 
        /* FIFO queue data */
        struct json_value *next;    
        struct json_value *previous;    
        struct json_value *parent;  
        struct json_value *child;   
        struct json_value *child_end;   
    };


    typedef struct json_value json_t;


    struct json_parsing_info
    {
        unsigned int state; 
        unsigned int lex_state;
        void *lex_text;
        char *p;
        int string_length_limit_reached;    
        json_t *cursor; 
    };


    struct json_saxy_functions
    {
        int (*open_object) ();
        int (*close_object) ();
        int (*open_array) ();
        int (*close_array) ();
        int (*new_string) (char * text);
        int (*new_number) (char * text);
        int (*new_true) ();
        int (*new_false) ();
        int (*new_null) ();
        int (*label_value_separator) ();
        int (*sibling_separator) ();
    };


    struct json_saxy_parser_status
    {
        unsigned int state; 
        int string_length_limit_reached;    
        void *temp; 
    };

    json_t *json_new_value (const enum json_value_type type);


    json_t *json_new_string (const char *text);


    json_t *json_new_number (const char *text);


    json_t *json_new_object (void);


    json_t *json_new_array (void);


    json_t *json_new_null (void);


    json_t *json_new_true (void);


    json_t *json_new_false (void);


    void json_free_value (json_t ** value);


    enum json_error json_insert_child (json_t * parent, json_t * child);


    enum json_error json_insert_pair_into_object (json_t * parent, const char *text_label, json_t * value);


    enum json_error json_tree_to_string (json_t * root, char **text);


/*  enum json_error json_tree_to_file (json_t * root, FILE *file); */


    void json_strip_white_spaces (char *text);


    char *json_format_string (const char *text);


    char *json_escape (char * text);


    void json_jpi_init (struct json_parsing_info *jpi);


    enum json_error json_parse_fragment (struct json_parsing_info *info, char *buffer);


    enum json_error json_parse_document (json_t **root, char *text);


    enum json_error json_saxy_parse (struct json_saxy_parser_status *jsps, struct json_saxy_functions *jsf, char c);


    json_t *json_find_first_label (const json_t * object, const char *text_label);


#ifdef __cplusplus
}
#endif
#endif

---