1 /* 2 Copyright (c) 2009-2017 Dave Gamble and cJSON contributors 3 4 Permission is hereby granted, free of charge, to any person obtaining a copy 5 of this software and associated documentation files (the "Software"), to deal 6 in the Software without restriction, including without limitation the rights 7 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 8 copies of the Software, and to permit persons to whom the Software is 9 furnished to do so, subject to the following conditions: 10 11 The above copyright notice and this permission notice shall be included in 12 all copies or substantial portions of the Software. 13 14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 15 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 16 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 17 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 18 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 19 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 20 THE SOFTWARE. 21 */ 22 23 #ifndef cJSON__h 24 #define cJSON__h 25 26 #ifdef __cplusplus 27 extern "C" { 28 #endif 29 30 #define CJSON_HIDE_SYMBOLS 31 32 #if !defined(__WINDOWS__) && (defined(WIN32) || defined(WIN64) || defined(_MSC_VER) || defined(_WIN32)) 33 #define __WINDOWS__ 34 #endif 35 36 #ifdef __WINDOWS__ 37 38 /* When compiling for windows, we specify a specific calling convention to avoid issues where we are being called from a project 39 with a different default calling convention. For windows you have 3 define options: 40 41 CJSON_HIDE_SYMBOLS - Define this in the case where you don't want to ever dllexport symbols 42 CJSON_EXPORT_SYMBOLS - Define this on library build when you want to dllexport symbols (default) 43 CJSON_IMPORT_SYMBOLS - Define this if you want to dllimport symbol 44 45 For *nix builds that support visibility attribute, you can define similar behavior by 46 47 setting default visibility to hidden by adding 48 -fvisibility=hidden (for gcc) 49 or 50 -xldscope=hidden (for sun cc) 51 to CFLAGS 52 53 then using the CJSON_API_VISIBILITY flag to "export" the same symbols the way CJSON_EXPORT_SYMBOLS does 54 55 */ 56 57 #define CJSON_CDECL __cdecl 58 #define CJSON_STDCALL __stdcall 59 60 /* export symbols by default, this is necessary for copy pasting the C and header file */ 61 #if !defined(CJSON_HIDE_SYMBOLS) && !defined(CJSON_IMPORT_SYMBOLS) && !defined(CJSON_EXPORT_SYMBOLS) 62 #define CJSON_EXPORT_SYMBOLS 63 #endif 64 65 #if defined(CJSON_HIDE_SYMBOLS) 66 #define CJSON_PUBLIC(type) type CJSON_STDCALL 67 #elif defined(CJSON_EXPORT_SYMBOLS) 68 #define CJSON_PUBLIC(type) __declspec(dllexport) type CJSON_STDCALL 69 #elif defined(CJSON_IMPORT_SYMBOLS) 70 #define CJSON_PUBLIC(type) __declspec(dllimport) type CJSON_STDCALL 71 #endif 72 #else /* !__WINDOWS__ */ 73 #define CJSON_CDECL 74 #define CJSON_STDCALL 75 76 #if (defined(__GNUC__) || defined(__SUNPRO_CC) || defined(__SUNPRO_C)) && defined(CJSON_API_VISIBILITY) 77 #define CJSON_PUBLIC(type) __attribute__((visibility("default"))) type 78 #else 79 #define CJSON_PUBLIC(type) type 80 #endif 81 #endif 82 83 /* project version */ 84 #define CJSON_VERSION_MAJOR 1 85 #define CJSON_VERSION_MINOR 7 86 #define CJSON_VERSION_PATCH 18 87 88 #include <stddef.h> 89 #include <stdbool.h> 90 91 #include "vk_loader_platform.h" 92 93 /* cJSON Types: */ 94 #define cJSON_Invalid (0) 95 #define cJSON_False (1 << 0) 96 #define cJSON_True (1 << 1) 97 #define cJSON_NULL (1 << 2) 98 #define cJSON_Number (1 << 3) 99 #define cJSON_String (1 << 4) 100 #define cJSON_Array (1 << 5) 101 #define cJSON_Object (1 << 6) 102 #define cJSON_Raw (1 << 7) /* raw json */ 103 104 #define cJSON_IsReference 256 105 #define cJSON_StringIsConst 512 106 107 /* loader type declarations for allocation hooks */ 108 typedef struct VkAllocationCallbacks VkAllocationCallbacks; 109 struct loader_instance; 110 111 /* The cJSON structure: */ 112 typedef struct cJSON { 113 /* next/prev allow you to walk array/object chains. Alternatively, use GetArraySize/GetArrayItem/GetObjectItem */ 114 struct cJSON *next; 115 struct cJSON *prev; 116 /* An array or object item will have a child pointer pointing to a chain of the items in the array/object. */ 117 struct cJSON *child; 118 119 /* The type of the item, as above. */ 120 int type; 121 122 /* The item's string, if type==cJSON_String and type == cJSON_Raw */ 123 char *valuestring; 124 /* writing to valueint is DEPRECATED, use cJSON_SetNumberValue instead */ 125 int valueint; 126 /* The item's number, if type==cJSON_Number */ 127 double valuedouble; 128 129 /* The item's name string, if this item is the child of, or is in the list of subitems of an object. */ 130 char *string; 131 /* pointer to the allocation callbacks to use */ 132 const VkAllocationCallbacks *pAllocator; 133 } cJSON; 134 135 typedef int cJSON_bool; 136 137 /* Limits how deeply nested arrays/objects can be before cJSON rejects to parse them. 138 * This is to prevent stack overflows. */ 139 #ifndef CJSON_NESTING_LIMIT 140 #define CJSON_NESTING_LIMIT 1000 141 #endif 142 143 /* Limits the length of circular references can be before cJSON rejects to parse them. 144 * This is to prevent stack overflows. */ 145 #ifndef CJSON_CIRCULAR_LIMIT 146 #define CJSON_CIRCULAR_LIMIT 10000 147 #endif 148 149 /* Memory Management: the caller is always responsible to free instthe results from all variants of loader_cJSON_Parse (with 150 * loader_cJSON_Delete) and loader_loader_cJSON_Print (with stdlib free, cJSON_Hooks.free_fn, or cJSON_free as appropriate). The 151 * exception is cJSON_PrintPreallocated, where the caller has full responsibility of the buffer. */ 152 /* Supply a block of JSON, and this returns a cJSON object you can interrogate. */ 153 CJSON_PUBLIC(cJSON *) loader_cJSON_Parse(const VkAllocationCallbacks *pAllocator, const char *value, bool *out_of_memory); 154 CJSON_PUBLIC(cJSON *) 155 loader_cJSON_ParseWithLength(const VkAllocationCallbacks *pAllocator, const char *value, size_t buffer_length, bool *out_of_memory); 156 /* ParseWithOpts allows you to require (and check) that the JSON is null terminated, and to retrieve the pointer to the final byte 157 * parsed. */ 158 /* If you supply a ptr in return_parse_end and parsing fails, then return_parse_end will contain a pointer to the error so will 159 * match cJSON_GetErrorPtr(). */ 160 CJSON_PUBLIC(cJSON *) 161 loader_cJSON_ParseWithOpts(const VkAllocationCallbacks *pAllocator, const char *value, const char **return_parse_end, 162 cJSON_bool require_null_terminated, bool *out_of_memory); 163 CJSON_PUBLIC(cJSON *) 164 loader_cJSON_ParseWithLengthOpts(const VkAllocationCallbacks *pAllocator, const char *value, size_t buffer_length, 165 const char **return_parse_end, cJSON_bool require_null_terminated, bool *out_of_memory); 166 167 /* Render a cJSON entity to text for transfer/storage. */ 168 TEST_FUNCTION_EXPORT CJSON_PUBLIC(char *) loader_cJSON_Print(const cJSON *item, bool *out_of_memory); 169 /* Render a cJSON entity to text for transfer/storage without any formatting. */ 170 CJSON_PUBLIC(char *) loader_cJSON_PrintUnformatted(const cJSON *item, bool *out_of_memory); 171 /* Render a cJSON entity to text using a buffered strategy. prebuffer is a guess at the final size. guessing well reduces 172 * reallocation. fmt=0 gives unformatted, =1 gives formatted */ 173 CJSON_PUBLIC(char *) 174 loader_cJSON_PrintBuffered(const cJSON *item, int prebuffer, cJSON_bool fmt, bool *out_of_memory); 175 /* Render a cJSON entity to text using a buffer already allocated in memory with given length. Returns 1 on success and 0 on 176 * failure. */ 177 /* NOTE: cJSON is not always 100% accurate in estimating how much memory it will use, so to be safe allocate 5 bytes more than you 178 * actually need */ 179 CJSON_PUBLIC(cJSON_bool) 180 loader_cJSON_PrintPreallocated(cJSON *item, char *buffer, const int length, const cJSON_bool format); 181 /* Delete a cJSON entity and all subentities. */ 182 TEST_FUNCTION_EXPORT CJSON_PUBLIC(void) loader_cJSON_Delete(cJSON *item); 183 184 /* Returns the number of items in an array (or object). */ 185 CJSON_PUBLIC(int) loader_cJSON_GetArraySize(const cJSON *array); 186 /* Retrieve item number "index" from array "array". Returns NULL if unsuccessful. */ 187 CJSON_PUBLIC(cJSON *) loader_cJSON_GetArrayItem(const cJSON *array, int index); 188 /* Get item "string" from object. Case insensitive. */ 189 CJSON_PUBLIC(cJSON *) loader_cJSON_GetObjectItem(const cJSON *const object, const char *const string); 190 CJSON_PUBLIC(cJSON *) loader_cJSON_GetObjectItemCaseSensitive(const cJSON *const object, const char *const string); 191 CJSON_PUBLIC(cJSON_bool) loader_cJSON_HasObjectItem(const cJSON *object, const char *string); 192 /* For analysing failed parses. This returns a pointer to the parse error. You'll probably need to look a few chars back to make 193 * sense of it. Defined when loader_cJSON_Parse() returns 0. 0 when loader_cJSON_Parse() succeeds. */ 194 CJSON_PUBLIC(const char *) cJSON_GetErrorPtr(void); 195 196 /* Check item type and return its value */ 197 CJSON_PUBLIC(char *) loader_cJSON_GetStringValue(const cJSON *const item); 198 CJSON_PUBLIC(double) loader_cJSON_GetNumberValue(const cJSON *const item); 199 200 /* These functions check the type of an item */ 201 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsInvalid(const cJSON *const item); 202 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsFalse(const cJSON *const item); 203 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsTrue(const cJSON *const item); 204 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsBool(const cJSON *const item); 205 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsNull(const cJSON *const item); 206 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsNumber(const cJSON *const item); 207 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsString(const cJSON *const item); 208 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsArray(const cJSON *const item); 209 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsObject(const cJSON *const item); 210 CJSON_PUBLIC(cJSON_bool) loader_cJSON_IsRaw(const cJSON *const item); 211 212 /* Macro for iterating over an array or object */ 213 #define cJSON_ArrayForEach(element, array) \ 214 for (element = (array != NULL) ? (array)->child : NULL; element != NULL; element = element->next) 215 216 #ifdef __cplusplus 217 } 218 #endif 219 220 #endif 221