json_object.h

Go to the documentation of this file.

/*
 * $Id: json_object.h,v 1.12 2006/01/30 23:07:57 mclark Exp $
 *
 * Copyright (c) 2004, 2005 Metaparadigm Pte. Ltd.
 * Michael Clark <michael@metaparadigm.com>
 *
 * This library is free software; you can redistribute it and/or modify
 * it under the terms of the MIT license. See COPYING for details.
 *
 */

#ifndef _json_object_h_
#define _json_object_h_

#define JSON_OBJECT_DEF_HASH_ENTIRES 16

#undef FALSE
#define FALSE ((boolean)0)

#undef TRUE
#define TRUE ((boolean)1)

extern const char *json_number_chars;
extern const char *json_hex_chars;

/* forward structure definitions */

typedef int boolean;
struct printbuf;
struct lh_table;
struct array_list;
struct json_object;
struct json_object_iter;

/* supported object types */

enum json_type {
  json_type_null,
  json_type_boolean,
  json_type_double,
  json_type_int,
  json_type_object,
  json_type_array,
  json_type_string
};

/* reference counting functions */




extern struct json_object* json_object_get(struct json_object *obj);

extern void json_object_put(struct json_object *obj);


/*extern int json_object_is_type(struct json_object *obj, enum json_type type);*/
extern int json_object_is_type(struct json_object *obj, int type);

extern enum json_type json_object_get_type(struct json_object *obj);


extern const char* json_object_to_json_string(struct json_object *obj);


/* object type methods */

extern struct json_object* json_object_new_object(void);

extern struct lh_table* json_object_get_object(struct json_object *obj);

extern void json_object_object_add(struct json_object* obj, const char *key,
                                   struct json_object *val);

extern struct json_object* json_object_object_get(struct json_object* obj,
                                                  const char *key);

extern void json_object_object_del(struct json_object* obj, const char *key);

#if defined(__GNUC__) && !defined(__STRICT_ANSI__)
# define json_object_object_foreach(obj,key,val) \
 char *key; struct json_object *val; \
 for(struct lh_entry *entry = json_object_get_object(obj)->head; ({ if(entry) { key = (char*)entry->k; val = (struct json_object*)entry->v; } ; entry; }); entry = entry->next )

#else /* ANSI C or MSC */

# define json_object_object_foreach(obj,key,val) \
 char *key; struct json_object *val; struct lh_entry *entry; \
 for(entry = json_object_get_object(obj)->head; (entry ? (key = (char*)entry->k, val = (struct json_object*)entry->v, entry) : 0); entry = entry->next)

#endif /* defined(__GNUC__) && !defined(__STRICT_ANSI__) */

#define json_object_object_foreachC(obj,iter) \
 for(iter.entry = json_object_get_object(obj)->head; (iter.entry ? (iter.key = (char*)iter.entry->k, iter.val = (struct json_object*)iter.entry->v, iter.entry) : 0); iter.entry = iter.entry->next)

/* Array type methods */

extern struct json_object* json_object_new_array(void);

extern struct array_list* json_object_get_array(struct json_object *obj);

extern int json_object_array_length(struct json_object *obj);

extern int json_object_array_add(struct json_object *obj,
                                 struct json_object *val);

extern int json_object_array_put_idx(struct json_object *obj, int idx,
                                     struct json_object *val);

extern struct json_object* json_object_array_get_idx(struct json_object *obj,
                                                     int idx);

/* boolean type methods */

extern struct json_object* json_object_new_boolean(boolean b);

extern boolean json_object_get_boolean(struct json_object *obj);


/* int type methods */

extern struct json_object* json_object_new_int(int i);

extern int json_object_get_int(struct json_object *obj);


/* double type methods */

extern struct json_object* json_object_new_double(double d);

extern double json_object_get_double(struct json_object *obj);


/* string type methods */

extern struct json_object* json_object_new_string(const char *s);

extern struct json_object* json_object_new_string_len(const char *s, int len);

extern char* json_object_get_string(struct json_object *obj);

extern void json_set_float_format(const char*f);

#endif