gdscript_function.h 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617
  1. /*************************************************************************/
  2. /* gdscript_function.h */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2021 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2021 Godot Engine contributors (cf. AUTHORS.md). */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /*************************************************************************/
  30. #ifndef GDSCRIPT_FUNCTION_H
  31. #define GDSCRIPT_FUNCTION_H
  32. #include "core/object/reference.h"
  33. #include "core/object/script_language.h"
  34. #include "core/os/thread.h"
  35. #include "core/string/string_name.h"
  36. #include "core/templates/pair.h"
  37. #include "core/templates/self_list.h"
  38. #include "core/variant/variant.h"
  39. #include "gdscript_utility_functions.h"
  40. class GDScriptInstance;
  41. class GDScript;
  42. class GDScriptDataType {
  43. private:
  44. GDScriptDataType *container_element_type = nullptr;
  45. public:
  46. enum Kind {
  47. UNINITIALIZED,
  48. BUILTIN,
  49. NATIVE,
  50. SCRIPT,
  51. GDSCRIPT,
  52. };
  53. Kind kind = UNINITIALIZED;
  54. bool has_type = false;
  55. Variant::Type builtin_type = Variant::NIL;
  56. StringName native_type;
  57. Script *script_type = nullptr;
  58. Ref<Script> script_type_ref;
  59. bool is_type(const Variant &p_variant, bool p_allow_implicit_conversion = false) const {
  60. if (!has_type) {
  61. return true; // Can't type check
  62. }
  63. switch (kind) {
  64. case UNINITIALIZED:
  65. break;
  66. case BUILTIN: {
  67. Variant::Type var_type = p_variant.get_type();
  68. bool valid = builtin_type == var_type;
  69. if (valid && builtin_type == Variant::ARRAY && has_container_element_type()) {
  70. Array array = p_variant;
  71. if (array.is_typed()) {
  72. Variant::Type array_builtin_type = (Variant::Type)array.get_typed_builtin();
  73. StringName array_native_type = array.get_typed_class_name();
  74. Ref<Script> array_script_type_ref = array.get_typed_script();
  75. if (array_script_type_ref.is_valid()) {
  76. valid = (container_element_type->kind == SCRIPT || container_element_type->kind == GDSCRIPT) && container_element_type->script_type == array_script_type_ref.ptr();
  77. } else if (array_native_type != StringName()) {
  78. valid = container_element_type->kind == NATIVE && container_element_type->native_type == array_native_type;
  79. } else {
  80. valid = container_element_type->kind == BUILTIN && container_element_type->builtin_type == array_builtin_type;
  81. }
  82. } else {
  83. valid = false;
  84. }
  85. } else if (!valid && p_allow_implicit_conversion) {
  86. valid = Variant::can_convert_strict(var_type, builtin_type);
  87. }
  88. return valid;
  89. } break;
  90. case NATIVE: {
  91. if (p_variant.get_type() == Variant::NIL) {
  92. return true;
  93. }
  94. if (p_variant.get_type() != Variant::OBJECT) {
  95. return false;
  96. }
  97. Object *obj = p_variant.get_validated_object();
  98. if (!obj) {
  99. return false;
  100. }
  101. if (!ClassDB::is_parent_class(obj->get_class_name(), native_type)) {
  102. // Try with underscore prefix
  103. StringName underscore_native_type = "_" + native_type;
  104. if (!ClassDB::is_parent_class(obj->get_class_name(), underscore_native_type)) {
  105. return false;
  106. }
  107. }
  108. return true;
  109. } break;
  110. case SCRIPT:
  111. case GDSCRIPT: {
  112. if (p_variant.get_type() == Variant::NIL) {
  113. return true;
  114. }
  115. if (p_variant.get_type() != Variant::OBJECT) {
  116. return false;
  117. }
  118. Object *obj = p_variant.get_validated_object();
  119. if (!obj) {
  120. return false;
  121. }
  122. Ref<Script> base = obj && obj->get_script_instance() ? obj->get_script_instance()->get_script() : nullptr;
  123. bool valid = false;
  124. while (base.is_valid()) {
  125. if (base == script_type) {
  126. valid = true;
  127. break;
  128. }
  129. base = base->get_base_script();
  130. }
  131. return valid;
  132. } break;
  133. }
  134. return false;
  135. }
  136. operator PropertyInfo() const {
  137. PropertyInfo info;
  138. if (has_type) {
  139. switch (kind) {
  140. case UNINITIALIZED:
  141. break;
  142. case BUILTIN: {
  143. info.type = builtin_type;
  144. } break;
  145. case NATIVE: {
  146. info.type = Variant::OBJECT;
  147. info.class_name = native_type;
  148. } break;
  149. case SCRIPT:
  150. case GDSCRIPT: {
  151. info.type = Variant::OBJECT;
  152. info.class_name = script_type->get_instance_base_type();
  153. } break;
  154. }
  155. } else {
  156. info.type = Variant::NIL;
  157. info.usage |= PROPERTY_USAGE_NIL_IS_VARIANT;
  158. }
  159. return info;
  160. }
  161. void set_container_element_type(const GDScriptDataType &p_element_type) {
  162. container_element_type = memnew(GDScriptDataType(p_element_type));
  163. }
  164. GDScriptDataType get_container_element_type() const {
  165. ERR_FAIL_COND_V(container_element_type == nullptr, GDScriptDataType());
  166. return *container_element_type;
  167. }
  168. bool has_container_element_type() const {
  169. return container_element_type != nullptr;
  170. }
  171. void unset_container_element_type() {
  172. if (container_element_type) {
  173. memdelete(container_element_type);
  174. }
  175. container_element_type = nullptr;
  176. }
  177. GDScriptDataType() = default;
  178. GDScriptDataType &operator=(const GDScriptDataType &p_other) {
  179. kind = p_other.kind;
  180. has_type = p_other.has_type;
  181. builtin_type = p_other.builtin_type;
  182. native_type = p_other.native_type;
  183. script_type = p_other.script_type;
  184. script_type_ref = p_other.script_type_ref;
  185. unset_container_element_type();
  186. if (p_other.has_container_element_type()) {
  187. set_container_element_type(p_other.get_container_element_type());
  188. }
  189. return *this;
  190. }
  191. GDScriptDataType(const GDScriptDataType &p_other) {
  192. *this = p_other;
  193. }
  194. ~GDScriptDataType() {
  195. unset_container_element_type();
  196. }
  197. };
  198. class GDScriptFunction {
  199. public:
  200. enum Opcode {
  201. OPCODE_OPERATOR,
  202. OPCODE_OPERATOR_VALIDATED,
  203. OPCODE_EXTENDS_TEST,
  204. OPCODE_IS_BUILTIN,
  205. OPCODE_SET_KEYED,
  206. OPCODE_SET_KEYED_VALIDATED,
  207. OPCODE_SET_INDEXED_VALIDATED,
  208. OPCODE_GET_KEYED,
  209. OPCODE_GET_KEYED_VALIDATED,
  210. OPCODE_GET_INDEXED_VALIDATED,
  211. OPCODE_SET_NAMED,
  212. OPCODE_SET_NAMED_VALIDATED,
  213. OPCODE_GET_NAMED,
  214. OPCODE_GET_NAMED_VALIDATED,
  215. OPCODE_SET_MEMBER,
  216. OPCODE_GET_MEMBER,
  217. OPCODE_ASSIGN,
  218. OPCODE_ASSIGN_TRUE,
  219. OPCODE_ASSIGN_FALSE,
  220. OPCODE_ASSIGN_TYPED_BUILTIN,
  221. OPCODE_ASSIGN_TYPED_ARRAY,
  222. OPCODE_ASSIGN_TYPED_NATIVE,
  223. OPCODE_ASSIGN_TYPED_SCRIPT,
  224. OPCODE_CAST_TO_BUILTIN,
  225. OPCODE_CAST_TO_NATIVE,
  226. OPCODE_CAST_TO_SCRIPT,
  227. OPCODE_CONSTRUCT, // Only for basic types!
  228. OPCODE_CONSTRUCT_VALIDATED, // Only for basic types!
  229. OPCODE_CONSTRUCT_ARRAY,
  230. OPCODE_CONSTRUCT_TYPED_ARRAY,
  231. OPCODE_CONSTRUCT_DICTIONARY,
  232. OPCODE_CALL,
  233. OPCODE_CALL_RETURN,
  234. OPCODE_CALL_ASYNC,
  235. OPCODE_CALL_UTILITY,
  236. OPCODE_CALL_UTILITY_VALIDATED,
  237. OPCODE_CALL_GDSCRIPT_UTILITY,
  238. OPCODE_CALL_BUILTIN_TYPE_VALIDATED,
  239. OPCODE_CALL_SELF_BASE,
  240. OPCODE_CALL_METHOD_BIND,
  241. OPCODE_CALL_METHOD_BIND_RET,
  242. // ptrcall have one instruction per return type.
  243. OPCODE_CALL_PTRCALL_NO_RETURN,
  244. OPCODE_CALL_PTRCALL_BOOL,
  245. OPCODE_CALL_PTRCALL_INT,
  246. OPCODE_CALL_PTRCALL_FLOAT,
  247. OPCODE_CALL_PTRCALL_STRING,
  248. OPCODE_CALL_PTRCALL_VECTOR2,
  249. OPCODE_CALL_PTRCALL_VECTOR2I,
  250. OPCODE_CALL_PTRCALL_RECT2,
  251. OPCODE_CALL_PTRCALL_RECT2I,
  252. OPCODE_CALL_PTRCALL_VECTOR3,
  253. OPCODE_CALL_PTRCALL_VECTOR3I,
  254. OPCODE_CALL_PTRCALL_TRANSFORM2D,
  255. OPCODE_CALL_PTRCALL_PLANE,
  256. OPCODE_CALL_PTRCALL_QUAT,
  257. OPCODE_CALL_PTRCALL_AABB,
  258. OPCODE_CALL_PTRCALL_BASIS,
  259. OPCODE_CALL_PTRCALL_TRANSFORM,
  260. OPCODE_CALL_PTRCALL_COLOR,
  261. OPCODE_CALL_PTRCALL_STRING_NAME,
  262. OPCODE_CALL_PTRCALL_NODE_PATH,
  263. OPCODE_CALL_PTRCALL_RID,
  264. OPCODE_CALL_PTRCALL_OBJECT,
  265. OPCODE_CALL_PTRCALL_CALLABLE,
  266. OPCODE_CALL_PTRCALL_SIGNAL,
  267. OPCODE_CALL_PTRCALL_DICTIONARY,
  268. OPCODE_CALL_PTRCALL_ARRAY,
  269. OPCODE_CALL_PTRCALL_PACKED_BYTE_ARRAY,
  270. OPCODE_CALL_PTRCALL_PACKED_INT32_ARRAY,
  271. OPCODE_CALL_PTRCALL_PACKED_INT64_ARRAY,
  272. OPCODE_CALL_PTRCALL_PACKED_FLOAT32_ARRAY,
  273. OPCODE_CALL_PTRCALL_PACKED_FLOAT64_ARRAY,
  274. OPCODE_CALL_PTRCALL_PACKED_STRING_ARRAY,
  275. OPCODE_CALL_PTRCALL_PACKED_VECTOR2_ARRAY,
  276. OPCODE_CALL_PTRCALL_PACKED_VECTOR3_ARRAY,
  277. OPCODE_CALL_PTRCALL_PACKED_COLOR_ARRAY,
  278. OPCODE_AWAIT,
  279. OPCODE_AWAIT_RESUME,
  280. OPCODE_JUMP,
  281. OPCODE_JUMP_IF,
  282. OPCODE_JUMP_IF_NOT,
  283. OPCODE_JUMP_TO_DEF_ARGUMENT,
  284. OPCODE_RETURN,
  285. OPCODE_RETURN_TYPED_BUILTIN,
  286. OPCODE_RETURN_TYPED_ARRAY,
  287. OPCODE_RETURN_TYPED_NATIVE,
  288. OPCODE_RETURN_TYPED_SCRIPT,
  289. OPCODE_ITERATE_BEGIN,
  290. OPCODE_ITERATE_BEGIN_INT,
  291. OPCODE_ITERATE_BEGIN_FLOAT,
  292. OPCODE_ITERATE_BEGIN_VECTOR2,
  293. OPCODE_ITERATE_BEGIN_VECTOR2I,
  294. OPCODE_ITERATE_BEGIN_VECTOR3,
  295. OPCODE_ITERATE_BEGIN_VECTOR3I,
  296. OPCODE_ITERATE_BEGIN_STRING,
  297. OPCODE_ITERATE_BEGIN_DICTIONARY,
  298. OPCODE_ITERATE_BEGIN_ARRAY,
  299. OPCODE_ITERATE_BEGIN_PACKED_BYTE_ARRAY,
  300. OPCODE_ITERATE_BEGIN_PACKED_INT32_ARRAY,
  301. OPCODE_ITERATE_BEGIN_PACKED_INT64_ARRAY,
  302. OPCODE_ITERATE_BEGIN_PACKED_FLOAT32_ARRAY,
  303. OPCODE_ITERATE_BEGIN_PACKED_FLOAT64_ARRAY,
  304. OPCODE_ITERATE_BEGIN_PACKED_STRING_ARRAY,
  305. OPCODE_ITERATE_BEGIN_PACKED_VECTOR2_ARRAY,
  306. OPCODE_ITERATE_BEGIN_PACKED_VECTOR3_ARRAY,
  307. OPCODE_ITERATE_BEGIN_PACKED_COLOR_ARRAY,
  308. OPCODE_ITERATE_BEGIN_OBJECT,
  309. OPCODE_ITERATE,
  310. OPCODE_ITERATE_INT,
  311. OPCODE_ITERATE_FLOAT,
  312. OPCODE_ITERATE_VECTOR2,
  313. OPCODE_ITERATE_VECTOR2I,
  314. OPCODE_ITERATE_VECTOR3,
  315. OPCODE_ITERATE_VECTOR3I,
  316. OPCODE_ITERATE_STRING,
  317. OPCODE_ITERATE_DICTIONARY,
  318. OPCODE_ITERATE_ARRAY,
  319. OPCODE_ITERATE_PACKED_BYTE_ARRAY,
  320. OPCODE_ITERATE_PACKED_INT32_ARRAY,
  321. OPCODE_ITERATE_PACKED_INT64_ARRAY,
  322. OPCODE_ITERATE_PACKED_FLOAT32_ARRAY,
  323. OPCODE_ITERATE_PACKED_FLOAT64_ARRAY,
  324. OPCODE_ITERATE_PACKED_STRING_ARRAY,
  325. OPCODE_ITERATE_PACKED_VECTOR2_ARRAY,
  326. OPCODE_ITERATE_PACKED_VECTOR3_ARRAY,
  327. OPCODE_ITERATE_PACKED_COLOR_ARRAY,
  328. OPCODE_ITERATE_OBJECT,
  329. OPCODE_STORE_NAMED_GLOBAL,
  330. OPCODE_TYPE_ADJUST_BOOL,
  331. OPCODE_TYPE_ADJUST_INT,
  332. OPCODE_TYPE_ADJUST_FLOAT,
  333. OPCODE_TYPE_ADJUST_STRING,
  334. OPCODE_TYPE_ADJUST_VECTOR2,
  335. OPCODE_TYPE_ADJUST_VECTOR2I,
  336. OPCODE_TYPE_ADJUST_RECT2,
  337. OPCODE_TYPE_ADJUST_RECT2I,
  338. OPCODE_TYPE_ADJUST_VECTOR3,
  339. OPCODE_TYPE_ADJUST_VECTOR3I,
  340. OPCODE_TYPE_ADJUST_TRANSFORM2D,
  341. OPCODE_TYPE_ADJUST_PLANE,
  342. OPCODE_TYPE_ADJUST_QUAT,
  343. OPCODE_TYPE_ADJUST_AABB,
  344. OPCODE_TYPE_ADJUST_BASIS,
  345. OPCODE_TYPE_ADJUST_TRANSFORM,
  346. OPCODE_TYPE_ADJUST_COLOR,
  347. OPCODE_TYPE_ADJUST_STRING_NAME,
  348. OPCODE_TYPE_ADJUST_NODE_PATH,
  349. OPCODE_TYPE_ADJUST_RID,
  350. OPCODE_TYPE_ADJUST_OBJECT,
  351. OPCODE_TYPE_ADJUST_CALLABLE,
  352. OPCODE_TYPE_ADJUST_SIGNAL,
  353. OPCODE_TYPE_ADJUST_DICTIONARY,
  354. OPCODE_TYPE_ADJUST_ARRAY,
  355. OPCODE_TYPE_ADJUST_PACKED_BYTE_ARRAY,
  356. OPCODE_TYPE_ADJUST_PACKED_INT32_ARRAY,
  357. OPCODE_TYPE_ADJUST_PACKED_INT64_ARRAY,
  358. OPCODE_TYPE_ADJUST_PACKED_FLOAT32_ARRAY,
  359. OPCODE_TYPE_ADJUST_PACKED_FLOAT64_ARRAY,
  360. OPCODE_TYPE_ADJUST_PACKED_STRING_ARRAY,
  361. OPCODE_TYPE_ADJUST_PACKED_VECTOR2_ARRAY,
  362. OPCODE_TYPE_ADJUST_PACKED_VECTOR3_ARRAY,
  363. OPCODE_TYPE_ADJUST_PACKED_COLOR_ARRAY,
  364. OPCODE_ASSERT,
  365. OPCODE_BREAKPOINT,
  366. OPCODE_LINE,
  367. OPCODE_END
  368. };
  369. enum Address {
  370. ADDR_BITS = 24,
  371. ADDR_MASK = ((1 << ADDR_BITS) - 1),
  372. ADDR_TYPE_MASK = ~ADDR_MASK,
  373. ADDR_TYPE_STACK = 0,
  374. ADDR_TYPE_CONSTANT = 1,
  375. ADDR_TYPE_MEMBER = 2,
  376. };
  377. enum FixedAddresses {
  378. ADDR_STACK_SELF = 0,
  379. ADDR_STACK_CLASS = 1,
  380. ADDR_STACK_NIL = 2,
  381. ADDR_SELF = ADDR_STACK_SELF | (ADDR_TYPE_STACK << ADDR_BITS),
  382. ADDR_CLASS = ADDR_STACK_CLASS | (ADDR_TYPE_STACK << ADDR_BITS),
  383. ADDR_NIL = ADDR_STACK_NIL | (ADDR_TYPE_STACK << ADDR_BITS),
  384. };
  385. enum Instruction {
  386. INSTR_BITS = 20,
  387. INSTR_MASK = ((1 << INSTR_BITS) - 1),
  388. INSTR_ARGS_MASK = ~INSTR_MASK,
  389. };
  390. struct StackDebug {
  391. int line;
  392. int pos;
  393. bool added;
  394. StringName identifier;
  395. };
  396. private:
  397. friend class GDScriptCompiler;
  398. friend class GDScriptByteCodeGenerator;
  399. StringName source;
  400. mutable Variant nil;
  401. mutable Variant *_constants_ptr = nullptr;
  402. int _constant_count = 0;
  403. const StringName *_global_names_ptr = nullptr;
  404. int _global_names_count = 0;
  405. const int *_default_arg_ptr = nullptr;
  406. int _default_arg_count = 0;
  407. int _operator_funcs_count = 0;
  408. const Variant::ValidatedOperatorEvaluator *_operator_funcs_ptr = nullptr;
  409. int _setters_count = 0;
  410. const Variant::ValidatedSetter *_setters_ptr = nullptr;
  411. int _getters_count = 0;
  412. const Variant::ValidatedGetter *_getters_ptr = nullptr;
  413. int _keyed_setters_count = 0;
  414. const Variant::ValidatedKeyedSetter *_keyed_setters_ptr = nullptr;
  415. int _keyed_getters_count = 0;
  416. const Variant::ValidatedKeyedGetter *_keyed_getters_ptr = nullptr;
  417. int _indexed_setters_count = 0;
  418. const Variant::ValidatedIndexedSetter *_indexed_setters_ptr = nullptr;
  419. int _indexed_getters_count = 0;
  420. const Variant::ValidatedIndexedGetter *_indexed_getters_ptr = nullptr;
  421. int _builtin_methods_count = 0;
  422. const Variant::ValidatedBuiltInMethod *_builtin_methods_ptr = nullptr;
  423. int _constructors_count = 0;
  424. const Variant::ValidatedConstructor *_constructors_ptr = nullptr;
  425. int _utilities_count = 0;
  426. const Variant::ValidatedUtilityFunction *_utilities_ptr = nullptr;
  427. int _gds_utilities_count = 0;
  428. const GDScriptUtilityFunctions::FunctionPtr *_gds_utilities_ptr = nullptr;
  429. int _methods_count = 0;
  430. MethodBind **_methods_ptr = nullptr;
  431. const int *_code_ptr = nullptr;
  432. int _code_size = 0;
  433. int _argument_count = 0;
  434. int _stack_size = 0;
  435. int _instruction_args_size = 0;
  436. int _ptrcall_args_size = 0;
  437. int _initial_line = 0;
  438. bool _static = false;
  439. MultiplayerAPI::RPCMode rpc_mode = MultiplayerAPI::RPC_MODE_DISABLED;
  440. GDScript *_script = nullptr;
  441. StringName name;
  442. Vector<Variant> constants;
  443. Vector<StringName> global_names;
  444. Vector<int> default_arguments;
  445. Vector<Variant::ValidatedOperatorEvaluator> operator_funcs;
  446. Vector<Variant::ValidatedSetter> setters;
  447. Vector<Variant::ValidatedGetter> getters;
  448. Vector<Variant::ValidatedKeyedSetter> keyed_setters;
  449. Vector<Variant::ValidatedKeyedGetter> keyed_getters;
  450. Vector<Variant::ValidatedIndexedSetter> indexed_setters;
  451. Vector<Variant::ValidatedIndexedGetter> indexed_getters;
  452. Vector<Variant::ValidatedBuiltInMethod> builtin_methods;
  453. Vector<Variant::ValidatedConstructor> constructors;
  454. Vector<Variant::ValidatedUtilityFunction> utilities;
  455. Vector<GDScriptUtilityFunctions::FunctionPtr> gds_utilities;
  456. Vector<MethodBind *> methods;
  457. Vector<int> code;
  458. Vector<GDScriptDataType> argument_types;
  459. GDScriptDataType return_type;
  460. #ifdef TOOLS_ENABLED
  461. Vector<StringName> arg_names;
  462. Vector<Variant> default_arg_values;
  463. #endif
  464. List<StackDebug> stack_debug;
  465. _FORCE_INLINE_ Variant *_get_variant(int p_address, GDScriptInstance *p_instance, Variant *p_stack, String &r_error) const;
  466. _FORCE_INLINE_ String _get_call_error(const Callable::CallError &p_err, const String &p_where, const Variant **argptrs) const;
  467. friend class GDScriptLanguage;
  468. SelfList<GDScriptFunction> function_list{ this };
  469. #ifdef DEBUG_ENABLED
  470. CharString func_cname;
  471. const char *_func_cname = nullptr;
  472. struct Profile {
  473. StringName signature;
  474. uint64_t call_count = 0;
  475. uint64_t self_time = 0;
  476. uint64_t total_time = 0;
  477. uint64_t frame_call_count = 0;
  478. uint64_t frame_self_time = 0;
  479. uint64_t frame_total_time = 0;
  480. uint64_t last_frame_call_count = 0;
  481. uint64_t last_frame_self_time = 0;
  482. uint64_t last_frame_total_time = 0;
  483. } profile;
  484. #endif
  485. public:
  486. struct CallState {
  487. GDScript *script = nullptr;
  488. GDScriptInstance *instance = nullptr;
  489. #ifdef DEBUG_ENABLED
  490. StringName function_name;
  491. String script_path;
  492. #endif
  493. Vector<uint8_t> stack;
  494. int stack_size = 0;
  495. uint32_t alloca_size = 0;
  496. int ip = 0;
  497. int line = 0;
  498. int defarg = 0;
  499. Variant result;
  500. };
  501. _FORCE_INLINE_ bool is_static() const { return _static; }
  502. const int *get_code() const; //used for debug
  503. int get_code_size() const;
  504. Variant get_constant(int p_idx) const;
  505. StringName get_global_name(int p_idx) const;
  506. StringName get_name() const;
  507. int get_max_stack_size() const;
  508. int get_default_argument_count() const;
  509. int get_default_argument_addr(int p_idx) const;
  510. GDScriptDataType get_return_type() const;
  511. GDScriptDataType get_argument_type(int p_idx) const;
  512. GDScript *get_script() const { return _script; }
  513. StringName get_source() const { return source; }
  514. void debug_get_stack_member_state(int p_line, List<Pair<StringName, int>> *r_stackvars) const;
  515. _FORCE_INLINE_ bool is_empty() const { return _code_size == 0; }
  516. int get_argument_count() const { return _argument_count; }
  517. StringName get_argument_name(int p_idx) const {
  518. #ifdef TOOLS_ENABLED
  519. ERR_FAIL_INDEX_V(p_idx, arg_names.size(), StringName());
  520. return arg_names[p_idx];
  521. #else
  522. return StringName();
  523. #endif
  524. }
  525. Variant get_default_argument(int p_idx) const {
  526. ERR_FAIL_INDEX_V(p_idx, default_arguments.size(), Variant());
  527. return default_arguments[p_idx];
  528. }
  529. #ifdef TOOLS_ENABLED
  530. const Vector<Variant> &get_default_arg_values() const {
  531. return default_arg_values;
  532. }
  533. #endif // TOOLS_ENABLED
  534. Variant call(GDScriptInstance *p_instance, const Variant **p_args, int p_argcount, Callable::CallError &r_err, CallState *p_state = nullptr);
  535. #ifdef DEBUG_ENABLED
  536. void disassemble(const Vector<String> &p_code_lines) const;
  537. #endif
  538. _FORCE_INLINE_ MultiplayerAPI::RPCMode get_rpc_mode() const { return rpc_mode; }
  539. GDScriptFunction();
  540. ~GDScriptFunction();
  541. };
  542. class GDScriptFunctionState : public Reference {
  543. GDCLASS(GDScriptFunctionState, Reference);
  544. friend class GDScriptFunction;
  545. GDScriptFunction *function = nullptr;
  546. GDScriptFunction::CallState state;
  547. Variant _signal_callback(const Variant **p_args, int p_argcount, Callable::CallError &r_error);
  548. Ref<GDScriptFunctionState> first_state;
  549. SelfList<GDScriptFunctionState> scripts_list;
  550. SelfList<GDScriptFunctionState> instances_list;
  551. protected:
  552. static void _bind_methods();
  553. public:
  554. bool is_valid(bool p_extended_check = false) const;
  555. Variant resume(const Variant &p_arg = Variant());
  556. void _clear_stack();
  557. GDScriptFunctionState();
  558. ~GDScriptFunctionState();
  559. };
  560. #endif // GDSCRIPT_FUNCTION_H