rolling back changes to objson includes. opensrf cannot find "opensrf/<blah>" since...
[OpenSRF.git] / src / objson / json_parser.h
1 /*
2 Copyright (C) 2005  Georgia Public Library Service 
3 Bill Erickson <highfalutin@gmail.com>
4
5 This program is free software; you can redistribute it and/or
6 modify it under the terms of the GNU General Public License
7 as published by the Free Software Foundation; either version 2
8 of the License, or (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 GNU General Public License for more details.
14 */
15
16
17
18
19 /* ---------------------------------------------------------------------------------------
20         JSON parser.
21  * --------------------------------------------------------------------------------------- */
22 #ifndef JSON_PARSER_H
23 #define JSON_PARSER_H
24
25 #include <stdio.h>
26 #include "object.h"
27 //#include "opensrf/utils.h"
28 #include "utils.h"
29
30
31
32 /* Parses the given JSON string and returns the built object. 
33  *      returns NULL (and prints parser error to stderr) on error.  
34  */
35
36 jsonObject* json_parse_string(char* string);
37
38 jsonObject* jsonParseString(char* string);
39 jsonObject* jsonParseStringFmt( char* string, ... );
40
41 jsonObject* json_parse_file( const char* filename );
42
43 jsonObject* jsonParseFile( const char* string );
44
45
46
47 /* does the actual parsing work.  returns 0 on success.  -1 on error and
48  * -2 if there was no object to build (string was all comments) 
49  */
50 int _json_parse_string(char* string, unsigned long* index, jsonObject* obj, int current_strlen);
51
52 /* returns 0 on success and turns obj into a string object */
53 int json_parse_json_string(char* string, unsigned long* index, jsonObject* obj, int current_strlen);
54
55 /* returns 0 on success and turns obj into a number or double object */
56 int json_parse_json_number(char* string, unsigned long* index, jsonObject* obj, int current_strlen);
57
58 /* returns 0 on success and turns obj into an 'object' object */
59 int json_parse_json_object(char* string, unsigned long* index, jsonObject* obj, int current_strlen);
60
61 /* returns 0 on success and turns object into an array object */
62 int json_parse_json_array(char* string, unsigned long* index, jsonObject* obj, int current_strlen);
63
64 /* churns through whitespace and increments index as it goes.
65  * eat_all == true means we should eat newlines, tabs
66  */
67 void json_eat_ws(char* string, unsigned long* index, int eat_all, int current_strlen);
68
69 int json_parse_json_bool(char* string, unsigned long* index, jsonObject* obj, int current_strlen);
70
71 /* removes comments from a json string.  if the comment contains a class hint
72  * and class_hint isn't NULL, an allocated char* with the class name will be
73  * shoved into *class_hint.  returns 0 on success, -1 on parse error.
74  * 'index' is assumed to be at the second character (*) of the comment
75  */
76 int json_eat_comment(char* string, unsigned long* index, char** class_hint, int parse_class, int current_strlen);
77
78 /* prints a useful error message to stderr. always returns -1 */
79 int json_handle_error(char* string, unsigned long* index, char* err_msg);
80
81 /* returns true if c is 0-9 */
82 int is_number(char c);
83
84 int json_parse_json_null(char* string, unsigned long* index, jsonObject* obj, int current_strlen);
85
86
87 #endif