2 Copyright (C) 2017-2023 Free Software Foundation, Inc.
3 Contributed by David Malcolm <dmalcolm@redhat.com>.
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 3, or (at your option) any later
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING3. If not see
19 <http://www.gnu.org/licenses/>. */
24 /* Implementation of JSON, a lightweight data-interchange format.
26 See http://www.json.org/
27 and http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf
28 and https://tools.ietf.org/html/rfc7159
30 Supports creating a DOM-like tree of json::value *, and then dumping
31 json::value * to text. */
36 /* Forward decls of json::value and its subclasses (using indentation
37 to denote inheritance. */
47 /* An enum for discriminating the subclasses of json::value. */
51 /* class json::object. */
54 /* class json::array. */
57 /* class json::integer_number. */
60 /* class json::float_number. */
63 /* class json::string. */
66 /* class json::literal uses these three values to identify the
67 particular literal. */
73 /* Base class of JSON value. */
79 virtual enum kind
get_kind () const = 0;
80 virtual void print (pretty_printer
*pp
) const = 0;
82 void dump (FILE *) const;
85 /* Subclass of value for objects: a collection of key/value pairs
86 preserving the ordering in which keys were inserted.
88 Preserving the order eliminates non-determinism in the output,
89 making it easier for the user to compare repeated invocations. */
91 class object
: public value
96 enum kind
get_kind () const final override
{ return JSON_OBJECT
; }
97 void print (pretty_printer
*pp
) const final override
;
99 void set (const char *key
, value
*v
);
100 value
*get (const char *key
) const;
103 typedef hash_map
<char *, value
*,
104 simple_hashmap_traits
<nofree_string_hash
, value
*> > map_t
;
107 /* Keep track of order in which keys were inserted. */
108 auto_vec
<const char *> m_keys
;
111 /* Subclass of value for arrays. */
113 class array
: public value
118 enum kind
get_kind () const final override
{ return JSON_ARRAY
; }
119 void print (pretty_printer
*pp
) const final override
;
121 void append (value
*v
);
124 auto_vec
<value
*> m_elements
;
127 /* Subclass of value for floating-point numbers. */
129 class float_number
: public value
132 float_number (double value
) : m_value (value
) {}
134 enum kind
get_kind () const final override
{ return JSON_FLOAT
; }
135 void print (pretty_printer
*pp
) const final override
;
137 double get () const { return m_value
; }
143 /* Subclass of value for integer-valued numbers. */
145 class integer_number
: public value
148 integer_number (long value
) : m_value (value
) {}
150 enum kind
get_kind () const final override
{ return JSON_INTEGER
; }
151 void print (pretty_printer
*pp
) const final override
;
153 long get () const { return m_value
; }
160 /* Subclass of value for strings. */
162 class string
: public value
165 explicit string (const char *utf8
);
166 string (const char *utf8
, size_t len
);
167 ~string () { free (m_utf8
); }
169 enum kind
get_kind () const final override
{ return JSON_STRING
; }
170 void print (pretty_printer
*pp
) const final override
;
172 const char *get_string () const { return m_utf8
; }
173 size_t get_length () const { return m_len
; }
180 /* Subclass of value for the three JSON literals "true", "false",
183 class literal
: public value
186 literal (enum kind kind
) : m_kind (kind
) {}
188 /* Construct literal for a boolean value. */
189 literal (bool value
): m_kind (value
? JSON_TRUE
: JSON_FALSE
) {}
191 enum kind
get_kind () const final override
{ return m_kind
; }
192 void print (pretty_printer
*pp
) const final override
;
200 #endif /* GCC_JSON_H */