Implemented a JSON parser.

.vscode/settings.json

@@ -1,3 +1,7 @@
 {
-    "C_Cpp.default.configurationProvider": "vector-of-bool.cmake-tools"
+    "C_Cpp.default.configurationProvider": "vector-of-bool.cmake-tools",
+    "files.associations": {
+        "inputstream.h": "c",
+        "type_traits": "c"
+    }
 }

CMakeLists.txt

@@ -56,6 +56,8 @@ set(
     ${PROJECT_SOURCE_DIR}/source/jtk/core/StringBuilder.c
     ${PROJECT_SOURCE_DIR}/source/jtk/core/System.c
 
+    ${PROJECT_SOURCE_DIR}/source/jtk/support/json.c
+
     # Input/Output Module
 
     ${PROJECT_SOURCE_DIR}/source/jtk/io/DataInputStream.c

include/jtk/support/json.h

@@ -0,0 +1,86 @@
+/*
+ * Copyright 2017-2020 Samuel Rowe
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Tuesday, June 23 2020
+
+#ifndef JTK_SUPPORT_JSON_H
+#define JTK_SUPPORT_JSON_H
+
+#include <jtk/Configuration.h>
+#include <jtk/collection/list/ArrayList.h>
+#include <jtk/collection/map/HashMap.h>
+
+struct jtk_JsonError_t {
+
+};
+
+typedef struct jtk_JsonError_t jtk_JsonError_t;
+
+enum jtk_JsonValueType_t {
+    JTK_JSON_VALUE_NULL,
+    JTK_JSON_VALUE_BOOLEAN,
+    JTK_JSON_VALUE_NUMBER,
+    JTK_JSON_VALUE_STRING,
+    JTK_JSON_VALUE_ARRAY,
+    JTK_JSON_VALUE_OBJECT
+};
+
+typedef enum jtk_JsonValueType_t jtk_JsonValueType_t;
+
+struct jtk_JsonValue_t {
+    jtk_JsonValueType_t type;
+    union {
+        bool boolean;
+        double number;
+        struct {
+            int32_t length;
+            uint8_t* bytes;
+        } string;
+        jtk_ArrayList_t* array;
+        jtk_HashMap_t* object;
+    };
+};
+
+typedef struct jtk_JsonValue_t jtk_JsonValue_t;
+
+jtk_JsonValue_t* jtk_JsonValue_forObject();
+jtk_JsonValue_t* jtk_JsonValue_forArray();
+jtk_JsonValue_t* jtk_JsonValue_forString(const uint8_t* text, int32_t length);
+jtk_JsonValue_t* jtk_JsonValue_forNumber(const uint8_t* text, int32_t length);
+jtk_JsonValue_t* jtk_JsonValue_forTrue();
+jtk_JsonValue_t* jtk_JsonValue_forFalse();
+void jtk_JsonValue_delete(jtk_JsonValue_t* value);
+
+jtk_JsonValue_t* jtk_parseJson(const uint8_t* sequence, int32_t size, jtk_JsonError_t* error);
+
+/**
+ * Sometimes you may want to generate JSON instead of parsing it. In such cases,
+ * you can manually create `jtk_JsonValue_t` objects to create your data and
+ * invoke `jtk_toJson()`. It will convert the objects to a JSON string.
+ *
+ * For example, consider in a text editor application you store all the user
+ * preferences in a JSON file. Therefore, you will load that file during application
+ * startup. The preferences will be stored in a `jtk_JsonValue_t`  object. When
+ * your user updates the preferences from your text editor, you need to save it
+ * to the JSON file. Instead of manually constructing a JSON string, you can just
+ * edit the `jtk_JsonValue_t` object you initially loaded. When the user wants
+ * to save the preferences, you simply invoke `jtk_toJson()` and get an equivalent
+ * string for the user's preferences. You can then write that string to the JSON
+ * file.
+ */
+uint8_t* jtk_toJson(jtk_JsonValue_t* value, int32_t* size, bool pretty);
+
+#endif /* JTK_SUPPORT_JSON_H */

source/jtk/collection/array/ByteArray.c

@@ -17,6 +17,7 @@
 // Tuesday, March 17, 2020
 
 #include <jtk/collection/array/ByteArray.h>
+#include <jtk/collection/array/Arrays.h>
 
 /*******************************************************************************
  * ByteArray                                                                   *

source/jtk/io/InputStreamHelper.c

@@ -19,6 +19,8 @@
 #include <jtk/core/Error.h>
 #include <jtk/core/System.h>
 #include <jtk/io/InputStreamHelper.h>
+#include <jtk/collection/array/Arrays.h>
+#include <jtk/collection/array/ByteArray.h>
 
 /*******************************************************************************
  * InputStreamHelper                                                           *