jstools.h

Go to the documentation of this file.

#pragma once

#include "stdbool.h"
#include "stdint.h"
#include "stdio.h"

typedef struct {
   struct JST_ArrayItem_ ** items;  
   unsigned                 count;  
   struct JST_Element_ *    parent; 
} JST_Array;

extern const JST_Array JST_Array_Zero;

typedef struct {
   struct JST_Pair_ **   items;  
   unsigned              count;  
   struct JST_Element_ * parent; 
   struct JST_Pair_ *    first;  
} JST_Object;

extern const JST_Object JST_Object_Zero;

typedef union {
   JST_Object object;
   JST_Array  array;
   bool       boolean;
   int64_t    integer;
   double     dbl;
   char *     string;
} JST_Value;

extern const JST_Value JST_Value_Zero;

typedef enum {
   JST_OBJECT,
   JST_ARRAY,
   JST_BOOLEAN,
   JST_INTEGER,
   JST_DOUBLE,
   JST_STRING,
   JST_NULL,
} JST_ValueType;

typedef struct JST_Element_ {
   JST_ValueType type;
   JST_Value     value;
} JST_Element;

extern const JST_Element JST_Element_Zero;

typedef struct JST_ArrayItem_ {
   JST_Array * parent;
   JST_Element element;
} JST_ArrayItem;

extern const JST_ArrayItem JST_ArrayItem_Zero;

typedef struct JST_Pair_ {
   JST_Object *       parent;  
   JST_Element        element; 
   char *             name;    
   struct JST_Pair_ * next;    
} JST_Pair;

extern const JST_Pair JST_Pair_Zero;

typedef enum {
   JST_ERR_NONE,                                
   JST_ERR_NULL_ARGUMENT,                       
   JST_ERR_NULL_TYPE,                           
   JST_ERR_ERRNO,                               
   JST_ERR_STRING_NOT_ENDED,                    
   JST_ERR_STRING_BAD_ESCAPE_SEQUENCE,          
   JST_ERR_STRING_CONTROL_CHAR_MUST_BE_ESCAPED, 
   JST_ERR_SEPARATOR_EXPECTED_AFTER_TRUE,       
   JST_ERR_SEPARATOR_EXPECTED_AFTER_FALSE,      
   JST_ERR_SEPARATOR_EXPECTED_AFTER_NULL,       
   JST_ERR_TRUE_EXPECTED,                       
   JST_ERR_FALSE_EXPECTED,                      
   JST_ERR_NULL_EXPECTED,                       
   JST_ERR_NUMBER_EXPECTED,                     
   JST_ERR_COLON_EXPECTED,                      
   JST_ERR_UNEXPECTED_TOKEN,                    
   JST_ERR_PATH_SYNTAX,                         
   JST_ERR_NOT_FOUND,                           
   JST_ERR_ARRAY_INDEX_OUT_OF_RANGE,            
   JST_ERR_INTERRUPTED,                         
} JST_Error;

typedef bool (* JST_Visitor )( const char * name, unsigned index, bool pre, const JST_Element * element, void * user_context );

typedef struct {
   unsigned line;        
   char     context[80]; 
   unsigned pos;         
} JST_SyntaxError;

extern const JST_SyntaxError JST_SyntaxError_Zero;

JST_Error JST_load_from_file( const char * filepath, JST_Element * root, JST_SyntaxError * error );

JST_Error JST_load_from_stream( FILE * stream, JST_Element * root, JST_SyntaxError * error );

JST_Error JST_save_to_stream( FILE * stream, const JST_Element * root, unsigned indent );

JST_Error JST_save_to_file( const char * filepath, const JST_Element * root, unsigned indent );

JST_Error JST_save_to_stream_compact( FILE * stream, const JST_Element * root );

JST_Error JST_save_to_file_compact( const char * filepath, const JST_Element * root );

JST_Error JST_serialize( JST_Element * root, char ** dest, unsigned indent );

JST_Error JST_serialize_compact( JST_Element * root, char ** dest );

JST_Error JST_get( const char * jsonpath, JST_Element * root, JST_Element ** dest );

JST_Error JST_add_property( JST_Object * object, unsigned index, const char * name, const JST_Element * value );

JST_Error JST_remove_property( JST_Object * object, const char * name );

JST_Error JST_add_item( JST_Array * array, const JST_Element * value );

JST_Error JST_remove_item( JST_Array * array, unsigned index );

JST_Error JST_replace_item( JST_Array * array, unsigned index, const JST_Element * value );

JST_Error JST_walk( const JST_Element * root, JST_Visitor visitor, void * user_context );

JST_Error JST_delete_pair( JST_Pair * element );

JST_Error JST_delete_object( JST_Object * object );

JST_Error JST_delete_array_item( JST_ArrayItem * array );

JST_Error JST_delete_array( JST_Array * array );

JST_Error JST_delete_element( JST_Element * element );