Daily bump.
[official-gcc.git] / gcc / json.h
blobf797b990bb85851972dfcde8741578e0a89854f1
1 /* JSON trees
2 Copyright (C) 2017-2021 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
10 version.
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
15 for more details.
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/>. */
21 #ifndef GCC_JSON_H
22 #define GCC_JSON_H
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. */
33 namespace json
36 /* Forward decls of json::value and its subclasses (using indentation
37 to denote inheritance. */
39 class value;
40 class object;
41 class array;
42 class float_number;
43 class integer_number;
44 class string;
45 class literal;
47 /* An enum for discriminating the subclasses of json::value. */
49 enum kind
51 /* class json::object. */
52 JSON_OBJECT,
54 /* class json::array. */
55 JSON_ARRAY,
57 /* class json::integer_number. */
58 JSON_INTEGER,
60 /* class json::float_number. */
61 JSON_FLOAT,
63 /* class json::string. */
64 JSON_STRING,
66 /* class json::literal uses these three values to identify the
67 particular literal. */
68 JSON_TRUE,
69 JSON_FALSE,
70 JSON_NULL
73 /* Base class of JSON value. */
75 class value
77 public:
78 virtual ~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: an unordered collection of
86 key/value pairs. */
88 class object : public value
90 public:
91 ~object ();
93 enum kind get_kind () const FINAL OVERRIDE { return JSON_OBJECT; }
94 void print (pretty_printer *pp) const FINAL OVERRIDE;
96 void set (const char *key, value *v);
97 value *get (const char *key) const;
99 private:
100 typedef hash_map <char *, value *,
101 simple_hashmap_traits<nofree_string_hash, value *> > map_t;
102 map_t m_map;
105 /* Subclass of value for arrays. */
107 class array : public value
109 public:
110 ~array ();
112 enum kind get_kind () const FINAL OVERRIDE { return JSON_ARRAY; }
113 void print (pretty_printer *pp) const FINAL OVERRIDE;
115 void append (value *v);
117 private:
118 auto_vec<value *> m_elements;
121 /* Subclass of value for floating-point numbers. */
123 class float_number : public value
125 public:
126 float_number (double value) : m_value (value) {}
128 enum kind get_kind () const FINAL OVERRIDE { return JSON_FLOAT; }
129 void print (pretty_printer *pp) const FINAL OVERRIDE;
131 double get () const { return m_value; }
133 private:
134 double m_value;
137 /* Subclass of value for integer-valued numbers. */
139 class integer_number : public value
141 public:
142 integer_number (long value) : m_value (value) {}
144 enum kind get_kind () const FINAL OVERRIDE { return JSON_INTEGER; }
145 void print (pretty_printer *pp) const FINAL OVERRIDE;
147 long get () const { return m_value; }
149 private:
150 long m_value;
154 /* Subclass of value for strings. */
156 class string : public value
158 public:
159 string (const char *utf8);
160 ~string () { free (m_utf8); }
162 enum kind get_kind () const FINAL OVERRIDE { return JSON_STRING; }
163 void print (pretty_printer *pp) const FINAL OVERRIDE;
165 const char *get_string () const { return m_utf8; }
167 private:
168 char *m_utf8;
171 /* Subclass of value for the three JSON literals "true", "false",
172 and "null". */
174 class literal : public value
176 public:
177 literal (enum kind kind) : m_kind (kind) {}
179 /* Construct literal for a boolean value. */
180 literal (bool value): m_kind (value ? JSON_TRUE : JSON_FALSE) {}
182 enum kind get_kind () const FINAL OVERRIDE { return m_kind; }
183 void print (pretty_printer *pp) const FINAL OVERRIDE;
185 private:
186 enum kind m_kind;
189 } // namespace json
191 #endif /* GCC_JSON_H */