Cesanta / v7 Featured

Embedded JavaScript virtual machine

Dependents:   DISCO-F469NI_javascript_blinker

v7.h@2:7762b98d31c7, 2016-10-11 (annotated)

Committer:
Marko Mikulicic
Date:
Tue Oct 11 12:22:24 2016 +0200
Revision:
2:7762b98d31c7
Parent:
0:c0ecb8bf28eb
Child:
3:2bce515c5f0b
Make v7 cpp-safe

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Marko Mikulicic 0:c0ecb8bf28eb 1 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 2 #line 1 "v7/src/license.h"
Marko Mikulicic 0:c0ecb8bf28eb 3 #endif
Marko Mikulicic 0:c0ecb8bf28eb 4 /*
Marko Mikulicic 0:c0ecb8bf28eb 5 * Copyright (c) 2013-2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 6 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 7 *
Marko Mikulicic 0:c0ecb8bf28eb 8 * This software is dual-licensed: you can redistribute it and/or modify
Marko Mikulicic 0:c0ecb8bf28eb 9 * it under the terms of the GNU General Public License version 2 as
Marko Mikulicic 0:c0ecb8bf28eb 10 * published by the Free Software Foundation. For the terms of this
Marko Mikulicic 0:c0ecb8bf28eb 11 * license, see <http://www.gnu.org/licenses/>.
Marko Mikulicic 0:c0ecb8bf28eb 12 *
Marko Mikulicic 0:c0ecb8bf28eb 13 * You are free to use this software under the terms of the GNU General
Marko Mikulicic 0:c0ecb8bf28eb 14 * Public License, but WITHOUT ANY WARRANTY; without even the implied
Marko Mikulicic 0:c0ecb8bf28eb 15 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Marko Mikulicic 0:c0ecb8bf28eb 16 * See the GNU General Public License for more details.
Marko Mikulicic 0:c0ecb8bf28eb 17 *
Marko Mikulicic 0:c0ecb8bf28eb 18 * Alternatively, you can license this software under a commercial
Marko Mikulicic 0:c0ecb8bf28eb 19 * license, as set out in <https://www.cesanta.com/license>.
Marko Mikulicic 0:c0ecb8bf28eb 20 */
Marko Mikulicic 0:c0ecb8bf28eb 21
Marko Mikulicic 0:c0ecb8bf28eb 22 #ifdef V7_EXPOSE_PRIVATE
Marko Mikulicic 0:c0ecb8bf28eb 23 #define V7_PRIVATE
Marko Mikulicic 0:c0ecb8bf28eb 24 #define V7_EXTERN extern
Marko Mikulicic 0:c0ecb8bf28eb 25 #else
Marko Mikulicic 0:c0ecb8bf28eb 26 #define V7_PRIVATE static
Marko Mikulicic 0:c0ecb8bf28eb 27 #define V7_EXTERN static
Marko Mikulicic 0:c0ecb8bf28eb 28 #endif /* CS_V7_SRC_LICENSE_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 29 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 30 #line 1 "v7/src/features_profiles.h"
Marko Mikulicic 0:c0ecb8bf28eb 31 #endif
Marko Mikulicic 0:c0ecb8bf28eb 32 /*
Marko Mikulicic 0:c0ecb8bf28eb 33 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 34 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 35 */
Marko Mikulicic 0:c0ecb8bf28eb 36
Marko Mikulicic 0:c0ecb8bf28eb 37 #ifndef CS_V7_SRC_FEATURES_PROFILES_H_
Marko Mikulicic 0:c0ecb8bf28eb 38 #define CS_V7_SRC_FEATURES_PROFILES_H_
Marko Mikulicic 0:c0ecb8bf28eb 39
Marko Mikulicic 0:c0ecb8bf28eb 40 #define V7_BUILD_PROFILE_MINIMAL 1
Marko Mikulicic 0:c0ecb8bf28eb 41 #define V7_BUILD_PROFILE_MEDIUM 2
Marko Mikulicic 0:c0ecb8bf28eb 42 #define V7_BUILD_PROFILE_FULL 3
Marko Mikulicic 0:c0ecb8bf28eb 43
Marko Mikulicic 0:c0ecb8bf28eb 44 #ifndef V7_BUILD_PROFILE
Marko Mikulicic 0:c0ecb8bf28eb 45 #define V7_BUILD_PROFILE V7_BUILD_PROFILE_FULL
Marko Mikulicic 0:c0ecb8bf28eb 46 #endif
Marko Mikulicic 0:c0ecb8bf28eb 47
Marko Mikulicic 0:c0ecb8bf28eb 48 #endif /* CS_V7_SRC_FEATURES_PROFILES_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 49 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 50 #line 1 "v7/src/features_minimal.h"
Marko Mikulicic 0:c0ecb8bf28eb 51 #endif
Marko Mikulicic 0:c0ecb8bf28eb 52 /*
Marko Mikulicic 0:c0ecb8bf28eb 53 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 54 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 55 */
Marko Mikulicic 0:c0ecb8bf28eb 56
Marko Mikulicic 0:c0ecb8bf28eb 57 /* Amalgamated: #include "v7/src/features_profiles.h" */
Marko Mikulicic 0:c0ecb8bf28eb 58
Marko Mikulicic 0:c0ecb8bf28eb 59 #if V7_BUILD_PROFILE == V7_BUILD_PROFILE_MINIMAL
Marko Mikulicic 0:c0ecb8bf28eb 60
Marko Mikulicic 0:c0ecb8bf28eb 61 /* This space is intentionally left blank. */
Marko Mikulicic 0:c0ecb8bf28eb 62
Marko Mikulicic 0:c0ecb8bf28eb 63 #endif /* CS_V7_SRC_FEATURES_MINIMAL_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 64 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 65 #line 1 "v7/src/features_medium.h"
Marko Mikulicic 0:c0ecb8bf28eb 66 #endif
Marko Mikulicic 0:c0ecb8bf28eb 67 /*
Marko Mikulicic 0:c0ecb8bf28eb 68 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 69 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 70 */
Marko Mikulicic 0:c0ecb8bf28eb 71
Marko Mikulicic 0:c0ecb8bf28eb 72 /* Amalgamated: #include "v7/src/features_profiles.h" */
Marko Mikulicic 0:c0ecb8bf28eb 73
Marko Mikulicic 0:c0ecb8bf28eb 74 #if V7_BUILD_PROFILE == V7_BUILD_PROFILE_MEDIUM
Marko Mikulicic 0:c0ecb8bf28eb 75
Marko Mikulicic 0:c0ecb8bf28eb 76 #define V7_ENABLE__Date 1
Marko Mikulicic 0:c0ecb8bf28eb 77 #define V7_ENABLE__Date__now 1
Marko Mikulicic 0:c0ecb8bf28eb 78 #define V7_ENABLE__Date__UTC 1
Marko Mikulicic 0:c0ecb8bf28eb 79 #define V7_ENABLE__Math 1
Marko Mikulicic 0:c0ecb8bf28eb 80 #define V7_ENABLE__Math__atan2 1
Marko Mikulicic 0:c0ecb8bf28eb 81 #define V7_ENABLE__RegExp 1
Marko Mikulicic 0:c0ecb8bf28eb 82
Marko Mikulicic 0:c0ecb8bf28eb 83 #endif /* CS_V7_SRC_FEATURES_MEDIUM_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 84 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 85 #line 1 "v7/src/features_full.h"
Marko Mikulicic 0:c0ecb8bf28eb 86 #endif
Marko Mikulicic 0:c0ecb8bf28eb 87 /*
Marko Mikulicic 0:c0ecb8bf28eb 88 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 89 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 90 */
Marko Mikulicic 0:c0ecb8bf28eb 91
Marko Mikulicic 0:c0ecb8bf28eb 92 #ifndef CS_V7_SRC_FEATURES_FULL_H_
Marko Mikulicic 0:c0ecb8bf28eb 93 #define CS_V7_SRC_FEATURES_FULL_H_
Marko Mikulicic 0:c0ecb8bf28eb 94
Marko Mikulicic 0:c0ecb8bf28eb 95 /* Amalgamated: #include "v7/src/features_profiles.h" */
Marko Mikulicic 0:c0ecb8bf28eb 96
Marko Mikulicic 0:c0ecb8bf28eb 97 #if V7_BUILD_PROFILE == V7_BUILD_PROFILE_FULL
Marko Mikulicic 0:c0ecb8bf28eb 98 /*
Marko Mikulicic 0:c0ecb8bf28eb 99 * DO NOT EDIT.
Marko Mikulicic 0:c0ecb8bf28eb 100 * This file is generated by scripts/gen-features-full.pl.
Marko Mikulicic 0:c0ecb8bf28eb 101 */
Marko Mikulicic 0:c0ecb8bf28eb 102 #ifndef CS_ENABLE_UTF8
Marko Mikulicic 0:c0ecb8bf28eb 103 #define CS_ENABLE_UTF8 1
Marko Mikulicic 0:c0ecb8bf28eb 104 #endif
Marko Mikulicic 0:c0ecb8bf28eb 105
Marko Mikulicic 0:c0ecb8bf28eb 106 #define V7_ENABLE__Array__reduce 1
Marko Mikulicic 0:c0ecb8bf28eb 107 #define V7_ENABLE__Blob 1
Marko Mikulicic 0:c0ecb8bf28eb 108 #define V7_ENABLE__Date 1
Marko Mikulicic 0:c0ecb8bf28eb 109 #define V7_ENABLE__Date__UTC 1
Marko Mikulicic 0:c0ecb8bf28eb 110 #define V7_ENABLE__Date__getters 1
Marko Mikulicic 0:c0ecb8bf28eb 111 #define V7_ENABLE__Date__now 1
Marko Mikulicic 0:c0ecb8bf28eb 112 #define V7_ENABLE__Date__parse 1
Marko Mikulicic 0:c0ecb8bf28eb 113 #define V7_ENABLE__Date__setters 1
Marko Mikulicic 0:c0ecb8bf28eb 114 #define V7_ENABLE__Date__toJSON 1
Marko Mikulicic 0:c0ecb8bf28eb 115 #define V7_ENABLE__Date__toLocaleString 1
Marko Mikulicic 0:c0ecb8bf28eb 116 #define V7_ENABLE__Date__toString 1
Marko Mikulicic 0:c0ecb8bf28eb 117 #define V7_ENABLE__File__list 1
Marko Mikulicic 0:c0ecb8bf28eb 118 #define V7_ENABLE__File__require 1
Marko Mikulicic 0:c0ecb8bf28eb 119 #define V7_ENABLE__Function__bind 1
Marko Mikulicic 0:c0ecb8bf28eb 120 #define V7_ENABLE__Function__call 1
Marko Mikulicic 0:c0ecb8bf28eb 121 #define V7_ENABLE__Math 1
Marko Mikulicic 0:c0ecb8bf28eb 122 #define V7_ENABLE__Math__abs 1
Marko Mikulicic 0:c0ecb8bf28eb 123 #define V7_ENABLE__Math__acos 1
Marko Mikulicic 0:c0ecb8bf28eb 124 #define V7_ENABLE__Math__asin 1
Marko Mikulicic 0:c0ecb8bf28eb 125 #define V7_ENABLE__Math__atan 1
Marko Mikulicic 0:c0ecb8bf28eb 126 #define V7_ENABLE__Math__atan2 1
Marko Mikulicic 0:c0ecb8bf28eb 127 #define V7_ENABLE__Math__ceil 1
Marko Mikulicic 0:c0ecb8bf28eb 128 #define V7_ENABLE__Math__constants 1
Marko Mikulicic 0:c0ecb8bf28eb 129 #define V7_ENABLE__Math__cos 1
Marko Mikulicic 0:c0ecb8bf28eb 130 #define V7_ENABLE__Math__exp 1
Marko Mikulicic 0:c0ecb8bf28eb 131 #define V7_ENABLE__Math__floor 1
Marko Mikulicic 0:c0ecb8bf28eb 132 #define V7_ENABLE__Math__log 1
Marko Mikulicic 0:c0ecb8bf28eb 133 #define V7_ENABLE__Math__max 1
Marko Mikulicic 0:c0ecb8bf28eb 134 #define V7_ENABLE__Math__min 1
Marko Mikulicic 0:c0ecb8bf28eb 135 #define V7_ENABLE__Math__pow 1
Marko Mikulicic 0:c0ecb8bf28eb 136 #define V7_ENABLE__Math__random 1
Marko Mikulicic 0:c0ecb8bf28eb 137 #define V7_ENABLE__Math__round 1
Marko Mikulicic 0:c0ecb8bf28eb 138 #define V7_ENABLE__Math__sin 1
Marko Mikulicic 0:c0ecb8bf28eb 139 #define V7_ENABLE__Math__sqrt 1
Marko Mikulicic 0:c0ecb8bf28eb 140 #define V7_ENABLE__Math__tan 1
Marko Mikulicic 0:c0ecb8bf28eb 141 #define V7_ENABLE__Memory__stats 1
Marko Mikulicic 0:c0ecb8bf28eb 142 #define V7_ENABLE__NUMBER__NEGATIVE_INFINITY 1
Marko Mikulicic 0:c0ecb8bf28eb 143 #define V7_ENABLE__NUMBER__POSITIVE_INFINITY 1
Marko Mikulicic 0:c0ecb8bf28eb 144 #define V7_ENABLE__Object__create 1
Marko Mikulicic 0:c0ecb8bf28eb 145 #define V7_ENABLE__Object__defineProperties 1
Marko Mikulicic 0:c0ecb8bf28eb 146 #define V7_ENABLE__Object__getOwnPropertyDescriptor 1
Marko Mikulicic 0:c0ecb8bf28eb 147 #define V7_ENABLE__Object__getOwnPropertyNames 1
Marko Mikulicic 0:c0ecb8bf28eb 148 #define V7_ENABLE__Object__getPrototypeOf 1
Marko Mikulicic 0:c0ecb8bf28eb 149 #define V7_ENABLE__Object__hasOwnProperty 1
Marko Mikulicic 0:c0ecb8bf28eb 150 #define V7_ENABLE__Object__isExtensible 1
Marko Mikulicic 0:c0ecb8bf28eb 151 #define V7_ENABLE__Object__isFrozen 1
Marko Mikulicic 0:c0ecb8bf28eb 152 #define V7_ENABLE__Object__isPrototypeOf 1
Marko Mikulicic 0:c0ecb8bf28eb 153 #define V7_ENABLE__Object__isSealed 1
Marko Mikulicic 0:c0ecb8bf28eb 154 #define V7_ENABLE__Object__keys 1
Marko Mikulicic 0:c0ecb8bf28eb 155 #define V7_ENABLE__Object__preventExtensions 1
Marko Mikulicic 0:c0ecb8bf28eb 156 #define V7_ENABLE__Object__propertyIsEnumerable 1
Marko Mikulicic 0:c0ecb8bf28eb 157 #define V7_ENABLE__Proxy 1
Marko Mikulicic 0:c0ecb8bf28eb 158 #define V7_ENABLE__RegExp 1
Marko Mikulicic 0:c0ecb8bf28eb 159 #define V7_ENABLE__StackTrace 1
Marko Mikulicic 0:c0ecb8bf28eb 160 #define V7_ENABLE__String__localeCompare 1
Marko Mikulicic 0:c0ecb8bf28eb 161 #define V7_ENABLE__String__localeLowerCase 1
Marko Mikulicic 0:c0ecb8bf28eb 162 #define V7_ENABLE__String__localeUpperCase 1
Marko Mikulicic 0:c0ecb8bf28eb 163
Marko Mikulicic 0:c0ecb8bf28eb 164 #endif /* V7_BUILD_PROFILE == V7_BUILD_PROFILE_FULL */
Marko Mikulicic 0:c0ecb8bf28eb 165
Marko Mikulicic 0:c0ecb8bf28eb 166 #endif /* CS_V7_SRC_FEATURES_FULL_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 167 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 168 #line 1 "v7/src/v7_features.h"
Marko Mikulicic 0:c0ecb8bf28eb 169 #endif
Marko Mikulicic 0:c0ecb8bf28eb 170 /*
Marko Mikulicic 0:c0ecb8bf28eb 171 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 172 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 173 */
Marko Mikulicic 0:c0ecb8bf28eb 174
Marko Mikulicic 0:c0ecb8bf28eb 175 #ifndef CS_V7_SRC_V7_FEATURES_H_
Marko Mikulicic 0:c0ecb8bf28eb 176 #define CS_V7_SRC_V7_FEATURES_H_
Marko Mikulicic 0:c0ecb8bf28eb 177
Marko Mikulicic 0:c0ecb8bf28eb 178 /* Only one will actually be used based on V7_BUILD_PROFILE. */
Marko Mikulicic 0:c0ecb8bf28eb 179 /* Amalgamated: #include "v7/src/features_minimal.h" */
Marko Mikulicic 0:c0ecb8bf28eb 180 /* Amalgamated: #include "v7/src/features_medium.h" */
Marko Mikulicic 0:c0ecb8bf28eb 181 /* Amalgamated: #include "v7/src/features_full.h" */
Marko Mikulicic 0:c0ecb8bf28eb 182
Marko Mikulicic 0:c0ecb8bf28eb 183 #endif /* CS_V7_SRC_V7_FEATURES_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 184 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 185 #line 1 "v7/src/core_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 186 #endif
Marko Mikulicic 0:c0ecb8bf28eb 187 /*
Marko Mikulicic 0:c0ecb8bf28eb 188 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 189 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 190 */
Marko Mikulicic 0:c0ecb8bf28eb 191
Marko Mikulicic 0:c0ecb8bf28eb 192 /*
Marko Mikulicic 0:c0ecb8bf28eb 193 * === Core
Marko Mikulicic 0:c0ecb8bf28eb 194 */
Marko Mikulicic 0:c0ecb8bf28eb 195
Marko Mikulicic 0:c0ecb8bf28eb 196 #ifndef CS_V7_SRC_CORE_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 197 #define CS_V7_SRC_CORE_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 198
Marko Mikulicic 0:c0ecb8bf28eb 199 #ifndef _POSIX_C_SOURCE
Marko Mikulicic 0:c0ecb8bf28eb 200 #define _POSIX_C_SOURCE 200809L
Marko Mikulicic 0:c0ecb8bf28eb 201 #endif
Marko Mikulicic 0:c0ecb8bf28eb 202
Marko Mikulicic 0:c0ecb8bf28eb 203 /* Amalgamated: #include "v7/src/license.h" */
Marko Mikulicic 0:c0ecb8bf28eb 204 /* Amalgamated: #include "v7/src/v7_features.h" */
Marko Mikulicic 0:c0ecb8bf28eb 205
Marko Mikulicic 0:c0ecb8bf28eb 206 #include <stddef.h> /* For size_t */
Marko Mikulicic 0:c0ecb8bf28eb 207 #include <stdio.h> /* For FILE */
Marko Mikulicic 0:c0ecb8bf28eb 208
Marko Mikulicic 2:7762b98d31c7 209 #if defined(__cplusplus)
Marko Mikulicic 2:7762b98d31c7 210 extern "C" {
Marko Mikulicic 2:7762b98d31c7 211 #endif /* __cplusplus */
Marko Mikulicic 2:7762b98d31c7 212
Marko Mikulicic 0:c0ecb8bf28eb 213 /*
Marko Mikulicic 0:c0ecb8bf28eb 214 * TODO(dfrank) : improve amalgamation, so that we'll be able to include
Marko Mikulicic 0:c0ecb8bf28eb 215 * files here, and include common/platform.h
Marko Mikulicic 0:c0ecb8bf28eb 216 *
Marko Mikulicic 0:c0ecb8bf28eb 217 * For now, copy-pasting `WARN_UNUSED_RESULT` here
Marko Mikulicic 0:c0ecb8bf28eb 218 */
Marko Mikulicic 0:c0ecb8bf28eb 219 #ifdef __GNUC__
Marko Mikulicic 0:c0ecb8bf28eb 220 #define WARN_UNUSED_RESULT __attribute__((warn_unused_result))
Marko Mikulicic 0:c0ecb8bf28eb 221 #define NOINSTR __attribute__((no_instrument_function))
Marko Mikulicic 0:c0ecb8bf28eb 222 #else
Marko Mikulicic 0:c0ecb8bf28eb 223 #define WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 224 #define NOINSTR
Marko Mikulicic 0:c0ecb8bf28eb 225 #endif
Marko Mikulicic 0:c0ecb8bf28eb 226
Marko Mikulicic 0:c0ecb8bf28eb 227 #define V7_VERSION "1.0"
Marko Mikulicic 0:c0ecb8bf28eb 228
Marko Mikulicic 0:c0ecb8bf28eb 229 #if (defined(_WIN32) && !defined(__MINGW32__) && !defined(__MINGW64__)) || \
Marko Mikulicic 0:c0ecb8bf28eb 230 (defined(_MSC_VER) && _MSC_VER <= 1200)
Marko Mikulicic 0:c0ecb8bf28eb 231 #define V7_WINDOWS
Marko Mikulicic 0:c0ecb8bf28eb 232 #endif
Marko Mikulicic 0:c0ecb8bf28eb 233
Marko Mikulicic 0:c0ecb8bf28eb 234 #ifdef V7_WINDOWS
Marko Mikulicic 0:c0ecb8bf28eb 235 typedef unsigned __int64 uint64_t;
Marko Mikulicic 0:c0ecb8bf28eb 236 #else
Marko Mikulicic 0:c0ecb8bf28eb 237 #include <inttypes.h>
Marko Mikulicic 0:c0ecb8bf28eb 238 #endif
Marko Mikulicic 0:c0ecb8bf28eb 239 /* 64-bit value, used to store JS values */
Marko Mikulicic 0:c0ecb8bf28eb 240 typedef uint64_t v7_val_t;
Marko Mikulicic 0:c0ecb8bf28eb 241
Marko Mikulicic 0:c0ecb8bf28eb 242 /* JavaScript `null` value */
Marko Mikulicic 0:c0ecb8bf28eb 243 #define V7_NULL ((uint64_t) 0xfffe << 48)
Marko Mikulicic 0:c0ecb8bf28eb 244
Marko Mikulicic 0:c0ecb8bf28eb 245 /* JavaScript `undefined` value */
Marko Mikulicic 0:c0ecb8bf28eb 246 #define V7_UNDEFINED ((uint64_t) 0xfffd << 48)
Marko Mikulicic 0:c0ecb8bf28eb 247
Marko Mikulicic 0:c0ecb8bf28eb 248 /* This if-0 is a dirty workaround to force etags to pick `struct v7` */
Marko Mikulicic 0:c0ecb8bf28eb 249 #if 0
Marko Mikulicic 0:c0ecb8bf28eb 250 /* Opaque structure. V7 engine context. */
Marko Mikulicic 0:c0ecb8bf28eb 251 struct v7 {
Marko Mikulicic 0:c0ecb8bf28eb 252 /* ... */
Marko Mikulicic 0:c0ecb8bf28eb 253 };
Marko Mikulicic 0:c0ecb8bf28eb 254 #endif
Marko Mikulicic 0:c0ecb8bf28eb 255
Marko Mikulicic 0:c0ecb8bf28eb 256 struct v7;
Marko Mikulicic 0:c0ecb8bf28eb 257
Marko Mikulicic 0:c0ecb8bf28eb 258 /*
Marko Mikulicic 0:c0ecb8bf28eb 259 * Code which is returned by some of the v7 functions. If something other than
Marko Mikulicic 0:c0ecb8bf28eb 260 * `V7_OK` is returned from some function, the caller function typically should
Marko Mikulicic 0:c0ecb8bf28eb 261 * either immediately cleanup and return the code further, or handle the error.
Marko Mikulicic 0:c0ecb8bf28eb 262 */
Marko Mikulicic 0:c0ecb8bf28eb 263 enum v7_err {
Marko Mikulicic 0:c0ecb8bf28eb 264 V7_OK,
Marko Mikulicic 0:c0ecb8bf28eb 265 V7_SYNTAX_ERROR,
Marko Mikulicic 0:c0ecb8bf28eb 266 V7_EXEC_EXCEPTION,
Marko Mikulicic 0:c0ecb8bf28eb 267 V7_AST_TOO_LARGE,
Marko Mikulicic 0:c0ecb8bf28eb 268 V7_INTERNAL_ERROR,
Marko Mikulicic 0:c0ecb8bf28eb 269 };
Marko Mikulicic 0:c0ecb8bf28eb 270
Marko Mikulicic 0:c0ecb8bf28eb 271 /* JavaScript -> C call interface */
Marko Mikulicic 0:c0ecb8bf28eb 272 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 273 typedef enum v7_err(v7_cfunction_t)(struct v7 *v7, v7_val_t *res);
Marko Mikulicic 0:c0ecb8bf28eb 274
Marko Mikulicic 0:c0ecb8bf28eb 275 /* Create V7 instance */
Marko Mikulicic 0:c0ecb8bf28eb 276 struct v7 *v7_create(void);
Marko Mikulicic 0:c0ecb8bf28eb 277
Marko Mikulicic 0:c0ecb8bf28eb 278 /*
Marko Mikulicic 0:c0ecb8bf28eb 279 * Customizations of initial V7 state; used by `v7_create_opt()`.
Marko Mikulicic 0:c0ecb8bf28eb 280 */
Marko Mikulicic 0:c0ecb8bf28eb 281 struct v7_create_opts {
Marko Mikulicic 0:c0ecb8bf28eb 282 size_t object_arena_size;
Marko Mikulicic 0:c0ecb8bf28eb 283 size_t function_arena_size;
Marko Mikulicic 0:c0ecb8bf28eb 284 size_t property_arena_size;
Marko Mikulicic 0:c0ecb8bf28eb 285 #ifdef V7_STACK_SIZE
Marko Mikulicic 0:c0ecb8bf28eb 286 void *c_stack_base;
Marko Mikulicic 0:c0ecb8bf28eb 287 #endif
Marko Mikulicic 0:c0ecb8bf28eb 288 #ifdef V7_FREEZE
Marko Mikulicic 0:c0ecb8bf28eb 289 /* if not NULL, dump JS heap after init */
Marko Mikulicic 0:c0ecb8bf28eb 290 char *freeze_file;
Marko Mikulicic 0:c0ecb8bf28eb 291 #endif
Marko Mikulicic 0:c0ecb8bf28eb 292 };
Marko Mikulicic 0:c0ecb8bf28eb 293
Marko Mikulicic 0:c0ecb8bf28eb 294 /*
Marko Mikulicic 0:c0ecb8bf28eb 295 * Like `v7_create()`, but allows to customize initial v7 state, see `struct
Marko Mikulicic 0:c0ecb8bf28eb 296 * v7_create_opts`.
Marko Mikulicic 0:c0ecb8bf28eb 297 */
Marko Mikulicic 0:c0ecb8bf28eb 298 struct v7 *v7_create_opt(struct v7_create_opts opts);
Marko Mikulicic 0:c0ecb8bf28eb 299
Marko Mikulicic 0:c0ecb8bf28eb 300 /* Destroy V7 instance */
Marko Mikulicic 0:c0ecb8bf28eb 301 void v7_destroy(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 302
Marko Mikulicic 0:c0ecb8bf28eb 303 /* Return root level (`global`) object of the given V7 instance. */
Marko Mikulicic 0:c0ecb8bf28eb 304 v7_val_t v7_get_global(struct v7 *v);
Marko Mikulicic 0:c0ecb8bf28eb 305
Marko Mikulicic 0:c0ecb8bf28eb 306 /* Return current `this` object. */
Marko Mikulicic 0:c0ecb8bf28eb 307 v7_val_t v7_get_this(struct v7 *v);
Marko Mikulicic 0:c0ecb8bf28eb 308
Marko Mikulicic 0:c0ecb8bf28eb 309 /* Return current `arguments` array */
Marko Mikulicic 0:c0ecb8bf28eb 310 v7_val_t v7_get_arguments(struct v7 *v);
Marko Mikulicic 0:c0ecb8bf28eb 311
Marko Mikulicic 0:c0ecb8bf28eb 312 /* Return i-th argument */
Marko Mikulicic 0:c0ecb8bf28eb 313 v7_val_t v7_arg(struct v7 *v, unsigned long i);
Marko Mikulicic 0:c0ecb8bf28eb 314
Marko Mikulicic 0:c0ecb8bf28eb 315 /* Return the length of `arguments` */
Marko Mikulicic 0:c0ecb8bf28eb 316 unsigned long v7_argc(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 317
Marko Mikulicic 0:c0ecb8bf28eb 318 /*
Marko Mikulicic 0:c0ecb8bf28eb 319 * Tells the GC about a JS value variable/field owned
Marko Mikulicic 0:c0ecb8bf28eb 320 * by C code.
Marko Mikulicic 0:c0ecb8bf28eb 321 *
Marko Mikulicic 0:c0ecb8bf28eb 322 * User C code should own v7_val_t variables
Marko Mikulicic 0:c0ecb8bf28eb 323 * if the value's lifetime crosses any invocation
Marko Mikulicic 0:c0ecb8bf28eb 324 * to the v7 runtime that creates new objects or new
Marko Mikulicic 0:c0ecb8bf28eb 325 * properties and thus can potentially trigger GC.
Marko Mikulicic 0:c0ecb8bf28eb 326 *
Marko Mikulicic 0:c0ecb8bf28eb 327 * The registration of the variable prevents the GC from mistakenly treat
Marko Mikulicic 0:c0ecb8bf28eb 328 * the object as garbage. The GC might be triggered potentially
Marko Mikulicic 0:c0ecb8bf28eb 329 * allows the GC to update pointers
Marko Mikulicic 0:c0ecb8bf28eb 330 *
Marko Mikulicic 0:c0ecb8bf28eb 331 * User code should also explicitly disown the variables with v7_disown once
Marko Mikulicic 0:c0ecb8bf28eb 332 * it goes out of scope or the structure containing the v7_val_t field is freed.
Marko Mikulicic 0:c0ecb8bf28eb 333 *
Marko Mikulicic 0:c0ecb8bf28eb 334 * Example:
Marko Mikulicic 0:c0ecb8bf28eb 335 *
Marko Mikulicic 0:c0ecb8bf28eb 336 * ```
Marko Mikulicic 0:c0ecb8bf28eb 337 * struct v7_val cb;
Marko Mikulicic 0:c0ecb8bf28eb 338 * v7_own(v7, &cb);
Marko Mikulicic 0:c0ecb8bf28eb 339 * cb = v7_array_get(v7, args, 0);
Marko Mikulicic 0:c0ecb8bf28eb 340 * // do something with cb
Marko Mikulicic 0:c0ecb8bf28eb 341 * v7_disown(v7, &cb);
Marko Mikulicic 0:c0ecb8bf28eb 342 * ```
Marko Mikulicic 0:c0ecb8bf28eb 343 */
Marko Mikulicic 0:c0ecb8bf28eb 344 void v7_own(struct v7 *v7, v7_val_t *v);
Marko Mikulicic 0:c0ecb8bf28eb 345
Marko Mikulicic 0:c0ecb8bf28eb 346 /*
Marko Mikulicic 0:c0ecb8bf28eb 347 * Returns 1 if value is found, 0 otherwise
Marko Mikulicic 0:c0ecb8bf28eb 348 */
Marko Mikulicic 0:c0ecb8bf28eb 349 int v7_disown(struct v7 *v7, v7_val_t *v);
Marko Mikulicic 0:c0ecb8bf28eb 350
Marko Mikulicic 0:c0ecb8bf28eb 351 /*
Marko Mikulicic 0:c0ecb8bf28eb 352 * Enable or disable GC.
Marko Mikulicic 0:c0ecb8bf28eb 353 *
Marko Mikulicic 0:c0ecb8bf28eb 354 * Must be called before invoking v7_exec or v7_apply
Marko Mikulicic 0:c0ecb8bf28eb 355 * from within a cfunction unless you know what you're doing.
Marko Mikulicic 0:c0ecb8bf28eb 356 *
Marko Mikulicic 0:c0ecb8bf28eb 357 * GC is disabled during execution of cfunctions in order to simplify
Marko Mikulicic 0:c0ecb8bf28eb 358 * memory management of simple cfunctions.
Marko Mikulicic 0:c0ecb8bf28eb 359 * However executing even small snippets of JS code causes a lot of memory
Marko Mikulicic 0:c0ecb8bf28eb 360 * pressure. Enabling GC solves that but forces you to take care of the
Marko Mikulicic 0:c0ecb8bf28eb 361 * reachability of your temporary V7 v7_val_t variables, as the GC needs
Marko Mikulicic 0:c0ecb8bf28eb 362 * to know where they are since objects and strings can be either reclaimed
Marko Mikulicic 0:c0ecb8bf28eb 363 * or relocated during a GC pass.
Marko Mikulicic 0:c0ecb8bf28eb 364 */
Marko Mikulicic 0:c0ecb8bf28eb 365 void v7_set_gc_enabled(struct v7 *v7, int enabled);
Marko Mikulicic 0:c0ecb8bf28eb 366
Marko Mikulicic 0:c0ecb8bf28eb 367 /*
Marko Mikulicic 0:c0ecb8bf28eb 368 * Set an optional C stack limit.
Marko Mikulicic 0:c0ecb8bf28eb 369 *
Marko Mikulicic 0:c0ecb8bf28eb 370 * It sets a flag that will cause the interpreter
Marko Mikulicic 0:c0ecb8bf28eb 371 * to throw an InterruptedError.
Marko Mikulicic 0:c0ecb8bf28eb 372 * It's safe to call it from signal handlers and ISRs
Marko Mikulicic 0:c0ecb8bf28eb 373 * on single threaded environments.
Marko Mikulicic 0:c0ecb8bf28eb 374 */
Marko Mikulicic 0:c0ecb8bf28eb 375 void v7_interrupt(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 376
Marko Mikulicic 0:c0ecb8bf28eb 377 /* Returns last parser error message. TODO: rename it to `v7_get_error()` */
Marko Mikulicic 0:c0ecb8bf28eb 378 const char *v7_get_parser_error(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 379
Marko Mikulicic 0:c0ecb8bf28eb 380 #if defined(V7_ENABLE_STACK_TRACKING)
Marko Mikulicic 0:c0ecb8bf28eb 381 /*
Marko Mikulicic 0:c0ecb8bf28eb 382 * Available if only `V7_ENABLE_STACK_TRACKING` is defined.
Marko Mikulicic 0:c0ecb8bf28eb 383 *
Marko Mikulicic 0:c0ecb8bf28eb 384 * Stack metric id. See `v7_stack_stat()`
Marko Mikulicic 0:c0ecb8bf28eb 385 */
Marko Mikulicic 0:c0ecb8bf28eb 386 enum v7_stack_stat_what {
Marko Mikulicic 0:c0ecb8bf28eb 387 /* max stack size consumed by `i_exec()` */
Marko Mikulicic 0:c0ecb8bf28eb 388 V7_STACK_STAT_EXEC,
Marko Mikulicic 0:c0ecb8bf28eb 389 /* max stack size consumed by `parse()` (which is called from `i_exec()`) */
Marko Mikulicic 0:c0ecb8bf28eb 390 V7_STACK_STAT_PARSER,
Marko Mikulicic 0:c0ecb8bf28eb 391
Marko Mikulicic 0:c0ecb8bf28eb 392 V7_STACK_STATS_CNT
Marko Mikulicic 0:c0ecb8bf28eb 393 };
Marko Mikulicic 0:c0ecb8bf28eb 394
Marko Mikulicic 0:c0ecb8bf28eb 395 /*
Marko Mikulicic 0:c0ecb8bf28eb 396 * Available if only `V7_ENABLE_STACK_TRACKING` is defined.
Marko Mikulicic 0:c0ecb8bf28eb 397 *
Marko Mikulicic 0:c0ecb8bf28eb 398 * Returns stack metric specified by the metric id `what`. See
Marko Mikulicic 0:c0ecb8bf28eb 399 * `v7_stack_stat_clean()`
Marko Mikulicic 0:c0ecb8bf28eb 400 */
Marko Mikulicic 0:c0ecb8bf28eb 401 int v7_stack_stat(struct v7 *v7, enum v7_stack_stat_what what);
Marko Mikulicic 0:c0ecb8bf28eb 402
Marko Mikulicic 0:c0ecb8bf28eb 403 /*
Marko Mikulicic 0:c0ecb8bf28eb 404 * Available if only `V7_ENABLE_STACK_TRACKING` is defined.
Marko Mikulicic 0:c0ecb8bf28eb 405 *
Marko Mikulicic 0:c0ecb8bf28eb 406 * Clean all stack statistics gathered so far. See `v7_stack_stat()`
Marko Mikulicic 0:c0ecb8bf28eb 407 */
Marko Mikulicic 0:c0ecb8bf28eb 408 void v7_stack_stat_clean(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 409 #endif
Marko Mikulicic 0:c0ecb8bf28eb 410
Marko Mikulicic 2:7762b98d31c7 411 #if defined(__cplusplus)
Marko Mikulicic 2:7762b98d31c7 412 }
Marko Mikulicic 2:7762b98d31c7 413 #endif /* __cplusplus */
Marko Mikulicic 2:7762b98d31c7 414
Marko Mikulicic 0:c0ecb8bf28eb 415 #endif /* CS_V7_SRC_CORE_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 416 #ifndef V7_EXPORT_INTERNAL_HEADERS
Marko Mikulicic 0:c0ecb8bf28eb 417 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 418 #line 1 "v7/src/core_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 419 #endif
Marko Mikulicic 0:c0ecb8bf28eb 420 /*
Marko Mikulicic 0:c0ecb8bf28eb 421 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 422 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 423 */
Marko Mikulicic 0:c0ecb8bf28eb 424
Marko Mikulicic 0:c0ecb8bf28eb 425 /*
Marko Mikulicic 0:c0ecb8bf28eb 426 * === Core
Marko Mikulicic 0:c0ecb8bf28eb 427 */
Marko Mikulicic 0:c0ecb8bf28eb 428
Marko Mikulicic 0:c0ecb8bf28eb 429 #ifndef CS_V7_SRC_CORE_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 430 #define CS_V7_SRC_CORE_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 431
Marko Mikulicic 0:c0ecb8bf28eb 432 #ifndef _POSIX_C_SOURCE
Marko Mikulicic 0:c0ecb8bf28eb 433 #define _POSIX_C_SOURCE 200809L
Marko Mikulicic 0:c0ecb8bf28eb 434 #endif
Marko Mikulicic 0:c0ecb8bf28eb 435
Marko Mikulicic 0:c0ecb8bf28eb 436 /* Amalgamated: #include "v7/src/license.h" */
Marko Mikulicic 0:c0ecb8bf28eb 437 /* Amalgamated: #include "v7/src/v7_features.h" */
Marko Mikulicic 0:c0ecb8bf28eb 438
Marko Mikulicic 0:c0ecb8bf28eb 439 #include <stddef.h> /* For size_t */
Marko Mikulicic 0:c0ecb8bf28eb 440 #include <stdio.h> /* For FILE */
Marko Mikulicic 0:c0ecb8bf28eb 441
Marko Mikulicic 2:7762b98d31c7 442 #if defined(__cplusplus)
Marko Mikulicic 2:7762b98d31c7 443 extern "C" {
Marko Mikulicic 2:7762b98d31c7 444 #endif /* __cplusplus */
Marko Mikulicic 2:7762b98d31c7 445
Marko Mikulicic 0:c0ecb8bf28eb 446 /*
Marko Mikulicic 0:c0ecb8bf28eb 447 * TODO(dfrank) : improve amalgamation, so that we'll be able to include
Marko Mikulicic 0:c0ecb8bf28eb 448 * files here, and include common/platform.h
Marko Mikulicic 0:c0ecb8bf28eb 449 *
Marko Mikulicic 0:c0ecb8bf28eb 450 * For now, copy-pasting `WARN_UNUSED_RESULT` here
Marko Mikulicic 0:c0ecb8bf28eb 451 */
Marko Mikulicic 0:c0ecb8bf28eb 452 #ifdef __GNUC__
Marko Mikulicic 0:c0ecb8bf28eb 453 #define WARN_UNUSED_RESULT __attribute__((warn_unused_result))
Marko Mikulicic 0:c0ecb8bf28eb 454 #define NOINSTR __attribute__((no_instrument_function))
Marko Mikulicic 0:c0ecb8bf28eb 455 #else
Marko Mikulicic 0:c0ecb8bf28eb 456 #define WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 457 #define NOINSTR
Marko Mikulicic 0:c0ecb8bf28eb 458 #endif
Marko Mikulicic 0:c0ecb8bf28eb 459
Marko Mikulicic 0:c0ecb8bf28eb 460 #define V7_VERSION "1.0"
Marko Mikulicic 0:c0ecb8bf28eb 461
Marko Mikulicic 0:c0ecb8bf28eb 462 #if (defined(_WIN32) && !defined(__MINGW32__) && !defined(__MINGW64__)) || \
Marko Mikulicic 0:c0ecb8bf28eb 463 (defined(_MSC_VER) && _MSC_VER <= 1200)
Marko Mikulicic 0:c0ecb8bf28eb 464 #define V7_WINDOWS
Marko Mikulicic 0:c0ecb8bf28eb 465 #endif
Marko Mikulicic 0:c0ecb8bf28eb 466
Marko Mikulicic 0:c0ecb8bf28eb 467 #ifdef V7_WINDOWS
Marko Mikulicic 0:c0ecb8bf28eb 468 typedef unsigned __int64 uint64_t;
Marko Mikulicic 0:c0ecb8bf28eb 469 #else
Marko Mikulicic 0:c0ecb8bf28eb 470 #include <inttypes.h>
Marko Mikulicic 0:c0ecb8bf28eb 471 #endif
Marko Mikulicic 0:c0ecb8bf28eb 472 /* 64-bit value, used to store JS values */
Marko Mikulicic 0:c0ecb8bf28eb 473 typedef uint64_t v7_val_t;
Marko Mikulicic 0:c0ecb8bf28eb 474
Marko Mikulicic 0:c0ecb8bf28eb 475 /* JavaScript `null` value */
Marko Mikulicic 0:c0ecb8bf28eb 476 #define V7_NULL ((uint64_t) 0xfffe << 48)
Marko Mikulicic 0:c0ecb8bf28eb 477
Marko Mikulicic 0:c0ecb8bf28eb 478 /* JavaScript `undefined` value */
Marko Mikulicic 0:c0ecb8bf28eb 479 #define V7_UNDEFINED ((uint64_t) 0xfffd << 48)
Marko Mikulicic 0:c0ecb8bf28eb 480
Marko Mikulicic 0:c0ecb8bf28eb 481 /* This if-0 is a dirty workaround to force etags to pick `struct v7` */
Marko Mikulicic 0:c0ecb8bf28eb 482 #if 0
Marko Mikulicic 0:c0ecb8bf28eb 483 /* Opaque structure. V7 engine context. */
Marko Mikulicic 0:c0ecb8bf28eb 484 struct v7 {
Marko Mikulicic 0:c0ecb8bf28eb 485 /* ... */
Marko Mikulicic 0:c0ecb8bf28eb 486 };
Marko Mikulicic 0:c0ecb8bf28eb 487 #endif
Marko Mikulicic 0:c0ecb8bf28eb 488
Marko Mikulicic 0:c0ecb8bf28eb 489 struct v7;
Marko Mikulicic 0:c0ecb8bf28eb 490
Marko Mikulicic 0:c0ecb8bf28eb 491 /*
Marko Mikulicic 0:c0ecb8bf28eb 492 * Code which is returned by some of the v7 functions. If something other than
Marko Mikulicic 0:c0ecb8bf28eb 493 * `V7_OK` is returned from some function, the caller function typically should
Marko Mikulicic 0:c0ecb8bf28eb 494 * either immediately cleanup and return the code further, or handle the error.
Marko Mikulicic 0:c0ecb8bf28eb 495 */
Marko Mikulicic 0:c0ecb8bf28eb 496 enum v7_err {
Marko Mikulicic 0:c0ecb8bf28eb 497 V7_OK,
Marko Mikulicic 0:c0ecb8bf28eb 498 V7_SYNTAX_ERROR,
Marko Mikulicic 0:c0ecb8bf28eb 499 V7_EXEC_EXCEPTION,
Marko Mikulicic 0:c0ecb8bf28eb 500 V7_AST_TOO_LARGE,
Marko Mikulicic 0:c0ecb8bf28eb 501 V7_INTERNAL_ERROR,
Marko Mikulicic 0:c0ecb8bf28eb 502 };
Marko Mikulicic 0:c0ecb8bf28eb 503
Marko Mikulicic 0:c0ecb8bf28eb 504 /* JavaScript -> C call interface */
Marko Mikulicic 0:c0ecb8bf28eb 505 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 506 typedef enum v7_err(v7_cfunction_t)(struct v7 *v7, v7_val_t *res);
Marko Mikulicic 0:c0ecb8bf28eb 507
Marko Mikulicic 0:c0ecb8bf28eb 508 /* Create V7 instance */
Marko Mikulicic 0:c0ecb8bf28eb 509 struct v7 *v7_create(void);
Marko Mikulicic 0:c0ecb8bf28eb 510
Marko Mikulicic 0:c0ecb8bf28eb 511 /*
Marko Mikulicic 0:c0ecb8bf28eb 512 * Customizations of initial V7 state; used by `v7_create_opt()`.
Marko Mikulicic 0:c0ecb8bf28eb 513 */
Marko Mikulicic 0:c0ecb8bf28eb 514 struct v7_create_opts {
Marko Mikulicic 0:c0ecb8bf28eb 515 size_t object_arena_size;
Marko Mikulicic 0:c0ecb8bf28eb 516 size_t function_arena_size;
Marko Mikulicic 0:c0ecb8bf28eb 517 size_t property_arena_size;
Marko Mikulicic 0:c0ecb8bf28eb 518 #ifdef V7_STACK_SIZE
Marko Mikulicic 0:c0ecb8bf28eb 519 void *c_stack_base;
Marko Mikulicic 0:c0ecb8bf28eb 520 #endif
Marko Mikulicic 0:c0ecb8bf28eb 521 #ifdef V7_FREEZE
Marko Mikulicic 0:c0ecb8bf28eb 522 /* if not NULL, dump JS heap after init */
Marko Mikulicic 0:c0ecb8bf28eb 523 char *freeze_file;
Marko Mikulicic 0:c0ecb8bf28eb 524 #endif
Marko Mikulicic 0:c0ecb8bf28eb 525 };
Marko Mikulicic 0:c0ecb8bf28eb 526
Marko Mikulicic 0:c0ecb8bf28eb 527 /*
Marko Mikulicic 0:c0ecb8bf28eb 528 * Like `v7_create()`, but allows to customize initial v7 state, see `struct
Marko Mikulicic 0:c0ecb8bf28eb 529 * v7_create_opts`.
Marko Mikulicic 0:c0ecb8bf28eb 530 */
Marko Mikulicic 0:c0ecb8bf28eb 531 struct v7 *v7_create_opt(struct v7_create_opts opts);
Marko Mikulicic 0:c0ecb8bf28eb 532
Marko Mikulicic 0:c0ecb8bf28eb 533 /* Destroy V7 instance */
Marko Mikulicic 0:c0ecb8bf28eb 534 void v7_destroy(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 535
Marko Mikulicic 0:c0ecb8bf28eb 536 /* Return root level (`global`) object of the given V7 instance. */
Marko Mikulicic 0:c0ecb8bf28eb 537 v7_val_t v7_get_global(struct v7 *v);
Marko Mikulicic 0:c0ecb8bf28eb 538
Marko Mikulicic 0:c0ecb8bf28eb 539 /* Return current `this` object. */
Marko Mikulicic 0:c0ecb8bf28eb 540 v7_val_t v7_get_this(struct v7 *v);
Marko Mikulicic 0:c0ecb8bf28eb 541
Marko Mikulicic 0:c0ecb8bf28eb 542 /* Return current `arguments` array */
Marko Mikulicic 0:c0ecb8bf28eb 543 v7_val_t v7_get_arguments(struct v7 *v);
Marko Mikulicic 0:c0ecb8bf28eb 544
Marko Mikulicic 0:c0ecb8bf28eb 545 /* Return i-th argument */
Marko Mikulicic 0:c0ecb8bf28eb 546 v7_val_t v7_arg(struct v7 *v, unsigned long i);
Marko Mikulicic 0:c0ecb8bf28eb 547
Marko Mikulicic 0:c0ecb8bf28eb 548 /* Return the length of `arguments` */
Marko Mikulicic 0:c0ecb8bf28eb 549 unsigned long v7_argc(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 550
Marko Mikulicic 0:c0ecb8bf28eb 551 /*
Marko Mikulicic 0:c0ecb8bf28eb 552 * Tells the GC about a JS value variable/field owned
Marko Mikulicic 0:c0ecb8bf28eb 553 * by C code.
Marko Mikulicic 0:c0ecb8bf28eb 554 *
Marko Mikulicic 0:c0ecb8bf28eb 555 * User C code should own v7_val_t variables
Marko Mikulicic 0:c0ecb8bf28eb 556 * if the value's lifetime crosses any invocation
Marko Mikulicic 0:c0ecb8bf28eb 557 * to the v7 runtime that creates new objects or new
Marko Mikulicic 0:c0ecb8bf28eb 558 * properties and thus can potentially trigger GC.
Marko Mikulicic 0:c0ecb8bf28eb 559 *
Marko Mikulicic 0:c0ecb8bf28eb 560 * The registration of the variable prevents the GC from mistakenly treat
Marko Mikulicic 0:c0ecb8bf28eb 561 * the object as garbage. The GC might be triggered potentially
Marko Mikulicic 0:c0ecb8bf28eb 562 * allows the GC to update pointers
Marko Mikulicic 0:c0ecb8bf28eb 563 *
Marko Mikulicic 0:c0ecb8bf28eb 564 * User code should also explicitly disown the variables with v7_disown once
Marko Mikulicic 0:c0ecb8bf28eb 565 * it goes out of scope or the structure containing the v7_val_t field is freed.
Marko Mikulicic 0:c0ecb8bf28eb 566 *
Marko Mikulicic 0:c0ecb8bf28eb 567 * Example:
Marko Mikulicic 0:c0ecb8bf28eb 568 *
Marko Mikulicic 0:c0ecb8bf28eb 569 * ```
Marko Mikulicic 0:c0ecb8bf28eb 570 * struct v7_val cb;
Marko Mikulicic 0:c0ecb8bf28eb 571 * v7_own(v7, &cb);
Marko Mikulicic 0:c0ecb8bf28eb 572 * cb = v7_array_get(v7, args, 0);
Marko Mikulicic 0:c0ecb8bf28eb 573 * // do something with cb
Marko Mikulicic 0:c0ecb8bf28eb 574 * v7_disown(v7, &cb);
Marko Mikulicic 0:c0ecb8bf28eb 575 * ```
Marko Mikulicic 0:c0ecb8bf28eb 576 */
Marko Mikulicic 0:c0ecb8bf28eb 577 void v7_own(struct v7 *v7, v7_val_t *v);
Marko Mikulicic 0:c0ecb8bf28eb 578
Marko Mikulicic 0:c0ecb8bf28eb 579 /*
Marko Mikulicic 0:c0ecb8bf28eb 580 * Returns 1 if value is found, 0 otherwise
Marko Mikulicic 0:c0ecb8bf28eb 581 */
Marko Mikulicic 0:c0ecb8bf28eb 582 int v7_disown(struct v7 *v7, v7_val_t *v);
Marko Mikulicic 0:c0ecb8bf28eb 583
Marko Mikulicic 0:c0ecb8bf28eb 584 /*
Marko Mikulicic 0:c0ecb8bf28eb 585 * Enable or disable GC.
Marko Mikulicic 0:c0ecb8bf28eb 586 *
Marko Mikulicic 0:c0ecb8bf28eb 587 * Must be called before invoking v7_exec or v7_apply
Marko Mikulicic 0:c0ecb8bf28eb 588 * from within a cfunction unless you know what you're doing.
Marko Mikulicic 0:c0ecb8bf28eb 589 *
Marko Mikulicic 0:c0ecb8bf28eb 590 * GC is disabled during execution of cfunctions in order to simplify
Marko Mikulicic 0:c0ecb8bf28eb 591 * memory management of simple cfunctions.
Marko Mikulicic 0:c0ecb8bf28eb 592 * However executing even small snippets of JS code causes a lot of memory
Marko Mikulicic 0:c0ecb8bf28eb 593 * pressure. Enabling GC solves that but forces you to take care of the
Marko Mikulicic 0:c0ecb8bf28eb 594 * reachability of your temporary V7 v7_val_t variables, as the GC needs
Marko Mikulicic 0:c0ecb8bf28eb 595 * to know where they are since objects and strings can be either reclaimed
Marko Mikulicic 0:c0ecb8bf28eb 596 * or relocated during a GC pass.
Marko Mikulicic 0:c0ecb8bf28eb 597 */
Marko Mikulicic 0:c0ecb8bf28eb 598 void v7_set_gc_enabled(struct v7 *v7, int enabled);
Marko Mikulicic 0:c0ecb8bf28eb 599
Marko Mikulicic 0:c0ecb8bf28eb 600 /*
Marko Mikulicic 0:c0ecb8bf28eb 601 * Set an optional C stack limit.
Marko Mikulicic 0:c0ecb8bf28eb 602 *
Marko Mikulicic 0:c0ecb8bf28eb 603 * It sets a flag that will cause the interpreter
Marko Mikulicic 0:c0ecb8bf28eb 604 * to throw an InterruptedError.
Marko Mikulicic 0:c0ecb8bf28eb 605 * It's safe to call it from signal handlers and ISRs
Marko Mikulicic 0:c0ecb8bf28eb 606 * on single threaded environments.
Marko Mikulicic 0:c0ecb8bf28eb 607 */
Marko Mikulicic 0:c0ecb8bf28eb 608 void v7_interrupt(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 609
Marko Mikulicic 0:c0ecb8bf28eb 610 /* Returns last parser error message. TODO: rename it to `v7_get_error()` */
Marko Mikulicic 0:c0ecb8bf28eb 611 const char *v7_get_parser_error(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 612
Marko Mikulicic 0:c0ecb8bf28eb 613 #if defined(V7_ENABLE_STACK_TRACKING)
Marko Mikulicic 0:c0ecb8bf28eb 614 /*
Marko Mikulicic 0:c0ecb8bf28eb 615 * Available if only `V7_ENABLE_STACK_TRACKING` is defined.
Marko Mikulicic 0:c0ecb8bf28eb 616 *
Marko Mikulicic 0:c0ecb8bf28eb 617 * Stack metric id. See `v7_stack_stat()`
Marko Mikulicic 0:c0ecb8bf28eb 618 */
Marko Mikulicic 0:c0ecb8bf28eb 619 enum v7_stack_stat_what {
Marko Mikulicic 0:c0ecb8bf28eb 620 /* max stack size consumed by `i_exec()` */
Marko Mikulicic 0:c0ecb8bf28eb 621 V7_STACK_STAT_EXEC,
Marko Mikulicic 0:c0ecb8bf28eb 622 /* max stack size consumed by `parse()` (which is called from `i_exec()`) */
Marko Mikulicic 0:c0ecb8bf28eb 623 V7_STACK_STAT_PARSER,
Marko Mikulicic 0:c0ecb8bf28eb 624
Marko Mikulicic 0:c0ecb8bf28eb 625 V7_STACK_STATS_CNT
Marko Mikulicic 0:c0ecb8bf28eb 626 };
Marko Mikulicic 0:c0ecb8bf28eb 627
Marko Mikulicic 0:c0ecb8bf28eb 628 /*
Marko Mikulicic 0:c0ecb8bf28eb 629 * Available if only `V7_ENABLE_STACK_TRACKING` is defined.
Marko Mikulicic 0:c0ecb8bf28eb 630 *
Marko Mikulicic 0:c0ecb8bf28eb 631 * Returns stack metric specified by the metric id `what`. See
Marko Mikulicic 0:c0ecb8bf28eb 632 * `v7_stack_stat_clean()`
Marko Mikulicic 0:c0ecb8bf28eb 633 */
Marko Mikulicic 0:c0ecb8bf28eb 634 int v7_stack_stat(struct v7 *v7, enum v7_stack_stat_what what);
Marko Mikulicic 0:c0ecb8bf28eb 635
Marko Mikulicic 0:c0ecb8bf28eb 636 /*
Marko Mikulicic 0:c0ecb8bf28eb 637 * Available if only `V7_ENABLE_STACK_TRACKING` is defined.
Marko Mikulicic 0:c0ecb8bf28eb 638 *
Marko Mikulicic 0:c0ecb8bf28eb 639 * Clean all stack statistics gathered so far. See `v7_stack_stat()`
Marko Mikulicic 0:c0ecb8bf28eb 640 */
Marko Mikulicic 0:c0ecb8bf28eb 641 void v7_stack_stat_clean(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 642 #endif
Marko Mikulicic 0:c0ecb8bf28eb 643
Marko Mikulicic 2:7762b98d31c7 644 #if defined(__cplusplus)
Marko Mikulicic 2:7762b98d31c7 645 }
Marko Mikulicic 2:7762b98d31c7 646 #endif /* __cplusplus */
Marko Mikulicic 2:7762b98d31c7 647
Marko Mikulicic 0:c0ecb8bf28eb 648 #endif /* CS_V7_SRC_CORE_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 649 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 650 #line 1 "v7/src/primitive_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 651 #endif
Marko Mikulicic 0:c0ecb8bf28eb 652 /*
Marko Mikulicic 0:c0ecb8bf28eb 653 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 654 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 655 */
Marko Mikulicic 0:c0ecb8bf28eb 656
Marko Mikulicic 0:c0ecb8bf28eb 657 /*
Marko Mikulicic 0:c0ecb8bf28eb 658 * === Primitives
Marko Mikulicic 0:c0ecb8bf28eb 659 *
Marko Mikulicic 0:c0ecb8bf28eb 660 * All primitive values but strings.
Marko Mikulicic 0:c0ecb8bf28eb 661 *
Marko Mikulicic 0:c0ecb8bf28eb 662 * "foreign" values are also here, see `v7_mk_foreign()`.
Marko Mikulicic 0:c0ecb8bf28eb 663 */
Marko Mikulicic 0:c0ecb8bf28eb 664
Marko Mikulicic 0:c0ecb8bf28eb 665 #ifndef CS_V7_SRC_PRIMITIVE_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 666 #define CS_V7_SRC_PRIMITIVE_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 667
Marko Mikulicic 0:c0ecb8bf28eb 668 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 669
Marko Mikulicic 0:c0ecb8bf28eb 670 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 671 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 672 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 673
Marko Mikulicic 0:c0ecb8bf28eb 674 /* Make numeric primitive value */
Marko Mikulicic 0:c0ecb8bf28eb 675 NOINSTR v7_val_t v7_mk_number(struct v7 *v7, double num);
Marko Mikulicic 0:c0ecb8bf28eb 676
Marko Mikulicic 0:c0ecb8bf28eb 677 /*
Marko Mikulicic 0:c0ecb8bf28eb 678 * Returns number value stored in `v7_val_t` as `double`.
Marko Mikulicic 0:c0ecb8bf28eb 679 *
Marko Mikulicic 0:c0ecb8bf28eb 680 * Returns NaN for non-numbers.
Marko Mikulicic 0:c0ecb8bf28eb 681 */
Marko Mikulicic 0:c0ecb8bf28eb 682 NOINSTR double v7_get_double(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 683
Marko Mikulicic 0:c0ecb8bf28eb 684 /*
Marko Mikulicic 0:c0ecb8bf28eb 685 * Returns number value stored in `v7_val_t` as `int`. If the number value is
Marko Mikulicic 0:c0ecb8bf28eb 686 * not an integer, the fraction part will be discarded.
Marko Mikulicic 0:c0ecb8bf28eb 687 *
Marko Mikulicic 0:c0ecb8bf28eb 688 * If the given value is a non-number, or NaN, the result is undefined.
Marko Mikulicic 0:c0ecb8bf28eb 689 */
Marko Mikulicic 0:c0ecb8bf28eb 690 NOINSTR int v7_get_int(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 691
Marko Mikulicic 0:c0ecb8bf28eb 692 /* Returns true if given value is a primitive number value */
Marko Mikulicic 0:c0ecb8bf28eb 693 int v7_is_number(v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 694
Marko Mikulicic 0:c0ecb8bf28eb 695 /* Make boolean primitive value (either `true` or `false`) */
Marko Mikulicic 0:c0ecb8bf28eb 696 NOINSTR v7_val_t v7_mk_boolean(struct v7 *v7, int is_true);
Marko Mikulicic 0:c0ecb8bf28eb 697
Marko Mikulicic 0:c0ecb8bf28eb 698 /*
Marko Mikulicic 0:c0ecb8bf28eb 699 * Returns boolean stored in `v7_val_t`:
Marko Mikulicic 0:c0ecb8bf28eb 700 * 0 for `false` or non-boolean, non-0 for `true`
Marko Mikulicic 0:c0ecb8bf28eb 701 */
Marko Mikulicic 0:c0ecb8bf28eb 702 NOINSTR int v7_get_bool(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 703
Marko Mikulicic 0:c0ecb8bf28eb 704 /* Returns true if given value is a primitive boolean value */
Marko Mikulicic 0:c0ecb8bf28eb 705 int v7_is_boolean(v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 706
Marko Mikulicic 0:c0ecb8bf28eb 707 /*
Marko Mikulicic 0:c0ecb8bf28eb 708 * Make `null` primitive value.
Marko Mikulicic 0:c0ecb8bf28eb 709 *
Marko Mikulicic 0:c0ecb8bf28eb 710 * NOTE: this function is deprecated and will be removed in future releases.
Marko Mikulicic 0:c0ecb8bf28eb 711 * Use `V7_NULL` instead.
Marko Mikulicic 0:c0ecb8bf28eb 712 */
Marko Mikulicic 0:c0ecb8bf28eb 713 NOINSTR v7_val_t v7_mk_null(void);
Marko Mikulicic 0:c0ecb8bf28eb 714
Marko Mikulicic 0:c0ecb8bf28eb 715 /* Returns true if given value is a primitive `null` value */
Marko Mikulicic 0:c0ecb8bf28eb 716 int v7_is_null(v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 717
Marko Mikulicic 0:c0ecb8bf28eb 718 /*
Marko Mikulicic 0:c0ecb8bf28eb 719 * Make `undefined` primitive value.
Marko Mikulicic 0:c0ecb8bf28eb 720 *
Marko Mikulicic 0:c0ecb8bf28eb 721 * NOTE: this function is deprecated and will be removed in future releases.
Marko Mikulicic 0:c0ecb8bf28eb 722 * Use `V7_UNDEFINED` instead.
Marko Mikulicic 0:c0ecb8bf28eb 723 */
Marko Mikulicic 0:c0ecb8bf28eb 724 NOINSTR v7_val_t v7_mk_undefined(void);
Marko Mikulicic 0:c0ecb8bf28eb 725
Marko Mikulicic 0:c0ecb8bf28eb 726 /* Returns true if given value is a primitive `undefined` value */
Marko Mikulicic 0:c0ecb8bf28eb 727 int v7_is_undefined(v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 728
Marko Mikulicic 0:c0ecb8bf28eb 729 /*
Marko Mikulicic 0:c0ecb8bf28eb 730 * Make JavaScript value that holds C/C++ `void *` pointer.
Marko Mikulicic 0:c0ecb8bf28eb 731 *
Marko Mikulicic 0:c0ecb8bf28eb 732 * A foreign value is completely opaque and JS code cannot do anything useful
Marko Mikulicic 0:c0ecb8bf28eb 733 * with it except holding it in properties and passing it around.
Marko Mikulicic 0:c0ecb8bf28eb 734 * It behaves like a sealed object with no properties.
Marko Mikulicic 0:c0ecb8bf28eb 735 *
Marko Mikulicic 0:c0ecb8bf28eb 736 * NOTE:
Marko Mikulicic 0:c0ecb8bf28eb 737 * Only valid pointers (as defined by each supported architecture) will fully
Marko Mikulicic 0:c0ecb8bf28eb 738 * preserved. In particular, all supported 64-bit architectures (x86_64, ARM-64)
Marko Mikulicic 0:c0ecb8bf28eb 739 * actually define a 48-bit virtual address space.
Marko Mikulicic 0:c0ecb8bf28eb 740 * Foreign values will be sign-extended as required, i.e creating a foreign
Marko Mikulicic 0:c0ecb8bf28eb 741 * value of something like `(void *) -1` will work as expected. This is
Marko Mikulicic 0:c0ecb8bf28eb 742 * important because in some 64-bit OSs (e.g. Solaris) the user stack grows
Marko Mikulicic 0:c0ecb8bf28eb 743 * downwards from the end of the address space.
Marko Mikulicic 0:c0ecb8bf28eb 744 *
Marko Mikulicic 0:c0ecb8bf28eb 745 * If you need to store exactly sizeof(void*) bytes of raw data where
Marko Mikulicic 0:c0ecb8bf28eb 746 * `sizeof(void*)` >= 8, please use byte arrays instead.
Marko Mikulicic 0:c0ecb8bf28eb 747 */
Marko Mikulicic 0:c0ecb8bf28eb 748 NOINSTR v7_val_t v7_mk_foreign(struct v7 *v7, void *ptr);
Marko Mikulicic 0:c0ecb8bf28eb 749
Marko Mikulicic 0:c0ecb8bf28eb 750 /*
Marko Mikulicic 0:c0ecb8bf28eb 751 * Returns `void *` pointer stored in `v7_val_t`.
Marko Mikulicic 0:c0ecb8bf28eb 752 *
Marko Mikulicic 0:c0ecb8bf28eb 753 * Returns NULL if the value is not a foreign pointer.
Marko Mikulicic 0:c0ecb8bf28eb 754 */
Marko Mikulicic 0:c0ecb8bf28eb 755 NOINSTR void *v7_get_ptr(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 756
Marko Mikulicic 0:c0ecb8bf28eb 757 /* Returns true if given value holds `void *` pointer */
Marko Mikulicic 0:c0ecb8bf28eb 758 int v7_is_foreign(v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 759
Marko Mikulicic 0:c0ecb8bf28eb 760 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 761 }
Marko Mikulicic 0:c0ecb8bf28eb 762 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 763
Marko Mikulicic 0:c0ecb8bf28eb 764 #endif /* CS_V7_SRC_PRIMITIVE_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 765 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 766 #line 1 "v7/src/string_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 767 #endif
Marko Mikulicic 0:c0ecb8bf28eb 768 /*
Marko Mikulicic 0:c0ecb8bf28eb 769 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 770 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 771 */
Marko Mikulicic 0:c0ecb8bf28eb 772
Marko Mikulicic 0:c0ecb8bf28eb 773 /*
Marko Mikulicic 0:c0ecb8bf28eb 774 * === Strings
Marko Mikulicic 0:c0ecb8bf28eb 775 */
Marko Mikulicic 0:c0ecb8bf28eb 776
Marko Mikulicic 0:c0ecb8bf28eb 777 #ifndef CS_V7_SRC_STRING_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 778 #define CS_V7_SRC_STRING_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 779
Marko Mikulicic 0:c0ecb8bf28eb 780 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 781
Marko Mikulicic 0:c0ecb8bf28eb 782 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 783 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 784 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 785
Marko Mikulicic 0:c0ecb8bf28eb 786 /*
Marko Mikulicic 0:c0ecb8bf28eb 787 * Creates a string primitive value.
Marko Mikulicic 0:c0ecb8bf28eb 788 * `str` must point to the utf8 string of length `len`.
Marko Mikulicic 0:c0ecb8bf28eb 789 * If `len` is ~0, `str` is assumed to be NUL-terminated and `strlen(str)` is
Marko Mikulicic 0:c0ecb8bf28eb 790 * used.
Marko Mikulicic 0:c0ecb8bf28eb 791 *
Marko Mikulicic 0:c0ecb8bf28eb 792 * If `copy` is non-zero, the string data is copied and owned by the GC. The
Marko Mikulicic 0:c0ecb8bf28eb 793 * caller can free the string data afterwards. Otherwise (`copy` is zero), the
Marko Mikulicic 0:c0ecb8bf28eb 794 * caller owns the string data, and is responsible for not freeing it while it
Marko Mikulicic 0:c0ecb8bf28eb 795 * is used.
Marko Mikulicic 0:c0ecb8bf28eb 796 */
Marko Mikulicic 0:c0ecb8bf28eb 797 v7_val_t v7_mk_string(struct v7 *v7, const char *str, size_t len, int copy);
Marko Mikulicic 0:c0ecb8bf28eb 798
Marko Mikulicic 0:c0ecb8bf28eb 799 /* Returns true if given value is a primitive string value */
Marko Mikulicic 0:c0ecb8bf28eb 800 int v7_is_string(v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 801
Marko Mikulicic 0:c0ecb8bf28eb 802 /*
Marko Mikulicic 0:c0ecb8bf28eb 803 * Returns a pointer to the string stored in `v7_val_t`.
Marko Mikulicic 0:c0ecb8bf28eb 804 *
Marko Mikulicic 0:c0ecb8bf28eb 805 * String length returned in `len`, which is allowed to be NULL. Returns NULL
Marko Mikulicic 0:c0ecb8bf28eb 806 * if the value is not a string.
Marko Mikulicic 0:c0ecb8bf28eb 807 *
Marko Mikulicic 0:c0ecb8bf28eb 808 * JS strings can contain embedded NUL chars and may or may not be NUL
Marko Mikulicic 0:c0ecb8bf28eb 809 * terminated.
Marko Mikulicic 0:c0ecb8bf28eb 810 *
Marko Mikulicic 0:c0ecb8bf28eb 811 * CAUTION: creating new JavaScript object, array, or string may kick in a
Marko Mikulicic 0:c0ecb8bf28eb 812 * garbage collector, which in turn may relocate string data and invalidate
Marko Mikulicic 0:c0ecb8bf28eb 813 * pointer returned by `v7_get_string()`.
Marko Mikulicic 0:c0ecb8bf28eb 814 *
Marko Mikulicic 0:c0ecb8bf28eb 815 * Short JS strings are embedded inside the `v7_val_t` value itself. This is why
Marko Mikulicic 0:c0ecb8bf28eb 816 * a pointer to a `v7_val_t` is required. It also means that the string data
Marko Mikulicic 0:c0ecb8bf28eb 817 * will become invalid once that `v7_val_t` value goes out of scope.
Marko Mikulicic 0:c0ecb8bf28eb 818 */
Marko Mikulicic 0:c0ecb8bf28eb 819 const char *v7_get_string(struct v7 *v7, v7_val_t *v, size_t *len);
Marko Mikulicic 0:c0ecb8bf28eb 820
Marko Mikulicic 0:c0ecb8bf28eb 821 /*
Marko Mikulicic 0:c0ecb8bf28eb 822 * Returns a pointer to the string stored in `v7_val_t`.
Marko Mikulicic 0:c0ecb8bf28eb 823 *
Marko Mikulicic 0:c0ecb8bf28eb 824 * Returns NULL if the value is not a string or if the string is not compatible
Marko Mikulicic 0:c0ecb8bf28eb 825 * with a C string.
Marko Mikulicic 0:c0ecb8bf28eb 826 *
Marko Mikulicic 0:c0ecb8bf28eb 827 * C compatible strings contain exactly one NUL char, in terminal position.
Marko Mikulicic 0:c0ecb8bf28eb 828 *
Marko Mikulicic 0:c0ecb8bf28eb 829 * All strings owned by the V7 engine (see `v7_mk_string()`) are guaranteed to
Marko Mikulicic 0:c0ecb8bf28eb 830 * be NUL terminated. Out of these, those that don't include embedded NUL chars
Marko Mikulicic 0:c0ecb8bf28eb 831 * are guaranteed to be C compatible.
Marko Mikulicic 0:c0ecb8bf28eb 832 */
Marko Mikulicic 0:c0ecb8bf28eb 833 const char *v7_get_cstring(struct v7 *v7, v7_val_t *v);
Marko Mikulicic 0:c0ecb8bf28eb 834
Marko Mikulicic 0:c0ecb8bf28eb 835 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 836 }
Marko Mikulicic 0:c0ecb8bf28eb 837 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 838
Marko Mikulicic 0:c0ecb8bf28eb 839 #endif /* CS_V7_SRC_STRING_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 840 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 841 #line 1 "v7/src/object_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 842 #endif
Marko Mikulicic 0:c0ecb8bf28eb 843 /*
Marko Mikulicic 0:c0ecb8bf28eb 844 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 845 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 846 */
Marko Mikulicic 0:c0ecb8bf28eb 847
Marko Mikulicic 0:c0ecb8bf28eb 848 /*
Marko Mikulicic 0:c0ecb8bf28eb 849 * === Objects
Marko Mikulicic 0:c0ecb8bf28eb 850 */
Marko Mikulicic 0:c0ecb8bf28eb 851
Marko Mikulicic 0:c0ecb8bf28eb 852 #ifndef CS_V7_SRC_OBJECT_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 853 #define CS_V7_SRC_OBJECT_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 854
Marko Mikulicic 0:c0ecb8bf28eb 855 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 856
Marko Mikulicic 0:c0ecb8bf28eb 857 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 858 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 859 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 860
Marko Mikulicic 0:c0ecb8bf28eb 861 /*
Marko Mikulicic 0:c0ecb8bf28eb 862 * Property attributes bitmask
Marko Mikulicic 0:c0ecb8bf28eb 863 */
Marko Mikulicic 0:c0ecb8bf28eb 864 typedef unsigned short v7_prop_attr_t;
Marko Mikulicic 0:c0ecb8bf28eb 865 #define V7_PROPERTY_NON_WRITABLE (1 << 0)
Marko Mikulicic 0:c0ecb8bf28eb 866 #define V7_PROPERTY_NON_ENUMERABLE (1 << 1)
Marko Mikulicic 0:c0ecb8bf28eb 867 #define V7_PROPERTY_NON_CONFIGURABLE (1 << 2)
Marko Mikulicic 0:c0ecb8bf28eb 868 #define V7_PROPERTY_GETTER (1 << 3)
Marko Mikulicic 0:c0ecb8bf28eb 869 #define V7_PROPERTY_SETTER (1 << 4)
Marko Mikulicic 0:c0ecb8bf28eb 870 #define _V7_PROPERTY_HIDDEN (1 << 5)
Marko Mikulicic 0:c0ecb8bf28eb 871 /* property not managed by V7 HEAP */
Marko Mikulicic 0:c0ecb8bf28eb 872 #define _V7_PROPERTY_OFF_HEAP (1 << 6)
Marko Mikulicic 0:c0ecb8bf28eb 873 /* special property holding user data and destructor cb */
Marko Mikulicic 0:c0ecb8bf28eb 874 #define _V7_PROPERTY_USER_DATA_AND_DESTRUCTOR (1 << 7)
Marko Mikulicic 0:c0ecb8bf28eb 875 /*
Marko Mikulicic 0:c0ecb8bf28eb 876 * not a property attribute, but a flag for `v7_def()`. It's here in order to
Marko Mikulicic 0:c0ecb8bf28eb 877 * keep all offsets in one place
Marko Mikulicic 0:c0ecb8bf28eb 878 */
Marko Mikulicic 0:c0ecb8bf28eb 879 #define _V7_DESC_PRESERVE_VALUE (1 << 8)
Marko Mikulicic 0:c0ecb8bf28eb 880
Marko Mikulicic 0:c0ecb8bf28eb 881 #define V7_PROP_ATTR_IS_WRITABLE(a) (!(a & V7_PROPERTY_NON_WRITABLE))
Marko Mikulicic 0:c0ecb8bf28eb 882 #define V7_PROP_ATTR_IS_ENUMERABLE(a) (!(a & V7_PROPERTY_NON_ENUMERABLE))
Marko Mikulicic 0:c0ecb8bf28eb 883 #define V7_PROP_ATTR_IS_CONFIGURABLE(a) (!(a & V7_PROPERTY_NON_CONFIGURABLE))
Marko Mikulicic 0:c0ecb8bf28eb 884
Marko Mikulicic 0:c0ecb8bf28eb 885 /*
Marko Mikulicic 0:c0ecb8bf28eb 886 * Internal helpers for `V7_DESC_...` macros
Marko Mikulicic 0:c0ecb8bf28eb 887 */
Marko Mikulicic 0:c0ecb8bf28eb 888 #define _V7_DESC_SHIFT 16
Marko Mikulicic 0:c0ecb8bf28eb 889 #define _V7_DESC_MASK ((1 << _V7_DESC_SHIFT) - 1)
Marko Mikulicic 0:c0ecb8bf28eb 890 #define _V7_MK_DESC(v, n) \
Marko Mikulicic 0:c0ecb8bf28eb 891 (((v7_prop_attr_desc_t)(n)) << _V7_DESC_SHIFT | ((v) ? (n) : 0))
Marko Mikulicic 0:c0ecb8bf28eb 892 #define _V7_MK_DESC_INV(v, n) _V7_MK_DESC(!(v), (n))
Marko Mikulicic 0:c0ecb8bf28eb 893
Marko Mikulicic 0:c0ecb8bf28eb 894 /*
Marko Mikulicic 0:c0ecb8bf28eb 895 * Property attribute descriptors that may be given to `v7_def()`: for each
Marko Mikulicic 0:c0ecb8bf28eb 896 * attribute (`v7_prop_attr_t`), there is a corresponding macro, which takes
Marko Mikulicic 0:c0ecb8bf28eb 897 * param: either 1 (set attribute) or 0 (clear attribute). If some particular
Marko Mikulicic 0:c0ecb8bf28eb 898 * attribute isn't mentioned at all, it's left unchanged (or default, if the
Marko Mikulicic 0:c0ecb8bf28eb 899 * property is being created)
Marko Mikulicic 0:c0ecb8bf28eb 900 *
Marko Mikulicic 0:c0ecb8bf28eb 901 * There is additional flag: `V7_DESC_PRESERVE_VALUE`. If it is set, the
Marko Mikulicic 0:c0ecb8bf28eb 902 * property value isn't changed (or set to `undefined` if the property is being
Marko Mikulicic 0:c0ecb8bf28eb 903 * created)
Marko Mikulicic 0:c0ecb8bf28eb 904 */
Marko Mikulicic 0:c0ecb8bf28eb 905 typedef unsigned long v7_prop_attr_desc_t;
Marko Mikulicic 0:c0ecb8bf28eb 906 #define V7_DESC_WRITABLE(v) _V7_MK_DESC_INV(v, V7_PROPERTY_NON_WRITABLE)
Marko Mikulicic 0:c0ecb8bf28eb 907 #define V7_DESC_ENUMERABLE(v) _V7_MK_DESC_INV(v, V7_PROPERTY_NON_ENUMERABLE)
Marko Mikulicic 0:c0ecb8bf28eb 908 #define V7_DESC_CONFIGURABLE(v) _V7_MK_DESC_INV(v, V7_PROPERTY_NON_CONFIGURABLE)
Marko Mikulicic 0:c0ecb8bf28eb 909 #define V7_DESC_GETTER(v) _V7_MK_DESC(v, V7_PROPERTY_GETTER)
Marko Mikulicic 0:c0ecb8bf28eb 910 #define V7_DESC_SETTER(v) _V7_MK_DESC(v, V7_PROPERTY_SETTER)
Marko Mikulicic 0:c0ecb8bf28eb 911 #define V7_DESC_PRESERVE_VALUE _V7_DESC_PRESERVE_VALUE
Marko Mikulicic 0:c0ecb8bf28eb 912
Marko Mikulicic 0:c0ecb8bf28eb 913 #define _V7_DESC_HIDDEN(v) _V7_MK_DESC(v, _V7_PROPERTY_HIDDEN)
Marko Mikulicic 0:c0ecb8bf28eb 914 #define _V7_DESC_OFF_HEAP(v) _V7_MK_DESC(v, _V7_PROPERTY_OFF_HEAP)
Marko Mikulicic 0:c0ecb8bf28eb 915
Marko Mikulicic 0:c0ecb8bf28eb 916 /* See `v7_set_destructor_cb` */
Marko Mikulicic 0:c0ecb8bf28eb 917 typedef void(v7_destructor_cb_t)(struct v7 *v7, void *ud);
Marko Mikulicic 0:c0ecb8bf28eb 918
Marko Mikulicic 0:c0ecb8bf28eb 919 /* Make an empty object */
Marko Mikulicic 0:c0ecb8bf28eb 920 v7_val_t v7_mk_object(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 921
Marko Mikulicic 0:c0ecb8bf28eb 922 /*
Marko Mikulicic 0:c0ecb8bf28eb 923 * Returns true if the given value is an object or function.
Marko Mikulicic 0:c0ecb8bf28eb 924 * i.e. it returns true if the value holds properties and can be
Marko Mikulicic 0:c0ecb8bf28eb 925 * used as argument to `v7_get`, `v7_set` and `v7_def`.
Marko Mikulicic 0:c0ecb8bf28eb 926 */
Marko Mikulicic 0:c0ecb8bf28eb 927 int v7_is_object(v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 928
Marko Mikulicic 0:c0ecb8bf28eb 929 /* Set object's prototype. Return old prototype or undefined on error. */
Marko Mikulicic 0:c0ecb8bf28eb 930 v7_val_t v7_set_proto(struct v7 *v7, v7_val_t obj, v7_val_t proto);
Marko Mikulicic 0:c0ecb8bf28eb 931
Marko Mikulicic 0:c0ecb8bf28eb 932 /* Get object's prototype. */
Marko Mikulicic 0:c0ecb8bf28eb 933 v7_val_t v7_get_proto(struct v7 *v7, v7_val_t obj);
Marko Mikulicic 0:c0ecb8bf28eb 934
Marko Mikulicic 0:c0ecb8bf28eb 935 /*
Marko Mikulicic 0:c0ecb8bf28eb 936 * Lookup property `name` in object `obj`. If `obj` holds no such property,
Marko Mikulicic 0:c0ecb8bf28eb 937 * an `undefined` value is returned.
Marko Mikulicic 0:c0ecb8bf28eb 938 *
Marko Mikulicic 0:c0ecb8bf28eb 939 * If `name_len` is ~0, `name` is assumed to be NUL-terminated and
Marko Mikulicic 0:c0ecb8bf28eb 940 * `strlen(name)` is used.
Marko Mikulicic 0:c0ecb8bf28eb 941 */
Marko Mikulicic 0:c0ecb8bf28eb 942 v7_val_t v7_get(struct v7 *v7, v7_val_t obj, const char *name, size_t name_len);
Marko Mikulicic 0:c0ecb8bf28eb 943
Marko Mikulicic 0:c0ecb8bf28eb 944 /*
Marko Mikulicic 0:c0ecb8bf28eb 945 * Like `v7_get()`, but "returns" value through `res` pointer argument.
Marko Mikulicic 0:c0ecb8bf28eb 946 * `res` must not be `NULL`.
Marko Mikulicic 0:c0ecb8bf28eb 947 *
Marko Mikulicic 0:c0ecb8bf28eb 948 * Caller should check the error code returned, and if it's something other
Marko Mikulicic 0:c0ecb8bf28eb 949 * than `V7_OK`, perform cleanup and return this code further.
Marko Mikulicic 0:c0ecb8bf28eb 950 */
Marko Mikulicic 0:c0ecb8bf28eb 951 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 952 enum v7_err v7_get_throwing(struct v7 *v7, v7_val_t obj, const char *name,
Marko Mikulicic 0:c0ecb8bf28eb 953 size_t name_len, v7_val_t *res);
Marko Mikulicic 0:c0ecb8bf28eb 954
Marko Mikulicic 0:c0ecb8bf28eb 955 /*
Marko Mikulicic 0:c0ecb8bf28eb 956 * Define object property, similar to JavaScript `Object.defineProperty()`.
Marko Mikulicic 0:c0ecb8bf28eb 957 *
Marko Mikulicic 0:c0ecb8bf28eb 958 * `name`, `name_len` specify property name, `val` is a property value.
Marko Mikulicic 0:c0ecb8bf28eb 959 * `attrs_desc` is a set of flags which can affect property's attributes,
Marko Mikulicic 0:c0ecb8bf28eb 960 * see comment of `v7_prop_attr_desc_t` for details.
Marko Mikulicic 0:c0ecb8bf28eb 961 *
Marko Mikulicic 0:c0ecb8bf28eb 962 * If `name_len` is ~0, `name` is assumed to be NUL-terminated and
Marko Mikulicic 0:c0ecb8bf28eb 963 * `strlen(name)` is used.
Marko Mikulicic 0:c0ecb8bf28eb 964 *
Marko Mikulicic 0:c0ecb8bf28eb 965 * Returns non-zero on success, 0 on error (e.g. out of memory).
Marko Mikulicic 0:c0ecb8bf28eb 966 *
Marko Mikulicic 0:c0ecb8bf28eb 967 * See also `v7_set()`.
Marko Mikulicic 0:c0ecb8bf28eb 968 */
Marko Mikulicic 0:c0ecb8bf28eb 969 int v7_def(struct v7 *v7, v7_val_t obj, const char *name, size_t name_len,
Marko Mikulicic 0:c0ecb8bf28eb 970 v7_prop_attr_desc_t attrs_desc, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 971
Marko Mikulicic 0:c0ecb8bf28eb 972 /*
Marko Mikulicic 0:c0ecb8bf28eb 973 * Set object property. Behaves just like JavaScript assignment.
Marko Mikulicic 0:c0ecb8bf28eb 974 *
Marko Mikulicic 0:c0ecb8bf28eb 975 * See also `v7_def()`.
Marko Mikulicic 0:c0ecb8bf28eb 976 */
Marko Mikulicic 0:c0ecb8bf28eb 977 int v7_set(struct v7 *v7, v7_val_t obj, const char *name, size_t len,
Marko Mikulicic 0:c0ecb8bf28eb 978 v7_val_t val);
Marko Mikulicic 0:c0ecb8bf28eb 979
Marko Mikulicic 0:c0ecb8bf28eb 980 /*
Marko Mikulicic 0:c0ecb8bf28eb 981 * A helper function to define object's method backed by a C function `func`.
Marko Mikulicic 0:c0ecb8bf28eb 982 * `name` must be NUL-terminated.
Marko Mikulicic 0:c0ecb8bf28eb 983 *
Marko Mikulicic 0:c0ecb8bf28eb 984 * Return value is the same as for `v7_set()`.
Marko Mikulicic 0:c0ecb8bf28eb 985 */
Marko Mikulicic 0:c0ecb8bf28eb 986 int v7_set_method(struct v7 *, v7_val_t obj, const char *name,
Marko Mikulicic 0:c0ecb8bf28eb 987 v7_cfunction_t *func);
Marko Mikulicic 0:c0ecb8bf28eb 988
Marko Mikulicic 0:c0ecb8bf28eb 989 /*
Marko Mikulicic 0:c0ecb8bf28eb 990 * Delete own property `name` of the object `obj`. Does not follow the
Marko Mikulicic 0:c0ecb8bf28eb 991 * prototype chain.
Marko Mikulicic 0:c0ecb8bf28eb 992 *
Marko Mikulicic 0:c0ecb8bf28eb 993 * If `name_len` is ~0, `name` is assumed to be NUL-terminated and
Marko Mikulicic 0:c0ecb8bf28eb 994 * `strlen(name)` is used.
Marko Mikulicic 0:c0ecb8bf28eb 995 *
Marko Mikulicic 0:c0ecb8bf28eb 996 * Returns 0 on success, -1 on error.
Marko Mikulicic 0:c0ecb8bf28eb 997 */
Marko Mikulicic 0:c0ecb8bf28eb 998 int v7_del(struct v7 *v7, v7_val_t obj, const char *name, size_t name_len);
Marko Mikulicic 0:c0ecb8bf28eb 999
Marko Mikulicic 0:c0ecb8bf28eb 1000 #if V7_ENABLE__Proxy
Marko Mikulicic 0:c0ecb8bf28eb 1001 struct prop_iter_proxy_ctx;
Marko Mikulicic 0:c0ecb8bf28eb 1002 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1003
Marko Mikulicic 0:c0ecb8bf28eb 1004 /*
Marko Mikulicic 0:c0ecb8bf28eb 1005 * Context for property iteration, see `v7_next_prop()`.
Marko Mikulicic 0:c0ecb8bf28eb 1006 *
Marko Mikulicic 0:c0ecb8bf28eb 1007 * Clients should not interpret contents of this structure, it's here merely to
Marko Mikulicic 0:c0ecb8bf28eb 1008 * allow clients to allocate it not from the heap.
Marko Mikulicic 0:c0ecb8bf28eb 1009 */
Marko Mikulicic 0:c0ecb8bf28eb 1010 struct prop_iter_ctx {
Marko Mikulicic 0:c0ecb8bf28eb 1011 #if V7_ENABLE__Proxy
Marko Mikulicic 0:c0ecb8bf28eb 1012 struct prop_iter_proxy_ctx *proxy_ctx;
Marko Mikulicic 0:c0ecb8bf28eb 1013 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1014 struct v7_property *cur_prop;
Marko Mikulicic 0:c0ecb8bf28eb 1015
Marko Mikulicic 0:c0ecb8bf28eb 1016 unsigned init : 1;
Marko Mikulicic 0:c0ecb8bf28eb 1017 };
Marko Mikulicic 0:c0ecb8bf28eb 1018
Marko Mikulicic 0:c0ecb8bf28eb 1019 /*
Marko Mikulicic 0:c0ecb8bf28eb 1020 * Initialize the property iteration context `ctx`, see `v7_next_prop()` for
Marko Mikulicic 0:c0ecb8bf28eb 1021 * usage example.
Marko Mikulicic 0:c0ecb8bf28eb 1022 */
Marko Mikulicic 0:c0ecb8bf28eb 1023 enum v7_err v7_init_prop_iter_ctx(struct v7 *v7, v7_val_t obj,
Marko Mikulicic 0:c0ecb8bf28eb 1024 struct prop_iter_ctx *ctx);
Marko Mikulicic 0:c0ecb8bf28eb 1025
Marko Mikulicic 0:c0ecb8bf28eb 1026 /*
Marko Mikulicic 0:c0ecb8bf28eb 1027 * Destruct the property iteration context `ctx`, see `v7_next_prop()` for
Marko Mikulicic 0:c0ecb8bf28eb 1028 * usage example
Marko Mikulicic 0:c0ecb8bf28eb 1029 */
Marko Mikulicic 0:c0ecb8bf28eb 1030 void v7_destruct_prop_iter_ctx(struct v7 *v7, struct prop_iter_ctx *ctx);
Marko Mikulicic 0:c0ecb8bf28eb 1031
Marko Mikulicic 0:c0ecb8bf28eb 1032 /*
Marko Mikulicic 0:c0ecb8bf28eb 1033 * Iterate over the `obj`'s properties.
Marko Mikulicic 0:c0ecb8bf28eb 1034 *
Marko Mikulicic 0:c0ecb8bf28eb 1035 * Usage example (here we assume we have some `v7_val_t obj`):
Marko Mikulicic 0:c0ecb8bf28eb 1036 *
Marko Mikulicic 0:c0ecb8bf28eb 1037 * struct prop_iter_ctx ctx;
Marko Mikulicic 0:c0ecb8bf28eb 1038 * v7_val_t name, val;
Marko Mikulicic 0:c0ecb8bf28eb 1039 * v7_prop_attr_t attrs;
Marko Mikulicic 0:c0ecb8bf28eb 1040 *
Marko Mikulicic 0:c0ecb8bf28eb 1041 * v7_init_prop_iter_ctx(v7, obj, &ctx);
Marko Mikulicic 0:c0ecb8bf28eb 1042 * while (v7_next_prop(v7, &ctx, &name, &val, &attrs)) {
Marko Mikulicic 0:c0ecb8bf28eb 1043 * if (V7_PROP_ATTR_IS_ENUMERABLE(attrs)) continue;
Marko Mikulicic 0:c0ecb8bf28eb 1044 * ...
Marko Mikulicic 0:c0ecb8bf28eb 1045 * }
Marko Mikulicic 0:c0ecb8bf28eb 1046 * v7_destruct_prop_iter_ctx(v7, &ctx);
Marko Mikulicic 0:c0ecb8bf28eb 1047 *
Marko Mikulicic 0:c0ecb8bf28eb 1048 * As you see, v7_next_prop will iterate through all properties, including
Marko Mikulicic 0:c0ecb8bf28eb 1049 * non-enumerable ones, and it's your responsibility to test the attributes
Marko Mikulicic 0:c0ecb8bf28eb 1050 * with the provided `V7_PROP_ATTR_*` macros and proceed as you see fit.
Marko Mikulicic 0:c0ecb8bf28eb 1051 */
Marko Mikulicic 0:c0ecb8bf28eb 1052 int v7_next_prop(struct v7 *v7, struct prop_iter_ctx *ctx, v7_val_t *name,
Marko Mikulicic 0:c0ecb8bf28eb 1053 v7_val_t *value, v7_prop_attr_t *attrs);
Marko Mikulicic 0:c0ecb8bf28eb 1054
Marko Mikulicic 0:c0ecb8bf28eb 1055 /* Returns true if the object is an instance of a given constructor. */
Marko Mikulicic 0:c0ecb8bf28eb 1056 int v7_is_instanceof(struct v7 *v7, v7_val_t o, const char *c);
Marko Mikulicic 0:c0ecb8bf28eb 1057
Marko Mikulicic 0:c0ecb8bf28eb 1058 /* Returns true if the object is an instance of a given constructor. */
Marko Mikulicic 0:c0ecb8bf28eb 1059 int v7_is_instanceof_v(struct v7 *v7, v7_val_t o, v7_val_t c);
Marko Mikulicic 0:c0ecb8bf28eb 1060
Marko Mikulicic 0:c0ecb8bf28eb 1061 /*
Marko Mikulicic 0:c0ecb8bf28eb 1062 * Associates an opaque C value (anything that can be casted to a `void * )
Marko Mikulicic 0:c0ecb8bf28eb 1063 * with an object.
Marko Mikulicic 0:c0ecb8bf28eb 1064 *
Marko Mikulicic 0:c0ecb8bf28eb 1065 * You can achieve a similar effect by just setting a special property with
Marko Mikulicic 0:c0ecb8bf28eb 1066 * a foreign value (see `v7_mk_foreign`), except user data offers the following
Marko Mikulicic 0:c0ecb8bf28eb 1067 * advantages:
Marko Mikulicic 0:c0ecb8bf28eb 1068 *
Marko Mikulicic 0:c0ecb8bf28eb 1069 * 1. You don't have to come up with some arbitrary "special" property name.
Marko Mikulicic 0:c0ecb8bf28eb 1070 * 2. JS scripts cannot access user data by mistake via property lookup.
Marko Mikulicic 0:c0ecb8bf28eb 1071 * 3. The user data is available to the destructor. When the desctructor is
Marko Mikulicic 0:c0ecb8bf28eb 1072 * invoked you cannot access any of its properties.
Marko Mikulicic 0:c0ecb8bf28eb 1073 * 4. Allows the implementation to use a more compact encoding
Marko Mikulicic 0:c0ecb8bf28eb 1074 *
Marko Mikulicic 0:c0ecb8bf28eb 1075 * Does nothing if `obj` is not a mutable object.
Marko Mikulicic 0:c0ecb8bf28eb 1076 */
Marko Mikulicic 0:c0ecb8bf28eb 1077 void v7_set_user_data(struct v7 *v7, v7_val_t obj, void *ud);
Marko Mikulicic 0:c0ecb8bf28eb 1078
Marko Mikulicic 0:c0ecb8bf28eb 1079 /*
Marko Mikulicic 0:c0ecb8bf28eb 1080 * Get the opaque user data set with `v7_set_user_data`.
Marko Mikulicic 0:c0ecb8bf28eb 1081 *
Marko Mikulicic 0:c0ecb8bf28eb 1082 * Returns NULL if there is no user data set or if `obj` is not an object.
Marko Mikulicic 0:c0ecb8bf28eb 1083 */
Marko Mikulicic 0:c0ecb8bf28eb 1084 void *v7_get_user_data(struct v7 *v7, v7_val_t obj);
Marko Mikulicic 0:c0ecb8bf28eb 1085
Marko Mikulicic 0:c0ecb8bf28eb 1086 /*
Marko Mikulicic 0:c0ecb8bf28eb 1087 * Register a callback which will be invoked when a given object gets
Marko Mikulicic 0:c0ecb8bf28eb 1088 * reclaimed by the garbage collector.
Marko Mikulicic 0:c0ecb8bf28eb 1089 *
Marko Mikulicic 0:c0ecb8bf28eb 1090 * The callback will be invoked while garbage collection is still in progress
Marko Mikulicic 0:c0ecb8bf28eb 1091 * and hence the internal state of the JS heap is in an undefined state.
Marko Mikulicic 0:c0ecb8bf28eb 1092 *
Marko Mikulicic 0:c0ecb8bf28eb 1093 * The only v7 API which is safe to use in this callback is `v7_disown()`,
Marko Mikulicic 0:c0ecb8bf28eb 1094 * that's why `v7` pointer is given to it. *Calls to any other v7 functions are
Marko Mikulicic 0:c0ecb8bf28eb 1095 * illegal here*.
Marko Mikulicic 0:c0ecb8bf28eb 1096 *
Marko Mikulicic 0:c0ecb8bf28eb 1097 * The intended use case is to reclaim resources allocated by C code.
Marko Mikulicic 0:c0ecb8bf28eb 1098 */
Marko Mikulicic 0:c0ecb8bf28eb 1099 void v7_set_destructor_cb(struct v7 *v7, v7_val_t obj, v7_destructor_cb_t *d);
Marko Mikulicic 0:c0ecb8bf28eb 1100
Marko Mikulicic 0:c0ecb8bf28eb 1101 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1102 }
Marko Mikulicic 0:c0ecb8bf28eb 1103 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1104
Marko Mikulicic 0:c0ecb8bf28eb 1105 #endif /* CS_V7_SRC_OBJECT_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1106 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1107 #line 1 "v7/src/array_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1108 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1109 /*
Marko Mikulicic 0:c0ecb8bf28eb 1110 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1111 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1112 */
Marko Mikulicic 0:c0ecb8bf28eb 1113
Marko Mikulicic 0:c0ecb8bf28eb 1114 /*
Marko Mikulicic 0:c0ecb8bf28eb 1115 * === Arrays
Marko Mikulicic 0:c0ecb8bf28eb 1116 */
Marko Mikulicic 0:c0ecb8bf28eb 1117
Marko Mikulicic 0:c0ecb8bf28eb 1118 #ifndef CS_V7_SRC_ARRAY_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1119 #define CS_V7_SRC_ARRAY_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1120
Marko Mikulicic 0:c0ecb8bf28eb 1121 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1122
Marko Mikulicic 0:c0ecb8bf28eb 1123 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1124 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 1125 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1126
Marko Mikulicic 0:c0ecb8bf28eb 1127 /* Make an empty array object */
Marko Mikulicic 0:c0ecb8bf28eb 1128 v7_val_t v7_mk_array(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 1129
Marko Mikulicic 0:c0ecb8bf28eb 1130 /* Returns true if given value is an array object */
Marko Mikulicic 0:c0ecb8bf28eb 1131 int v7_is_array(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1132
Marko Mikulicic 0:c0ecb8bf28eb 1133 /* Returns length on an array. If `arr` is not an array, 0 is returned. */
Marko Mikulicic 0:c0ecb8bf28eb 1134 unsigned long v7_array_length(struct v7 *v7, v7_val_t arr);
Marko Mikulicic 0:c0ecb8bf28eb 1135
Marko Mikulicic 0:c0ecb8bf28eb 1136 /* Insert value `v` in array `arr` at the end of the array. */
Marko Mikulicic 0:c0ecb8bf28eb 1137 int v7_array_push(struct v7 *, v7_val_t arr, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1138
Marko Mikulicic 0:c0ecb8bf28eb 1139 /*
Marko Mikulicic 0:c0ecb8bf28eb 1140 * Like `v7_array_push()`, but "returns" value through the `res` pointer
Marko Mikulicic 0:c0ecb8bf28eb 1141 * argument. `res` is allowed to be `NULL`.
Marko Mikulicic 0:c0ecb8bf28eb 1142 *
Marko Mikulicic 0:c0ecb8bf28eb 1143 * Caller should check the error code returned, and if it's something other
Marko Mikulicic 0:c0ecb8bf28eb 1144 * than `V7_OK`, perform cleanup and return this code further.
Marko Mikulicic 0:c0ecb8bf28eb 1145 */
Marko Mikulicic 0:c0ecb8bf28eb 1146 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1147 enum v7_err v7_array_push_throwing(struct v7 *v7, v7_val_t arr, v7_val_t v,
Marko Mikulicic 0:c0ecb8bf28eb 1148 int *res);
Marko Mikulicic 0:c0ecb8bf28eb 1149
Marko Mikulicic 0:c0ecb8bf28eb 1150 /*
Marko Mikulicic 0:c0ecb8bf28eb 1151 * Return array member at index `index`. If `index` is out of bounds, undefined
Marko Mikulicic 0:c0ecb8bf28eb 1152 * is returned.
Marko Mikulicic 0:c0ecb8bf28eb 1153 */
Marko Mikulicic 0:c0ecb8bf28eb 1154 v7_val_t v7_array_get(struct v7 *, v7_val_t arr, unsigned long index);
Marko Mikulicic 0:c0ecb8bf28eb 1155
Marko Mikulicic 0:c0ecb8bf28eb 1156 /* Insert value `v` into `arr` at index `index`. */
Marko Mikulicic 0:c0ecb8bf28eb 1157 int v7_array_set(struct v7 *v7, v7_val_t arr, unsigned long index, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1158
Marko Mikulicic 0:c0ecb8bf28eb 1159 /*
Marko Mikulicic 0:c0ecb8bf28eb 1160 * Like `v7_array_set()`, but "returns" value through the `res` pointer
Marko Mikulicic 0:c0ecb8bf28eb 1161 * argument. `res` is allowed to be `NULL`.
Marko Mikulicic 0:c0ecb8bf28eb 1162 *
Marko Mikulicic 0:c0ecb8bf28eb 1163 * Caller should check the error code returned, and if it's something other
Marko Mikulicic 0:c0ecb8bf28eb 1164 * than `V7_OK`, perform cleanup and return this code further.
Marko Mikulicic 0:c0ecb8bf28eb 1165 */
Marko Mikulicic 0:c0ecb8bf28eb 1166 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1167 enum v7_err v7_array_set_throwing(struct v7 *v7, v7_val_t arr,
Marko Mikulicic 0:c0ecb8bf28eb 1168 unsigned long index, v7_val_t v, int *res);
Marko Mikulicic 0:c0ecb8bf28eb 1169
Marko Mikulicic 0:c0ecb8bf28eb 1170 /* Delete value in array `arr` at index `index`, if it exists. */
Marko Mikulicic 0:c0ecb8bf28eb 1171 void v7_array_del(struct v7 *v7, v7_val_t arr, unsigned long index);
Marko Mikulicic 0:c0ecb8bf28eb 1172
Marko Mikulicic 0:c0ecb8bf28eb 1173 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1174 }
Marko Mikulicic 0:c0ecb8bf28eb 1175 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1176
Marko Mikulicic 0:c0ecb8bf28eb 1177 #endif /* CS_V7_SRC_ARRAY_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1178 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1179 #line 1 "v7/src/function_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1180 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1181 /*
Marko Mikulicic 0:c0ecb8bf28eb 1182 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1183 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1184 */
Marko Mikulicic 0:c0ecb8bf28eb 1185
Marko Mikulicic 0:c0ecb8bf28eb 1186 /*
Marko Mikulicic 0:c0ecb8bf28eb 1187 * === Functions
Marko Mikulicic 0:c0ecb8bf28eb 1188 */
Marko Mikulicic 0:c0ecb8bf28eb 1189
Marko Mikulicic 0:c0ecb8bf28eb 1190 #ifndef CS_V7_SRC_FUNCTION_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1191 #define CS_V7_SRC_FUNCTION_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1192
Marko Mikulicic 0:c0ecb8bf28eb 1193 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1194
Marko Mikulicic 0:c0ecb8bf28eb 1195 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1196 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 1197 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1198
Marko Mikulicic 0:c0ecb8bf28eb 1199 /*
Marko Mikulicic 0:c0ecb8bf28eb 1200 * Make a JS function object backed by a cfunction.
Marko Mikulicic 0:c0ecb8bf28eb 1201 *
Marko Mikulicic 0:c0ecb8bf28eb 1202 * `func` is a C callback.
Marko Mikulicic 0:c0ecb8bf28eb 1203 *
Marko Mikulicic 0:c0ecb8bf28eb 1204 * A function object is JS object having the Function prototype that holds a
Marko Mikulicic 0:c0ecb8bf28eb 1205 * cfunction value in a hidden property.
Marko Mikulicic 0:c0ecb8bf28eb 1206 *
Marko Mikulicic 0:c0ecb8bf28eb 1207 * The function object will have a `prototype` property holding an object that
Marko Mikulicic 0:c0ecb8bf28eb 1208 * will be used as the prototype of objects created when calling the function
Marko Mikulicic 0:c0ecb8bf28eb 1209 * with the `new` operator.
Marko Mikulicic 0:c0ecb8bf28eb 1210 */
Marko Mikulicic 0:c0ecb8bf28eb 1211 v7_val_t v7_mk_function(struct v7 *, v7_cfunction_t *func);
Marko Mikulicic 0:c0ecb8bf28eb 1212
Marko Mikulicic 0:c0ecb8bf28eb 1213 /*
Marko Mikulicic 0:c0ecb8bf28eb 1214 * Make f a JS function with specified prototype `proto`, so that the resulting
Marko Mikulicic 0:c0ecb8bf28eb 1215 * function is better suited for the usage as a constructor.
Marko Mikulicic 0:c0ecb8bf28eb 1216 */
Marko Mikulicic 0:c0ecb8bf28eb 1217 v7_val_t v7_mk_function_with_proto(struct v7 *v7, v7_cfunction_t *f,
Marko Mikulicic 0:c0ecb8bf28eb 1218 v7_val_t proto);
Marko Mikulicic 0:c0ecb8bf28eb 1219
Marko Mikulicic 0:c0ecb8bf28eb 1220 /*
Marko Mikulicic 0:c0ecb8bf28eb 1221 * Make a JS value that holds C/C++ callback pointer.
Marko Mikulicic 0:c0ecb8bf28eb 1222 *
Marko Mikulicic 0:c0ecb8bf28eb 1223 * CAUTION: This is a low-level function value. It's not a real object and
Marko Mikulicic 0:c0ecb8bf28eb 1224 * cannot hold user defined properties. You should use `v7_mk_function` unless
Marko Mikulicic 0:c0ecb8bf28eb 1225 * you know what you're doing.
Marko Mikulicic 0:c0ecb8bf28eb 1226 */
Marko Mikulicic 0:c0ecb8bf28eb 1227 v7_val_t v7_mk_cfunction(v7_cfunction_t *func);
Marko Mikulicic 0:c0ecb8bf28eb 1228
Marko Mikulicic 0:c0ecb8bf28eb 1229 /*
Marko Mikulicic 0:c0ecb8bf28eb 1230 * Returns true if given value is callable (i.e. it's either a JS function or
Marko Mikulicic 0:c0ecb8bf28eb 1231 * cfunction)
Marko Mikulicic 0:c0ecb8bf28eb 1232 */
Marko Mikulicic 0:c0ecb8bf28eb 1233 int v7_is_callable(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1234
Marko Mikulicic 0:c0ecb8bf28eb 1235 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1236 }
Marko Mikulicic 0:c0ecb8bf28eb 1237 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1238
Marko Mikulicic 0:c0ecb8bf28eb 1239 #endif /* CS_V7_SRC_FUNCTION_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1240 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1241 #line 1 "v7/src/regexp_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1242 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1243 /*
Marko Mikulicic 0:c0ecb8bf28eb 1244 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1245 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1246 */
Marko Mikulicic 0:c0ecb8bf28eb 1247
Marko Mikulicic 0:c0ecb8bf28eb 1248 /*
Marko Mikulicic 0:c0ecb8bf28eb 1249 * === RegExp
Marko Mikulicic 0:c0ecb8bf28eb 1250 */
Marko Mikulicic 0:c0ecb8bf28eb 1251
Marko Mikulicic 0:c0ecb8bf28eb 1252 #ifndef CS_V7_SRC_REGEXP_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1253 #define CS_V7_SRC_REGEXP_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1254
Marko Mikulicic 0:c0ecb8bf28eb 1255 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1256
Marko Mikulicic 0:c0ecb8bf28eb 1257 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1258 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 1259 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1260
Marko Mikulicic 0:c0ecb8bf28eb 1261 /*
Marko Mikulicic 0:c0ecb8bf28eb 1262 * Make RegExp object.
Marko Mikulicic 0:c0ecb8bf28eb 1263 * `regex`, `regex_len` specify a pattern, `flags` and `flags_len` specify
Marko Mikulicic 0:c0ecb8bf28eb 1264 * flags. Both utf8 encoded. For example, `regex` is `(.+)`, `flags` is `gi`.
Marko Mikulicic 0:c0ecb8bf28eb 1265 * If `regex_len` is ~0, `regex` is assumed to be NUL-terminated and
Marko Mikulicic 0:c0ecb8bf28eb 1266 * `strlen(regex)` is used.
Marko Mikulicic 0:c0ecb8bf28eb 1267 */
Marko Mikulicic 0:c0ecb8bf28eb 1268 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1269 enum v7_err v7_mk_regexp(struct v7 *v7, const char *regex, size_t regex_len,
Marko Mikulicic 0:c0ecb8bf28eb 1270 const char *flags, size_t flags_len, v7_val_t *res);
Marko Mikulicic 0:c0ecb8bf28eb 1271
Marko Mikulicic 0:c0ecb8bf28eb 1272 /* Returns true if given value is a JavaScript RegExp object*/
Marko Mikulicic 0:c0ecb8bf28eb 1273 int v7_is_regexp(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1274
Marko Mikulicic 0:c0ecb8bf28eb 1275 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1276 }
Marko Mikulicic 0:c0ecb8bf28eb 1277 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1278
Marko Mikulicic 0:c0ecb8bf28eb 1279 #endif /* CS_V7_SRC_REGEXP_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1280 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1281 #line 1 "v7/src/conversion_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1282 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1283 /*
Marko Mikulicic 0:c0ecb8bf28eb 1284 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1285 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1286 */
Marko Mikulicic 0:c0ecb8bf28eb 1287
Marko Mikulicic 0:c0ecb8bf28eb 1288 /*
Marko Mikulicic 0:c0ecb8bf28eb 1289 * === Conversion
Marko Mikulicic 0:c0ecb8bf28eb 1290 */
Marko Mikulicic 0:c0ecb8bf28eb 1291
Marko Mikulicic 0:c0ecb8bf28eb 1292 #ifndef CS_V7_SRC_CONVERSION_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1293 #define CS_V7_SRC_CONVERSION_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1294
Marko Mikulicic 0:c0ecb8bf28eb 1295 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1296
Marko Mikulicic 0:c0ecb8bf28eb 1297 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1298 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 1299 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1300
Marko Mikulicic 0:c0ecb8bf28eb 1301 /* Stringify mode, see `v7_stringify()` and `v7_stringify_throwing()` */
Marko Mikulicic 0:c0ecb8bf28eb 1302 enum v7_stringify_mode {
Marko Mikulicic 0:c0ecb8bf28eb 1303 V7_STRINGIFY_DEFAULT,
Marko Mikulicic 0:c0ecb8bf28eb 1304 V7_STRINGIFY_JSON,
Marko Mikulicic 0:c0ecb8bf28eb 1305 V7_STRINGIFY_DEBUG,
Marko Mikulicic 0:c0ecb8bf28eb 1306 };
Marko Mikulicic 0:c0ecb8bf28eb 1307
Marko Mikulicic 0:c0ecb8bf28eb 1308 /*
Marko Mikulicic 0:c0ecb8bf28eb 1309 * Generate string representation of the JavaScript value `val` into a buffer
Marko Mikulicic 0:c0ecb8bf28eb 1310 * `buf`, `len`. If `len` is too small to hold a generated string,
Marko Mikulicic 0:c0ecb8bf28eb 1311 * `v7_stringify()` allocates required memory. In that case, it is caller's
Marko Mikulicic 0:c0ecb8bf28eb 1312 * responsibility to free the allocated buffer. Generated string is guaranteed
Marko Mikulicic 0:c0ecb8bf28eb 1313 * to be 0-terminated.
Marko Mikulicic 0:c0ecb8bf28eb 1314 *
Marko Mikulicic 0:c0ecb8bf28eb 1315 * Available stringification modes are:
Marko Mikulicic 0:c0ecb8bf28eb 1316 *
Marko Mikulicic 0:c0ecb8bf28eb 1317 * - `V7_STRINGIFY_DEFAULT`:
Marko Mikulicic 0:c0ecb8bf28eb 1318 * Convert JS value to string, using common JavaScript semantics:
Marko Mikulicic 0:c0ecb8bf28eb 1319 * - If value is an object:
Marko Mikulicic 0:c0ecb8bf28eb 1320 * - call `toString()`;
Marko Mikulicic 0:c0ecb8bf28eb 1321 * - If `toString()` returned non-primitive value, call `valueOf()`;
Marko Mikulicic 0:c0ecb8bf28eb 1322 * - If `valueOf()` returned non-primitive value, throw `TypeError`.
Marko Mikulicic 0:c0ecb8bf28eb 1323 * - Now we have a primitive, and if it's not a string, then stringify it.
Marko Mikulicic 0:c0ecb8bf28eb 1324 *
Marko Mikulicic 0:c0ecb8bf28eb 1325 * - `V7_STRINGIFY_JSON`:
Marko Mikulicic 0:c0ecb8bf28eb 1326 * Generate JSON output
Marko Mikulicic 0:c0ecb8bf28eb 1327 *
Marko Mikulicic 0:c0ecb8bf28eb 1328 * - `V7_STRINGIFY_DEBUG`:
Marko Mikulicic 0:c0ecb8bf28eb 1329 * Mostly like JSON, but will not omit non-JSON objects like functions.
Marko Mikulicic 0:c0ecb8bf28eb 1330 *
Marko Mikulicic 0:c0ecb8bf28eb 1331 * Example code:
Marko Mikulicic 0:c0ecb8bf28eb 1332 *
Marko Mikulicic 0:c0ecb8bf28eb 1333 * char buf[100], *p;
Marko Mikulicic 0:c0ecb8bf28eb 1334 * p = v7_stringify(v7, obj, buf, sizeof(buf), V7_STRINGIFY_DEFAULT);
Marko Mikulicic 0:c0ecb8bf28eb 1335 * printf("JSON string: [%s]\n", p);
Marko Mikulicic 0:c0ecb8bf28eb 1336 * if (p != buf) {
Marko Mikulicic 0:c0ecb8bf28eb 1337 * free(p);
Marko Mikulicic 0:c0ecb8bf28eb 1338 * }
Marko Mikulicic 0:c0ecb8bf28eb 1339 */
Marko Mikulicic 0:c0ecb8bf28eb 1340 char *v7_stringify(struct v7 *v7, v7_val_t v, char *buf, size_t len,
Marko Mikulicic 0:c0ecb8bf28eb 1341 enum v7_stringify_mode mode);
Marko Mikulicic 0:c0ecb8bf28eb 1342
Marko Mikulicic 0:c0ecb8bf28eb 1343 /*
Marko Mikulicic 0:c0ecb8bf28eb 1344 * Like `v7_stringify()`, but "returns" value through the `res` pointer
Marko Mikulicic 0:c0ecb8bf28eb 1345 * argument. `res` must not be `NULL`.
Marko Mikulicic 0:c0ecb8bf28eb 1346 *
Marko Mikulicic 0:c0ecb8bf28eb 1347 * Caller should check the error code returned, and if it's something other
Marko Mikulicic 0:c0ecb8bf28eb 1348 * than `V7_OK`, perform cleanup and return this code further.
Marko Mikulicic 0:c0ecb8bf28eb 1349 */
Marko Mikulicic 0:c0ecb8bf28eb 1350 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1351 enum v7_err v7_stringify_throwing(struct v7 *v7, v7_val_t v, char *buf,
Marko Mikulicic 0:c0ecb8bf28eb 1352 size_t size, enum v7_stringify_mode mode,
Marko Mikulicic 0:c0ecb8bf28eb 1353 char **res);
Marko Mikulicic 0:c0ecb8bf28eb 1354
Marko Mikulicic 0:c0ecb8bf28eb 1355 /*
Marko Mikulicic 0:c0ecb8bf28eb 1356 * A shortcut for `v7_stringify()` with `V7_STRINGIFY_JSON`
Marko Mikulicic 0:c0ecb8bf28eb 1357 */
Marko Mikulicic 0:c0ecb8bf28eb 1358 #define v7_to_json(a, b, c, d) v7_stringify(a, b, c, d, V7_STRINGIFY_JSON)
Marko Mikulicic 0:c0ecb8bf28eb 1359
Marko Mikulicic 0:c0ecb8bf28eb 1360 /* Returns true if given value evaluates to true, as in `if (v)` statement. */
Marko Mikulicic 0:c0ecb8bf28eb 1361 int v7_is_truthy(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1362
Marko Mikulicic 0:c0ecb8bf28eb 1363 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1364 }
Marko Mikulicic 0:c0ecb8bf28eb 1365 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1366
Marko Mikulicic 0:c0ecb8bf28eb 1367 #endif /* CS_V7_SRC_CONVERSION_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1368 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1369 #line 1 "v7/src/exec_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1370 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1371 /*
Marko Mikulicic 0:c0ecb8bf28eb 1372 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1373 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1374 */
Marko Mikulicic 0:c0ecb8bf28eb 1375
Marko Mikulicic 0:c0ecb8bf28eb 1376 /*
Marko Mikulicic 0:c0ecb8bf28eb 1377 * === Execution of JavaScript code
Marko Mikulicic 0:c0ecb8bf28eb 1378 */
Marko Mikulicic 0:c0ecb8bf28eb 1379
Marko Mikulicic 0:c0ecb8bf28eb 1380 #ifndef CS_V7_SRC_EXEC_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1381 #define CS_V7_SRC_EXEC_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1382
Marko Mikulicic 0:c0ecb8bf28eb 1383 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1384
Marko Mikulicic 2:7762b98d31c7 1385 #if defined(__cplusplus)
Marko Mikulicic 2:7762b98d31c7 1386 extern "C" {
Marko Mikulicic 2:7762b98d31c7 1387 #endif /* __cplusplus */
Marko Mikulicic 2:7762b98d31c7 1388
Marko Mikulicic 0:c0ecb8bf28eb 1389 /*
Marko Mikulicic 0:c0ecb8bf28eb 1390 * Execute JavaScript `js_code`. The result of evaluation is stored in
Marko Mikulicic 0:c0ecb8bf28eb 1391 * the `result` variable.
Marko Mikulicic 0:c0ecb8bf28eb 1392 *
Marko Mikulicic 0:c0ecb8bf28eb 1393 * Return:
Marko Mikulicic 0:c0ecb8bf28eb 1394 *
Marko Mikulicic 0:c0ecb8bf28eb 1395 * - V7_OK on success. `result` contains the result of execution.
Marko Mikulicic 0:c0ecb8bf28eb 1396 * - V7_SYNTAX_ERROR if `js_code` in not a valid code. `result` is undefined.
Marko Mikulicic 0:c0ecb8bf28eb 1397 * - V7_EXEC_EXCEPTION if `js_code` threw an exception. `result` stores
Marko Mikulicic 0:c0ecb8bf28eb 1398 * an exception object.
Marko Mikulicic 0:c0ecb8bf28eb 1399 * - V7_AST_TOO_LARGE if `js_code` contains an AST segment longer than 16 bit.
Marko Mikulicic 0:c0ecb8bf28eb 1400 * `result` is undefined. To avoid this error, build V7 with V7_LARGE_AST.
Marko Mikulicic 0:c0ecb8bf28eb 1401 */
Marko Mikulicic 0:c0ecb8bf28eb 1402 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1403 enum v7_err v7_exec(struct v7 *v7, const char *js_code, v7_val_t *result);
Marko Mikulicic 0:c0ecb8bf28eb 1404
Marko Mikulicic 0:c0ecb8bf28eb 1405 /*
Marko Mikulicic 0:c0ecb8bf28eb 1406 * Options for `v7_exec_opt()`. To get default options, like `v7_exec()` uses,
Marko Mikulicic 0:c0ecb8bf28eb 1407 * just zero out this struct.
Marko Mikulicic 0:c0ecb8bf28eb 1408 */
Marko Mikulicic 0:c0ecb8bf28eb 1409 struct v7_exec_opts {
Marko Mikulicic 0:c0ecb8bf28eb 1410 /* Filename, used for stack traces only */
Marko Mikulicic 0:c0ecb8bf28eb 1411 const char *filename;
Marko Mikulicic 0:c0ecb8bf28eb 1412
Marko Mikulicic 0:c0ecb8bf28eb 1413 /*
Marko Mikulicic 0:c0ecb8bf28eb 1414 * Object to be used as `this`. Note: when it is zeroed out, i.e. it's a
Marko Mikulicic 0:c0ecb8bf28eb 1415 * number `0`, the `undefined` value is assumed. It means that it's
Marko Mikulicic 0:c0ecb8bf28eb 1416 * impossible to actually use the number `0` as `this` object, but it makes
Marko Mikulicic 0:c0ecb8bf28eb 1417 * little sense anyway.
Marko Mikulicic 0:c0ecb8bf28eb 1418 */
Marko Mikulicic 0:c0ecb8bf28eb 1419 v7_val_t this_obj;
Marko Mikulicic 0:c0ecb8bf28eb 1420
Marko Mikulicic 0:c0ecb8bf28eb 1421 /* Whether the given `js_code` should be interpreted as JSON, not JS code */
Marko Mikulicic 0:c0ecb8bf28eb 1422 unsigned is_json : 1;
Marko Mikulicic 0:c0ecb8bf28eb 1423 };
Marko Mikulicic 0:c0ecb8bf28eb 1424
Marko Mikulicic 0:c0ecb8bf28eb 1425 /*
Marko Mikulicic 0:c0ecb8bf28eb 1426 * Customizable version of `v7_exec()`: allows to specify various options, see
Marko Mikulicic 0:c0ecb8bf28eb 1427 * `struct v7_exec_opts`.
Marko Mikulicic 0:c0ecb8bf28eb 1428 */
Marko Mikulicic 0:c0ecb8bf28eb 1429 enum v7_err v7_exec_opt(struct v7 *v7, const char *js_code,
Marko Mikulicic 0:c0ecb8bf28eb 1430 const struct v7_exec_opts *opts, v7_val_t *res);
Marko Mikulicic 0:c0ecb8bf28eb 1431
Marko Mikulicic 0:c0ecb8bf28eb 1432 /*
Marko Mikulicic 0:c0ecb8bf28eb 1433 * Same as `v7_exec()`, but loads source code from `path` file.
Marko Mikulicic 0:c0ecb8bf28eb 1434 */
Marko Mikulicic 0:c0ecb8bf28eb 1435 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1436 enum v7_err v7_exec_file(struct v7 *v7, const char *path, v7_val_t *result);
Marko Mikulicic 0:c0ecb8bf28eb 1437
Marko Mikulicic 0:c0ecb8bf28eb 1438 /*
Marko Mikulicic 0:c0ecb8bf28eb 1439 * Parse `str` and store corresponding JavaScript object in `res` variable.
Marko Mikulicic 0:c0ecb8bf28eb 1440 * String `str` should be '\0'-terminated.
Marko Mikulicic 0:c0ecb8bf28eb 1441 * Return value and semantic is the same as for `v7_exec()`.
Marko Mikulicic 0:c0ecb8bf28eb 1442 */
Marko Mikulicic 0:c0ecb8bf28eb 1443 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1444 enum v7_err v7_parse_json(struct v7 *v7, const char *str, v7_val_t *res);
Marko Mikulicic 0:c0ecb8bf28eb 1445
Marko Mikulicic 0:c0ecb8bf28eb 1446 /*
Marko Mikulicic 0:c0ecb8bf28eb 1447 * Same as `v7_parse_json()`, but loads JSON string from `path`.
Marko Mikulicic 0:c0ecb8bf28eb 1448 */
Marko Mikulicic 0:c0ecb8bf28eb 1449 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1450 enum v7_err v7_parse_json_file(struct v7 *v7, const char *path, v7_val_t *res);
Marko Mikulicic 0:c0ecb8bf28eb 1451
Marko Mikulicic 0:c0ecb8bf28eb 1452 #if !defined(V7_NO_COMPILER)
Marko Mikulicic 0:c0ecb8bf28eb 1453
Marko Mikulicic 0:c0ecb8bf28eb 1454 /*
Marko Mikulicic 0:c0ecb8bf28eb 1455 * Compile JavaScript code `js_code` into the byte code and write generated
Marko Mikulicic 0:c0ecb8bf28eb 1456 * byte code into opened file stream `fp`. If `generate_binary_output` is 0,
Marko Mikulicic 0:c0ecb8bf28eb 1457 * then generated byte code is in human-readable text format. Otherwise, it is
Marko Mikulicic 0:c0ecb8bf28eb 1458 * in the binary format, suitable for execution by V7 instance.
Marko Mikulicic 0:c0ecb8bf28eb 1459 * NOTE: `fp` must be a valid, opened, writable file stream.
Marko Mikulicic 0:c0ecb8bf28eb 1460 */
Marko Mikulicic 0:c0ecb8bf28eb 1461 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1462 enum v7_err v7_compile(const char *js_code, int generate_binary_output,
Marko Mikulicic 0:c0ecb8bf28eb 1463 int use_bcode, FILE *fp);
Marko Mikulicic 0:c0ecb8bf28eb 1464
Marko Mikulicic 0:c0ecb8bf28eb 1465 #endif /* V7_NO_COMPILER */
Marko Mikulicic 0:c0ecb8bf28eb 1466
Marko Mikulicic 0:c0ecb8bf28eb 1467 /*
Marko Mikulicic 0:c0ecb8bf28eb 1468 * Call function `func` with arguments `args`, using `this_obj` as `this`.
Marko Mikulicic 0:c0ecb8bf28eb 1469 * `args` should be an array containing arguments or `undefined`.
Marko Mikulicic 0:c0ecb8bf28eb 1470 *
Marko Mikulicic 0:c0ecb8bf28eb 1471 * `res` can be `NULL` if return value is not required.
Marko Mikulicic 0:c0ecb8bf28eb 1472 */
Marko Mikulicic 0:c0ecb8bf28eb 1473 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1474 enum v7_err v7_apply(struct v7 *v7, v7_val_t func, v7_val_t this_obj,
Marko Mikulicic 0:c0ecb8bf28eb 1475 v7_val_t args, v7_val_t *res);
Marko Mikulicic 0:c0ecb8bf28eb 1476
Marko Mikulicic 2:7762b98d31c7 1477 #if defined(__cplusplus)
Marko Mikulicic 2:7762b98d31c7 1478 }
Marko Mikulicic 2:7762b98d31c7 1479 #endif /* __cplusplus */
Marko Mikulicic 2:7762b98d31c7 1480
Marko Mikulicic 0:c0ecb8bf28eb 1481 #endif /* CS_V7_SRC_EXEC_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1482 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1483 #line 1 "v7/src/exceptions_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1484 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1485 /*
Marko Mikulicic 0:c0ecb8bf28eb 1486 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1487 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1488 */
Marko Mikulicic 0:c0ecb8bf28eb 1489
Marko Mikulicic 0:c0ecb8bf28eb 1490 /*
Marko Mikulicic 0:c0ecb8bf28eb 1491 * === Exceptions
Marko Mikulicic 0:c0ecb8bf28eb 1492 */
Marko Mikulicic 0:c0ecb8bf28eb 1493
Marko Mikulicic 0:c0ecb8bf28eb 1494 #ifndef CS_V7_SRC_EXCEPTIONS_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1495 #define CS_V7_SRC_EXCEPTIONS_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1496
Marko Mikulicic 0:c0ecb8bf28eb 1497 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1498
Marko Mikulicic 0:c0ecb8bf28eb 1499 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1500 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 1501 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1502
Marko Mikulicic 0:c0ecb8bf28eb 1503 /* Throw an exception with an already existing value. */
Marko Mikulicic 0:c0ecb8bf28eb 1504 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1505 enum v7_err v7_throw(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1506
Marko Mikulicic 0:c0ecb8bf28eb 1507 /*
Marko Mikulicic 0:c0ecb8bf28eb 1508 * Throw an exception with given formatted message.
Marko Mikulicic 0:c0ecb8bf28eb 1509 *
Marko Mikulicic 0:c0ecb8bf28eb 1510 * Pass "Error" as typ for a generic error.
Marko Mikulicic 0:c0ecb8bf28eb 1511 */
Marko Mikulicic 0:c0ecb8bf28eb 1512 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1513 enum v7_err v7_throwf(struct v7 *v7, const char *typ, const char *err_fmt, ...);
Marko Mikulicic 0:c0ecb8bf28eb 1514
Marko Mikulicic 0:c0ecb8bf28eb 1515 /*
Marko Mikulicic 0:c0ecb8bf28eb 1516 * Rethrow the currently thrown object. In fact, it just returns
Marko Mikulicic 0:c0ecb8bf28eb 1517 * V7_EXEC_EXCEPTION.
Marko Mikulicic 0:c0ecb8bf28eb 1518 */
Marko Mikulicic 0:c0ecb8bf28eb 1519 WARN_UNUSED_RESULT
Marko Mikulicic 0:c0ecb8bf28eb 1520 enum v7_err v7_rethrow(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 1521
Marko Mikulicic 0:c0ecb8bf28eb 1522 /*
Marko Mikulicic 0:c0ecb8bf28eb 1523 * Returns the value that is being thrown at the moment, or `undefined` if
Marko Mikulicic 0:c0ecb8bf28eb 1524 * nothing is being thrown. If `is_thrown` is not `NULL`, it will be set
Marko Mikulicic 0:c0ecb8bf28eb 1525 * to either 0 or 1, depending on whether something is thrown at the moment.
Marko Mikulicic 0:c0ecb8bf28eb 1526 */
Marko Mikulicic 0:c0ecb8bf28eb 1527 v7_val_t v7_get_thrown_value(struct v7 *v7, unsigned char *is_thrown);
Marko Mikulicic 0:c0ecb8bf28eb 1528
Marko Mikulicic 0:c0ecb8bf28eb 1529 /* Clears currently thrown value, if any. */
Marko Mikulicic 0:c0ecb8bf28eb 1530 void v7_clear_thrown_value(struct v7 *v7);
Marko Mikulicic 0:c0ecb8bf28eb 1531
Marko Mikulicic 0:c0ecb8bf28eb 1532 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1533 }
Marko Mikulicic 0:c0ecb8bf28eb 1534 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1535
Marko Mikulicic 0:c0ecb8bf28eb 1536 #endif /* CS_V7_SRC_EXCEPTIONS_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1537 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1538 #line 1 "v7/src/gc_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1539 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1540 /*
Marko Mikulicic 0:c0ecb8bf28eb 1541 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1542 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1543 */
Marko Mikulicic 0:c0ecb8bf28eb 1544
Marko Mikulicic 0:c0ecb8bf28eb 1545 /*
Marko Mikulicic 0:c0ecb8bf28eb 1546 * === Garbage Collector
Marko Mikulicic 0:c0ecb8bf28eb 1547 */
Marko Mikulicic 0:c0ecb8bf28eb 1548
Marko Mikulicic 0:c0ecb8bf28eb 1549 #ifndef CS_V7_SRC_GC_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1550 #define CS_V7_SRC_GC_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1551
Marko Mikulicic 0:c0ecb8bf28eb 1552 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1553
Marko Mikulicic 0:c0ecb8bf28eb 1554 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1555 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 1556 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1557
Marko Mikulicic 0:c0ecb8bf28eb 1558 #if V7_ENABLE__Memory__stats
Marko Mikulicic 0:c0ecb8bf28eb 1559
Marko Mikulicic 0:c0ecb8bf28eb 1560 /* Heap metric id, see `v7_heap_stat()` */
Marko Mikulicic 0:c0ecb8bf28eb 1561 enum v7_heap_stat_what {
Marko Mikulicic 0:c0ecb8bf28eb 1562 V7_HEAP_STAT_HEAP_SIZE,
Marko Mikulicic 0:c0ecb8bf28eb 1563 V7_HEAP_STAT_HEAP_USED,
Marko Mikulicic 0:c0ecb8bf28eb 1564 V7_HEAP_STAT_STRING_HEAP_RESERVED,
Marko Mikulicic 0:c0ecb8bf28eb 1565 V7_HEAP_STAT_STRING_HEAP_USED,
Marko Mikulicic 0:c0ecb8bf28eb 1566 V7_HEAP_STAT_OBJ_HEAP_MAX,
Marko Mikulicic 0:c0ecb8bf28eb 1567 V7_HEAP_STAT_OBJ_HEAP_FREE,
Marko Mikulicic 0:c0ecb8bf28eb 1568 V7_HEAP_STAT_OBJ_HEAP_CELL_SIZE,
Marko Mikulicic 0:c0ecb8bf28eb 1569 V7_HEAP_STAT_FUNC_HEAP_MAX,
Marko Mikulicic 0:c0ecb8bf28eb 1570 V7_HEAP_STAT_FUNC_HEAP_FREE,
Marko Mikulicic 0:c0ecb8bf28eb 1571 V7_HEAP_STAT_FUNC_HEAP_CELL_SIZE,
Marko Mikulicic 0:c0ecb8bf28eb 1572 V7_HEAP_STAT_PROP_HEAP_MAX,
Marko Mikulicic 0:c0ecb8bf28eb 1573 V7_HEAP_STAT_PROP_HEAP_FREE,
Marko Mikulicic 0:c0ecb8bf28eb 1574 V7_HEAP_STAT_PROP_HEAP_CELL_SIZE,
Marko Mikulicic 0:c0ecb8bf28eb 1575 V7_HEAP_STAT_FUNC_AST_SIZE,
Marko Mikulicic 0:c0ecb8bf28eb 1576 V7_HEAP_STAT_BCODE_OPS_SIZE,
Marko Mikulicic 0:c0ecb8bf28eb 1577 V7_HEAP_STAT_BCODE_LIT_TOTAL_SIZE,
Marko Mikulicic 0:c0ecb8bf28eb 1578 V7_HEAP_STAT_BCODE_LIT_DESER_SIZE,
Marko Mikulicic 0:c0ecb8bf28eb 1579 V7_HEAP_STAT_FUNC_OWNED,
Marko Mikulicic 0:c0ecb8bf28eb 1580 V7_HEAP_STAT_FUNC_OWNED_MAX
Marko Mikulicic 0:c0ecb8bf28eb 1581 };
Marko Mikulicic 0:c0ecb8bf28eb 1582
Marko Mikulicic 0:c0ecb8bf28eb 1583 /* Returns a given heap statistics */
Marko Mikulicic 0:c0ecb8bf28eb 1584 int v7_heap_stat(struct v7 *v7, enum v7_heap_stat_what what);
Marko Mikulicic 0:c0ecb8bf28eb 1585 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1586
Marko Mikulicic 0:c0ecb8bf28eb 1587 /*
Marko Mikulicic 0:c0ecb8bf28eb 1588 * Perform garbage collection.
Marko Mikulicic 0:c0ecb8bf28eb 1589 * Pass true to full in order to reclaim unused heap back to the OS.
Marko Mikulicic 0:c0ecb8bf28eb 1590 */
Marko Mikulicic 0:c0ecb8bf28eb 1591 void v7_gc(struct v7 *v7, int full);
Marko Mikulicic 0:c0ecb8bf28eb 1592
Marko Mikulicic 0:c0ecb8bf28eb 1593 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1594 }
Marko Mikulicic 0:c0ecb8bf28eb 1595 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1596
Marko Mikulicic 0:c0ecb8bf28eb 1597 #endif /* CS_V7_SRC_GC_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1598 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1599 #line 1 "v7/src/util_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1600 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1601 /*
Marko Mikulicic 0:c0ecb8bf28eb 1602 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1603 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1604 */
Marko Mikulicic 0:c0ecb8bf28eb 1605
Marko Mikulicic 0:c0ecb8bf28eb 1606 /*
Marko Mikulicic 0:c0ecb8bf28eb 1607 * === Utility functions
Marko Mikulicic 0:c0ecb8bf28eb 1608 */
Marko Mikulicic 0:c0ecb8bf28eb 1609
Marko Mikulicic 0:c0ecb8bf28eb 1610 #ifndef CS_V7_SRC_UTIL_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1611 #define CS_V7_SRC_UTIL_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1612
Marko Mikulicic 0:c0ecb8bf28eb 1613 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1614
Marko Mikulicic 0:c0ecb8bf28eb 1615 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1616 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 1617 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1618
Marko Mikulicic 0:c0ecb8bf28eb 1619 /* Output a string representation of the value to stdout.
Marko Mikulicic 0:c0ecb8bf28eb 1620 * V7_STRINGIFY_DEBUG mode is used. */
Marko Mikulicic 0:c0ecb8bf28eb 1621 void v7_print(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1622
Marko Mikulicic 0:c0ecb8bf28eb 1623 /* Output a string representation of the value to stdout followed by a newline.
Marko Mikulicic 0:c0ecb8bf28eb 1624 * V7_STRINGIFY_DEBUG mode is used. */
Marko Mikulicic 0:c0ecb8bf28eb 1625 void v7_println(struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1626
Marko Mikulicic 0:c0ecb8bf28eb 1627 /* Output a string representation of the value to a file.
Marko Mikulicic 0:c0ecb8bf28eb 1628 * V7_STRINGIFY_DEBUG mode is used. */
Marko Mikulicic 0:c0ecb8bf28eb 1629 void v7_fprint(FILE *f, struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1630
Marko Mikulicic 0:c0ecb8bf28eb 1631 /* Output a string representation of the value to a file followed by a newline.
Marko Mikulicic 0:c0ecb8bf28eb 1632 * V7_STRINGIFY_DEBUG mode is used. */
Marko Mikulicic 0:c0ecb8bf28eb 1633 void v7_fprintln(FILE *f, struct v7 *v7, v7_val_t v);
Marko Mikulicic 0:c0ecb8bf28eb 1634
Marko Mikulicic 0:c0ecb8bf28eb 1635 /* Output stack trace recorded in the exception `e` to file `f` */
Marko Mikulicic 0:c0ecb8bf28eb 1636 void v7_fprint_stack_trace(FILE *f, struct v7 *v7, v7_val_t e);
Marko Mikulicic 0:c0ecb8bf28eb 1637
Marko Mikulicic 0:c0ecb8bf28eb 1638 /* Output error object message and possibly stack trace to f */
Marko Mikulicic 0:c0ecb8bf28eb 1639 void v7_print_error(FILE *f, struct v7 *v7, const char *ctx, v7_val_t e);
Marko Mikulicic 0:c0ecb8bf28eb 1640
Marko Mikulicic 0:c0ecb8bf28eb 1641 #if V7_ENABLE__Proxy
Marko Mikulicic 0:c0ecb8bf28eb 1642
Marko Mikulicic 0:c0ecb8bf28eb 1643 struct v7_property;
Marko Mikulicic 0:c0ecb8bf28eb 1644
Marko Mikulicic 0:c0ecb8bf28eb 1645 /*
Marko Mikulicic 0:c0ecb8bf28eb 1646 * C callback, analogue of JS callback `getOwnPropertyDescriptor()`.
Marko Mikulicic 0:c0ecb8bf28eb 1647 * Callbacks of this type are used for C API only, see `m7_mk_proxy()`.
Marko Mikulicic 0:c0ecb8bf28eb 1648 *
Marko Mikulicic 0:c0ecb8bf28eb 1649 * `name` is the name of the property, and the function should fill `attrs` and
Marko Mikulicic 0:c0ecb8bf28eb 1650 * `value` with the property data. Before this callback is called, `attrs` is
Marko Mikulicic 0:c0ecb8bf28eb 1651 * set to 0, and `value` is `V7_UNDEFINED`.
Marko Mikulicic 0:c0ecb8bf28eb 1652 *
Marko Mikulicic 0:c0ecb8bf28eb 1653 * It should return non-zero if the property should be considered existing, or
Marko Mikulicic 0:c0ecb8bf28eb 1654 * zero otherwise.
Marko Mikulicic 0:c0ecb8bf28eb 1655 *
Marko Mikulicic 0:c0ecb8bf28eb 1656 * You can inspect the property attributes with the `V7_PROP_ATTR_IS_*` macros.
Marko Mikulicic 0:c0ecb8bf28eb 1657 */
Marko Mikulicic 0:c0ecb8bf28eb 1658 typedef int(v7_get_own_prop_desc_cb_t)(struct v7 *v7, v7_val_t target,
Marko Mikulicic 0:c0ecb8bf28eb 1659 v7_val_t name, v7_prop_attr_t *attrs,
Marko Mikulicic 0:c0ecb8bf28eb 1660 v7_val_t *value);
Marko Mikulicic 0:c0ecb8bf28eb 1661
Marko Mikulicic 0:c0ecb8bf28eb 1662 /* Handler for `v7_mk_proxy()`; each item is a cfunction */
Marko Mikulicic 0:c0ecb8bf28eb 1663 typedef struct {
Marko Mikulicic 0:c0ecb8bf28eb 1664 v7_cfunction_t *get;
Marko Mikulicic 0:c0ecb8bf28eb 1665 v7_cfunction_t *set;
Marko Mikulicic 0:c0ecb8bf28eb 1666 v7_cfunction_t *own_keys;
Marko Mikulicic 0:c0ecb8bf28eb 1667 v7_get_own_prop_desc_cb_t *get_own_prop_desc;
Marko Mikulicic 0:c0ecb8bf28eb 1668 } v7_proxy_hnd_t;
Marko Mikulicic 0:c0ecb8bf28eb 1669
Marko Mikulicic 0:c0ecb8bf28eb 1670 /*
Marko Mikulicic 0:c0ecb8bf28eb 1671 * Create a Proxy object, see:
Marko Mikulicic 0:c0ecb8bf28eb 1672 * https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Proxy
Marko Mikulicic 0:c0ecb8bf28eb 1673 *
Marko Mikulicic 0:c0ecb8bf28eb 1674 * Only two traps are implemented so far: `get()` and `set()`. Note that
Marko Mikulicic 0:c0ecb8bf28eb 1675 * `Object.defineProperty()` bypasses the `set()` trap.
Marko Mikulicic 0:c0ecb8bf28eb 1676 *
Marko Mikulicic 0:c0ecb8bf28eb 1677 * If `target` is not an object, the empty object will be used, so it's safe
Marko Mikulicic 0:c0ecb8bf28eb 1678 * to pass `V7_UNDEFINED` as `target`.
Marko Mikulicic 0:c0ecb8bf28eb 1679 */
Marko Mikulicic 0:c0ecb8bf28eb 1680 v7_val_t v7_mk_proxy(struct v7 *v7, v7_val_t target,
Marko Mikulicic 0:c0ecb8bf28eb 1681 const v7_proxy_hnd_t *handler);
Marko Mikulicic 0:c0ecb8bf28eb 1682
Marko Mikulicic 0:c0ecb8bf28eb 1683 #endif /* V7_ENABLE__Proxy */
Marko Mikulicic 0:c0ecb8bf28eb 1684
Marko Mikulicic 0:c0ecb8bf28eb 1685 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1686 }
Marko Mikulicic 0:c0ecb8bf28eb 1687 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1688
Marko Mikulicic 0:c0ecb8bf28eb 1689 #endif /* CS_V7_SRC_UTIL_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1690 #ifdef V7_MODULE_LINES
Marko Mikulicic 0:c0ecb8bf28eb 1691 #line 1 "v7/src/main_public.h"
Marko Mikulicic 0:c0ecb8bf28eb 1692 #endif
Marko Mikulicic 0:c0ecb8bf28eb 1693 /*
Marko Mikulicic 0:c0ecb8bf28eb 1694 * Copyright (c) 2014 Cesanta Software Limited
Marko Mikulicic 0:c0ecb8bf28eb 1695 * All rights reserved
Marko Mikulicic 0:c0ecb8bf28eb 1696 */
Marko Mikulicic 0:c0ecb8bf28eb 1697
Marko Mikulicic 0:c0ecb8bf28eb 1698 /*
Marko Mikulicic 0:c0ecb8bf28eb 1699 * === v7 main()
Marko Mikulicic 0:c0ecb8bf28eb 1700 */
Marko Mikulicic 0:c0ecb8bf28eb 1701
Marko Mikulicic 0:c0ecb8bf28eb 1702 #ifndef CS_V7_SRC_MAIN_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1703 #define CS_V7_SRC_MAIN_PUBLIC_H_
Marko Mikulicic 0:c0ecb8bf28eb 1704
Marko Mikulicic 0:c0ecb8bf28eb 1705 /* Amalgamated: #include "v7/src/core_public.h" */
Marko Mikulicic 0:c0ecb8bf28eb 1706
Marko Mikulicic 0:c0ecb8bf28eb 1707 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1708 extern "C" {
Marko Mikulicic 0:c0ecb8bf28eb 1709 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1710
Marko Mikulicic 0:c0ecb8bf28eb 1711 /*
Marko Mikulicic 0:c0ecb8bf28eb 1712 * V7 executable main function.
Marko Mikulicic 0:c0ecb8bf28eb 1713 *
Marko Mikulicic 0:c0ecb8bf28eb 1714 * There are various callbacks available:
Marko Mikulicic 0:c0ecb8bf28eb 1715 *
Marko Mikulicic 0:c0ecb8bf28eb 1716 * `pre_freeze_init()` and `pre_init()` are optional intialization functions,
Marko Mikulicic 0:c0ecb8bf28eb 1717 * aimed to export any extra functionality into vanilla v7 engine. They are
Marko Mikulicic 0:c0ecb8bf28eb 1718 * called after v7 initialization, before executing given files or inline
Marko Mikulicic 0:c0ecb8bf28eb 1719 * expressions. `pre_freeze_init()` is called before "freezing" v7 state;
Marko Mikulicic 0:c0ecb8bf28eb 1720 * whereas `pre_init` called afterwards.
Marko Mikulicic 0:c0ecb8bf28eb 1721 *
Marko Mikulicic 0:c0ecb8bf28eb 1722 * `post_init()`, if provided, is called after executing files and expressions,
Marko Mikulicic 0:c0ecb8bf28eb 1723 * before destroying v7 instance and exiting.
Marko Mikulicic 0:c0ecb8bf28eb 1724 */
Marko Mikulicic 0:c0ecb8bf28eb 1725 int v7_main(int argc, char *argv[], void (*pre_freeze_init)(struct v7 *),
Marko Mikulicic 0:c0ecb8bf28eb 1726 void (*pre_init)(struct v7 *), void (*post_init)(struct v7 *));
Marko Mikulicic 0:c0ecb8bf28eb 1727
Marko Mikulicic 0:c0ecb8bf28eb 1728 #if defined(__cplusplus)
Marko Mikulicic 0:c0ecb8bf28eb 1729 }
Marko Mikulicic 0:c0ecb8bf28eb 1730 #endif /* __cplusplus */
Marko Mikulicic 0:c0ecb8bf28eb 1731
Marko Mikulicic 0:c0ecb8bf28eb 1732 #endif /* CS_V7_SRC_MAIN_PUBLIC_H_ */
Marko Mikulicic 0:c0ecb8bf28eb 1733 #endif /* V7_EXPORT_INTERNAL_HEADERS */