/usr/share/ada/adainclude/gnatcoll/gnatcoll-json.ads is in libgnatcoll1.6-dev 1.6gpl2014-9.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 | ------------------------------------------------------------------------------
-- G N A T C O L L --
-- --
-- Copyright (C) 2011-2014, AdaCore --
-- --
-- This library is free software; you can redistribute it and/or modify it --
-- under terms of the GNU General Public License as published by the Free --
-- Software Foundation; either version 3, or (at your option) any later --
-- version. This library is distributed in the hope that it will be useful, --
-- but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHAN- --
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE. --
-- --
-- --
-- --
-- --
-- --
-- You should have received a copy of the GNU General Public License and --
-- a copy of the GCC Runtime Library Exception along with this program; --
-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
-- <http://www.gnu.org/licenses/>. --
-- --
------------------------------------------------------------------------------
with Ada.Finalization;
with Ada.Strings.Unbounded;
with Ada.Unchecked_Deallocation;
private with Ada.Containers.Vectors;
package GNATCOLL.JSON is
type JSON_Value_Type is
(JSON_Null_Type,
JSON_Boolean_Type,
JSON_Int_Type,
JSON_Float_Type,
JSON_String_Type,
JSON_Array_Type,
JSON_Object_Type);
Invalid_JSON_Stream : exception;
subtype UTF8_String is String;
type UTF8_String_Access is access all UTF8_String;
subtype UTF8_Unbounded_String is Ada.Strings.Unbounded.Unbounded_String;
subtype JSON_Elementary_Value_Type is JSON_Value_Type range
JSON_Null_Type .. JSON_String_Type;
subtype JSON_Container_Value_Type is JSON_Value_Type range
JSON_Array_Type .. JSON_Object_Type;
type JSON_Value is tagged private;
type JSON_Array is private;
JSON_Null : constant JSON_Value;
Empty_Array : constant JSON_Array;
-- Array handling
function Is_Empty (Arr : JSON_Array) return Boolean;
function Length (Arr : JSON_Array) return Natural;
function Get (Arr : JSON_Array; Index : Positive) return JSON_Value;
procedure Append (Arr : in out JSON_Array; Val : JSON_Value);
procedure Prepend (Arr : in out JSON_Array; Val : JSON_Value);
procedure Clear (Arr : in out JSON_Array);
function "&" (Arr : JSON_Array; Value : JSON_Value) return JSON_Array;
function "&" (Value1, Value2 : JSON_Value) return JSON_Array;
-- Create a new array. This is lesss efficient than Append because it
-- results in an extra copy of the array, but is easier to use when
-- manipulating small arrays.
-- Read or write JSON values into strings
function Read
(Strm : Ada.Strings.Unbounded.Unbounded_String;
Filename : String := "<data>") return JSON_Value;
function Read
(Strm : String;
Filename : String := "<data>") return JSON_Value;
function Write (Item : JSON_Value; Compact : Boolean := True) return String;
function Write (Item : JSON_Value; Compact : Boolean := True)
return Ada.Strings.Unbounded.Unbounded_String;
-- Creation of JSON values
function Create return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_Null_Type);
-- Creates a 'null' JSON value
function Create (Val : Boolean) return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_Boolean_Type);
-- Creates a boolean-typed JSON value
function Create (Val : Integer) return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_Int_Type);
function Create (Val : Long_Integer) return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_Int_Type);
function Create (Val : Long_Long_Integer) return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_Int_Type);
-- Creates an integer-typed JSON value
function Create (Val : Float) return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_Float_Type);
-- Creates a float-typed JSON value
function Create (Val : UTF8_String) return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_String_Type);
-- Creates a string-typed JSON value
function Create (Val : UTF8_Unbounded_String) return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_String_Type);
-- Creates a string-typed JSON value
function Create (Val : JSON_Array) return JSON_Value;
pragma Postcondition (Kind (Create'Result) = JSON_Array_Type);
-- Creates a JSON value from the JSON array
function Create_Object return JSON_Value;
pragma Postcondition (Kind (Create_Object'Result) = JSON_Object_Type);
-- Creates an empty object. Values need to be added using the below
-- Set_Field methods
procedure Set_Field
(Val : JSON_Value;
Field_Name : UTF8_String;
Field : JSON_Value);
pragma Precondition (Kind (Val) = JSON_Object_Type);
-- Adds or modifies the named field for the specified json object, using
-- the Field value.
procedure Set_Field
(Val : JSON_Value;
Field_Name : UTF8_String;
Field : Boolean);
pragma Precondition (Kind (Val) = JSON_Object_Type);
procedure Set_Field
(Val : JSON_Value;
Field_Name : UTF8_String;
Field : Integer);
pragma Precondition (Kind (Val) = JSON_Object_Type);
procedure Set_Field
(Val : JSON_Value;
Field_Name : UTF8_String;
Field : Long_Integer);
pragma Precondition (Kind (Val) = JSON_Object_Type);
procedure Set_Field
(Val : JSON_Value;
Field_Name : UTF8_String;
Field : Float);
pragma Precondition (Kind (Val) = JSON_Object_Type);
procedure Set_Field
(Val : JSON_Value;
Field_Name : UTF8_String;
Field : UTF8_String);
pragma Precondition (Kind (Val) = JSON_Object_Type);
procedure Set_Field
(Val : JSON_Value;
Field_Name : UTF8_String;
Field : UTF8_Unbounded_String);
pragma Precondition (Kind (Val) = JSON_Object_Type);
procedure Set_Field
(Val : JSON_Value;
Field_Name : UTF8_String;
Field : JSON_Array);
pragma Precondition (Kind (Val) = JSON_Object_Type);
-- Any change you do to the array afterward will not impact Val
-- Utility functions used to translate a JSON value into an ordinary object
function Kind (Val : JSON_Value) return JSON_Value_Type;
function Get (Val : JSON_Value) return Boolean;
pragma Precondition (Kind (Val) = JSON_Boolean_Type);
function Get (Val : JSON_Value) return Integer;
pragma Precondition (Kind (Val) = JSON_Int_Type);
function Get (Val : JSON_Value) return Long_Integer;
pragma Precondition (Kind (Val) = JSON_Int_Type);
function Get (Val : JSON_Value) return Long_Long_Integer;
pragma Precondition (Kind (Val) = JSON_Int_Type);
function Get (Val : JSON_Value) return Float;
pragma Precondition (Kind (Val) = JSON_Float_Type);
function Get (Val : JSON_Value) return UTF8_String;
pragma Precondition (Kind (Val) = JSON_String_Type);
function Get (Val : JSON_Value) return UTF8_Unbounded_String;
pragma Precondition (Kind (Val) = JSON_String_Type);
function Get (Val : JSON_Value) return JSON_Array;
pragma Precondition (Kind (Val) = JSON_Array_Type);
function Has_Field (Val : JSON_Value; Field : UTF8_String) return Boolean;
pragma Precondition (Kind (Val) = JSON_Object_Type);
-- Tell whether the object val contains a field named Field
function Get (Val : JSON_Value; Field : UTF8_String) return JSON_Value;
pragma Precondition (Kind (Val) = JSON_Object_Type);
function Get (Val : JSON_Value; Field : UTF8_String) return Boolean;
pragma Precondition
(Kind (Val) = JSON_Object_Type
and then Kind (Get (Val, Field)) = JSON_Boolean_Type);
function Get (Val : JSON_Value; Field : UTF8_String) return Integer;
pragma Precondition
(Kind (Val) = JSON_Object_Type
and then Kind (Get (Val, Field)) = JSON_Int_Type);
function Get (Val : JSON_Value; Field : UTF8_String) return Long_Integer;
pragma Precondition
(Kind (Val) = JSON_Object_Type
and then Kind (Get (Val, Field)) = JSON_Int_Type);
function Get (Val : JSON_Value; Field : UTF8_String) return Float;
pragma Precondition
(Kind (Val) = JSON_Object_Type
and then Kind (Get (Val, Field)) = JSON_Float_Type);
function Get (Val : JSON_Value; Field : UTF8_String) return UTF8_String;
pragma Precondition
(Kind (Val) = JSON_Object_Type
and then Kind (Get (Val, Field)) = JSON_String_Type);
function Get
(Val : JSON_Value; Field : UTF8_String) return UTF8_Unbounded_String;
pragma Precondition
(Kind (Val) = JSON_Object_Type
and then Kind (Get (Val, Field)) = JSON_String_Type);
function Get (Val : JSON_Value; Field : UTF8_String) return JSON_Array;
pragma Precondition
(Kind (Val) = JSON_Object_Type
and then Kind (Get (Val, Field)) = JSON_Array_Type);
procedure Map_JSON_Object
(Val : JSON_Value;
CB : access procedure (Name : UTF8_String; Value : JSON_Value));
pragma Precondition (Kind (Val) = JSON_Object_Type);
-- Iterate over all fields of the object
generic
type Mapped is private;
procedure Gen_Map_JSON_Object
(Val : JSON_Value;
CB : access procedure
(User_Object : in out Mapped;
Name : UTF8_String;
Value : JSON_Value);
User_Object : in out Mapped);
private
type JSON_Array_Access is access all JSON_Array;
type JSON_Object_Internal;
type JSON_Object_Access is access all JSON_Object_Internal;
type Counter is access Natural;
type JSON_Value is new Ada.Finalization.Controlled with record
Cnt : Counter := null;
Kind : JSON_Value_Type := JSON_Null_Type;
Bool_Value : Boolean;
Int_Value : Long_Long_Integer;
Flt_Value : Float;
Str_Value : UTF8_Unbounded_String;
Arr_Value : JSON_Array_Access;
Obj_Value : JSON_Object_Access;
end record;
overriding procedure Initialize (Obj : in out JSON_Value);
overriding procedure Adjust (Obj : in out JSON_Value);
overriding procedure Finalize (Obj : in out JSON_Value);
-- JSON Array definition:
package Vect_Pkg is new Ada.Containers.Vectors
(Index_Type => Positive,
Element_Type => JSON_Value);
type JSON_Array is record
Vals : Vect_Pkg.Vector;
end record;
Empty_Array : constant JSON_Array := (Vals => Vect_Pkg.Empty_Vector);
-- JSON Object definition:
type Object_Item is record
Key : UTF8_Unbounded_String;
Val : JSON_Value;
end record;
package Object_Items_Pkg is new Ada.Containers.Vectors
(Positive, Object_Item);
type JSON_Object_Internal is record
Vals : Object_Items_Pkg.Vector;
end record;
JSON_Null : constant JSON_Value :=
(Ada.Finalization.Controlled
with Kind => JSON_Null_Type, others => <>);
-- Can't call Create, because we would need to see the body of
-- Initialize and Adjust.
procedure Free is
new Ada.Unchecked_Deallocation (JSON_Array, JSON_Array_Access);
procedure Free is
new Ada.Unchecked_Deallocation (JSON_Object_Internal, JSON_Object_Access);
procedure Free is
new Ada.Unchecked_Deallocation (Natural, Counter);
end GNATCOLL.JSON;
|