/**************************************************************************/ /* variant.h */ /**************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /**************************************************************************/ /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */ /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */ /* */ /* Permission is hereby granted, free of charge, to any person obtaining */ /* a copy of this software and associated documentation files (the */ /* "Software"), to deal in the Software without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of the Software, and to */ /* permit persons to whom the Software is furnished to do so, subject to */ /* the following conditions: */ /* */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /**************************************************************************/ #ifndef VARIANT_H #define VARIANT_H #include "core/input/input_enums.h" #include "core/io/ip_address.h" #include "core/math/aabb.h" #include "core/math/basis.h" #include "core/math/color.h" #include "core/math/face3.h" #include "core/math/plane.h" #include "core/math/projection.h" #include "core/math/quaternion.h" #include "core/math/rect2.h" #include "core/math/rect2i.h" #include "core/math/transform_2d.h" #include "core/math/transform_3d.h" #include "core/math/vector2.h" #include "core/math/vector2i.h" #include "core/math/vector3.h" #include "core/math/vector3i.h" #include "core/math/vector4.h" #include "core/math/vector4i.h" #include "core/object/object_id.h" #include "core/os/keyboard.h" #include "core/string/node_path.h" #include "core/string/ustring.h" #include "core/templates/paged_allocator.h" #include "core/templates/rid.h" #include "core/variant/array.h" #include "core/variant/callable.h" #include "core/variant/dictionary.h" class Object; struct PropertyInfo; struct MethodInfo; typedef Vector PackedByteArray; typedef Vector PackedInt32Array; typedef Vector PackedInt64Array; typedef Vector PackedFloat32Array; typedef Vector PackedFloat64Array; typedef Vector PackedRealArray; typedef Vector PackedStringArray; typedef Vector PackedVector2Array; typedef Vector PackedVector3Array; typedef Vector PackedColorArray; class Variant { public: // If this changes the table in variant_op must be updated enum Type { NIL, // atomic types BOOL, INT, FLOAT, STRING, // math types VECTOR2, VECTOR2I, RECT2, RECT2I, VECTOR3, VECTOR3I, TRANSFORM2D, VECTOR4, VECTOR4I, PLANE, QUATERNION, AABB, BASIS, TRANSFORM3D, PROJECTION, // misc types COLOR, STRING_NAME, NODE_PATH, RID, OBJECT, CALLABLE, SIGNAL, DICTIONARY, ARRAY, // typed arrays PACKED_BYTE_ARRAY, PACKED_INT32_ARRAY, PACKED_INT64_ARRAY, PACKED_FLOAT32_ARRAY, PACKED_FLOAT64_ARRAY, PACKED_STRING_ARRAY, PACKED_VECTOR2_ARRAY, PACKED_VECTOR3_ARRAY, PACKED_COLOR_ARRAY, VARIANT_MAX }; enum { // Maximum recursion depth allowed when serializing variants. MAX_RECURSION_DEPTH = 1024, }; private: struct Pools { union BucketSmall { BucketSmall() {} ~BucketSmall() {} Transform2D _transform2d; ::AABB _aabb; }; union BucketMedium { BucketMedium() {} ~BucketMedium() {} Basis _basis; Transform3D _transform3d; }; union BucketLarge { BucketLarge() {} ~BucketLarge() {} Projection _projection; }; static PagedAllocator _bucket_small; static PagedAllocator _bucket_medium; static PagedAllocator _bucket_large; }; friend struct _VariantCall; friend class VariantInternal; // Variant takes 20 bytes when real_t is float, and 36 if double // it only allocates extra memory for aabb/matrix. Type type; struct ObjData { ObjectID id; Object *obj = nullptr; }; /* array helpers */ struct PackedArrayRefBase { SafeRefCount refcount; _FORCE_INLINE_ PackedArrayRefBase *reference() { if (refcount.ref()) { return this; } else { return nullptr; } } static _FORCE_INLINE_ PackedArrayRefBase *reference_from(PackedArrayRefBase *p_base, PackedArrayRefBase *p_from) { if (p_base == p_from) { return p_base; //same thing, do nothing } if (p_from->reference()) { if (p_base->refcount.unref()) { memdelete(p_base); } return p_from; } else { return p_base; //keep, could not reference new } } static _FORCE_INLINE_ void destroy(PackedArrayRefBase *p_array) { if (p_array->refcount.unref()) { memdelete(p_array); } } _FORCE_INLINE_ virtual ~PackedArrayRefBase() {} //needs virtual destructor, but make inline }; template struct PackedArrayRef : public PackedArrayRefBase { Vector array; static _FORCE_INLINE_ PackedArrayRef *create() { return memnew(PackedArrayRef); } static _FORCE_INLINE_ PackedArrayRef *create(const Vector &p_from) { return memnew(PackedArrayRef(p_from)); } static _FORCE_INLINE_ const Vector &get_array(PackedArrayRefBase *p_base) { return static_cast *>(p_base)->array; } static _FORCE_INLINE_ Vector *get_array_ptr(const PackedArrayRefBase *p_base) { return &const_cast *>(static_cast *>(p_base))->array; } _FORCE_INLINE_ PackedArrayRef(const Vector &p_from) { array = p_from; refcount.init(); } _FORCE_INLINE_ PackedArrayRef() { refcount.init(); } }; /* end of array helpers */ _ALWAYS_INLINE_ ObjData &_get_obj(); _ALWAYS_INLINE_ const ObjData &_get_obj() const; union { bool _bool; int64_t _int; double _float; Transform2D *_transform2d; ::AABB *_aabb; Basis *_basis; Transform3D *_transform3d; Projection *_projection; PackedArrayRefBase *packed_array; void *_ptr; //generic pointer uint8_t _mem[sizeof(ObjData) > (sizeof(real_t) * 4) ? sizeof(ObjData) : (sizeof(real_t) * 4)]{ 0 }; } _data alignas(8); void reference(const Variant &p_variant); static bool initialize_ref(Object *p_object); void _clear_internal(); _FORCE_INLINE_ void clear() { static const bool needs_deinit[Variant::VARIANT_MAX] = { false, //NIL, false, //BOOL, false, //INT, false, //FLOAT, true, //STRING, false, //VECTOR2, false, //VECTOR2I, false, //RECT2, false, //RECT2I, false, //VECTOR3, false, //VECTOR3I, true, //TRANSFORM2D, false, //VECTOR4, false, //VECTOR4I, false, //PLANE, false, //QUATERNION, true, //AABB, true, //BASIS, true, //TRANSFORM, true, //PROJECTION, // misc types false, //COLOR, true, //STRING_NAME, true, //NODE_PATH, false, //RID, true, //OBJECT, true, //CALLABLE, true, //SIGNAL, true, //DICTIONARY, true, //ARRAY, // typed arrays true, //PACKED_BYTE_ARRAY, true, //PACKED_INT32_ARRAY, true, //PACKED_INT64_ARRAY, true, //PACKED_FLOAT32_ARRAY, true, //PACKED_FLOAT64_ARRAY, true, //PACKED_STRING_ARRAY, true, //PACKED_VECTOR2_ARRAY, true, //PACKED_VECTOR3_ARRAY, true, //PACKED_COLOR_ARRAY, }; if (unlikely(needs_deinit[type])) { // Make it fast for types that don't need deinit. _clear_internal(); } type = NIL; } static void _register_variant_operators(); static void _unregister_variant_operators(); static void _register_variant_methods(); static void _unregister_variant_methods(); static void _register_variant_setters_getters(); static void _unregister_variant_setters_getters(); static void _register_variant_constructors(); static void _unregister_variant_destructors(); static void _register_variant_destructors(); static void _unregister_variant_constructors(); static void _register_variant_utility_functions(); static void _unregister_variant_utility_functions(); void _variant_call_error(const String &p_method, Callable::CallError &error); // Avoid accidental conversion. If you reached this point, it's because you most likely forgot to dereference // a Variant pointer (so add * like this: *variant_pointer). Variant(const Variant *) {} Variant(const Variant **) {} public: _FORCE_INLINE_ Type get_type() const { return type; } static String get_type_name(Variant::Type p_type); static bool can_convert(Type p_type_from, Type p_type_to); static bool can_convert_strict(Type p_type_from, Type p_type_to); static bool is_type_shared(Variant::Type p_type); bool is_ref_counted() const; _FORCE_INLINE_ bool is_num() const { return type == INT || type == FLOAT; } _FORCE_INLINE_ bool is_string() const { return type == STRING || type == STRING_NAME; } _FORCE_INLINE_ bool is_array() const { return type >= ARRAY; } bool is_shared() const; bool is_zero() const; bool is_one() const; bool is_null() const; // Make sure Variant is not implicitly cast when accessing it with bracket notation (GH-49469). Variant &operator[](const Variant &p_key) = delete; const Variant &operator[](const Variant &p_key) const = delete; operator bool() const; operator int64_t() const; operator int32_t() const; operator int16_t() const; operator int8_t() const; operator uint64_t() const; operator uint32_t() const; operator uint16_t() const; operator uint8_t() const; operator ObjectID() const; operator char32_t() const; operator float() const; operator double() const; operator String() const; operator StringName() const; operator Vector2() const; operator Vector2i() const; operator Rect2() const; operator Rect2i() const; operator Vector3() const; operator Vector3i() const; operator Vector4() const; operator Vector4i() const; operator Plane() const; operator ::AABB() const; operator Quaternion() const; operator Basis() const; operator Transform2D() const; operator Transform3D() const; operator Projection() const; operator Color() const; operator NodePath() const; operator ::RID() const; operator Object *() const; operator Callable() const; operator Signal() const; operator Dictionary() const; operator Array() const; operator PackedByteArray() const; operator PackedInt32Array() const; operator PackedInt64Array() const; operator PackedFloat32Array() const; operator PackedFloat64Array() const; operator PackedStringArray() const; operator PackedVector3Array() const; operator PackedVector2Array() const; operator PackedColorArray() const; operator Vector<::RID>() const; operator Vector() const; operator Vector() const; operator Vector() const; operator Vector() const; // some core type enums to convert to operator Side() const; operator Orientation() const; operator IPAddress() const; Object *get_validated_object() const; Object *get_validated_object_with_check(bool &r_previously_freed) const; Variant(bool p_bool); Variant(int64_t p_int64); Variant(int32_t p_int32); Variant(int16_t p_int16); Variant(int8_t p_int8); Variant(uint64_t p_uint64); Variant(uint32_t p_uint32); Variant(uint16_t p_uint16); Variant(uint8_t p_uint8); Variant(float p_float); Variant(double p_double); Variant(const ObjectID &p_id); Variant(const String &p_string); Variant(const StringName &p_string); Variant(const char *const p_cstring); Variant(const char32_t *p_wstring); Variant(const Vector2 &p_vector2); Variant(const Vector2i &p_vector2i); Variant(const Rect2 &p_rect2); Variant(const Rect2i &p_rect2i); Variant(const Vector3 &p_vector3); Variant(const Vector3i &p_vector3i); Variant(const Vector4 &p_vector4); Variant(const Vector4i &p_vector4i); Variant(const Plane &p_plane); Variant(const ::AABB &p_aabb); Variant(const Quaternion &p_quat); Variant(const Basis &p_matrix); Variant(const Transform2D &p_transform); Variant(const Transform3D &p_transform); Variant(const Projection &p_projection); Variant(const Color &p_color); Variant(const NodePath &p_node_path); Variant(const ::RID &p_rid); Variant(const Object *p_object); Variant(const Callable &p_callable); Variant(const Signal &p_signal); Variant(const Dictionary &p_dictionary); Variant(const Array &p_array); Variant(const PackedByteArray &p_byte_array); Variant(const PackedInt32Array &p_int32_array); Variant(const PackedInt64Array &p_int64_array); Variant(const PackedFloat32Array &p_float32_array); Variant(const PackedFloat64Array &p_float64_array); Variant(const PackedStringArray &p_string_array); Variant(const PackedVector2Array &p_vector2_array); Variant(const PackedVector3Array &p_vector3_array); Variant(const PackedColorArray &p_color_array); Variant(const Vector<::RID> &p_array); // helper Variant(const Vector &p_array); // helper Variant(const Vector &p_face_array); Variant(const Vector &p_array); Variant(const Vector &p_array); Variant(const IPAddress &p_address); #define VARIANT_ENUM_CLASS_CONSTRUCTOR(m_enum) \ Variant(m_enum p_value) : \ type(INT) { \ _data._int = (int64_t)p_value; \ } // Only enum classes that need to be bound need this to be defined. VARIANT_ENUM_CLASS_CONSTRUCTOR(EulerOrder) VARIANT_ENUM_CLASS_CONSTRUCTOR(JoyAxis) VARIANT_ENUM_CLASS_CONSTRUCTOR(JoyButton) VARIANT_ENUM_CLASS_CONSTRUCTOR(Key) VARIANT_ENUM_CLASS_CONSTRUCTOR(KeyLocation) VARIANT_ENUM_CLASS_CONSTRUCTOR(MIDIMessage) VARIANT_ENUM_CLASS_CONSTRUCTOR(MouseButton) #undef VARIANT_ENUM_CLASS_CONSTRUCTOR // If this changes the table in variant_op must be updated enum Operator { //comparison OP_EQUAL, OP_NOT_EQUAL, OP_LESS, OP_LESS_EQUAL, OP_GREATER, OP_GREATER_EQUAL, //mathematic OP_ADD, OP_SUBTRACT, OP_MULTIPLY, OP_DIVIDE, OP_NEGATE, OP_POSITIVE, OP_MODULE, OP_POWER, //bitwise OP_SHIFT_LEFT, OP_SHIFT_RIGHT, OP_BIT_AND, OP_BIT_OR, OP_BIT_XOR, OP_BIT_NEGATE, //logic OP_AND, OP_OR, OP_XOR, OP_NOT, //containment OP_IN, OP_MAX }; static String get_operator_name(Operator p_op); static void evaluate(const Operator &p_op, const Variant &p_a, const Variant &p_b, Variant &r_ret, bool &r_valid); static _FORCE_INLINE_ Variant evaluate(const Operator &p_op, const Variant &p_a, const Variant &p_b) { bool valid = true; Variant res; evaluate(p_op, p_a, p_b, res, valid); return res; } static Variant::Type get_operator_return_type(Operator p_operator, Type p_type_a, Type p_type_b); typedef void (*ValidatedOperatorEvaluator)(const Variant *left, const Variant *right, Variant *r_ret); static ValidatedOperatorEvaluator get_validated_operator_evaluator(Operator p_operator, Type p_type_a, Type p_type_b); typedef void (*PTROperatorEvaluator)(const void *left, const void *right, void *r_ret); static PTROperatorEvaluator get_ptr_operator_evaluator(Operator p_operator, Type p_type_a, Type p_type_b); void zero(); Variant duplicate(bool p_deep = false) const; Variant recursive_duplicate(bool p_deep, int recursion_count) const; /* Built-In Methods */ typedef void (*ValidatedBuiltInMethod)(Variant *base, const Variant **p_args, int p_argcount, Variant *r_ret); typedef void (*PTRBuiltInMethod)(void *p_base, const void **p_args, void *r_ret, int p_argcount); static bool has_builtin_method(Variant::Type p_type, const StringName &p_method); static ValidatedBuiltInMethod get_validated_builtin_method(Variant::Type p_type, const StringName &p_method); static PTRBuiltInMethod get_ptr_builtin_method(Variant::Type p_type, const StringName &p_method); static MethodInfo get_builtin_method_info(Variant::Type p_type, const StringName &p_method); static int get_builtin_method_argument_count(Variant::Type p_type, const StringName &p_method); static Variant::Type get_builtin_method_argument_type(Variant::Type p_type, const StringName &p_method, int p_argument); static String get_builtin_method_argument_name(Variant::Type p_type, const StringName &p_method, int p_argument); static Vector get_builtin_method_default_arguments(Variant::Type p_type, const StringName &p_method); static bool has_builtin_method_return_value(Variant::Type p_type, const StringName &p_method); static Variant::Type get_builtin_method_return_type(Variant::Type p_type, const StringName &p_method); static bool is_builtin_method_const(Variant::Type p_type, const StringName &p_method); static bool is_builtin_method_static(Variant::Type p_type, const StringName &p_method); static bool is_builtin_method_vararg(Variant::Type p_type, const StringName &p_method); static void get_builtin_method_list(Variant::Type p_type, List *p_list); static int get_builtin_method_count(Variant::Type p_type); static uint32_t get_builtin_method_hash(Variant::Type p_type, const StringName &p_method); void callp(const StringName &p_method, const Variant **p_args, int p_argcount, Variant &r_ret, Callable::CallError &r_error); template Variant call(const StringName &p_method, VarArgs... p_args) { Variant args[sizeof...(p_args) + 1] = { p_args..., Variant() }; // +1 makes sure zero sized arrays are also supported. const Variant *argptrs[sizeof...(p_args) + 1]; for (uint32_t i = 0; i < sizeof...(p_args); i++) { argptrs[i] = &args[i]; } Callable::CallError cerr; Variant ret; callp(p_method, sizeof...(p_args) == 0 ? nullptr : (const Variant **)argptrs, sizeof...(p_args), ret, cerr); if (cerr.error != Callable::CallError::CALL_OK) { _variant_call_error(p_method, cerr); } return ret; } void call_const(const StringName &p_method, const Variant **p_args, int p_argcount, Variant &r_ret, Callable::CallError &r_error); static void call_static(Variant::Type p_type, const StringName &p_method, const Variant **p_args, int p_argcount, Variant &r_ret, Callable::CallError &r_error); static String get_call_error_text(const StringName &p_method, const Variant **p_argptrs, int p_argcount, const Callable::CallError &ce); static String get_call_error_text(Object *p_base, const StringName &p_method, const Variant **p_argptrs, int p_argcount, const Callable::CallError &ce); static String get_callable_error_text(const Callable &p_callable, const Variant **p_argptrs, int p_argcount, const Callable::CallError &ce); //dynamic (includes Object) void get_method_list(List *p_list) const; bool has_method(const StringName &p_method) const; /* Constructors */ typedef void (*ValidatedConstructor)(Variant *r_base, const Variant **p_args); typedef void (*PTRConstructor)(void *base, const void **p_args); static int get_constructor_count(Variant::Type p_type); static ValidatedConstructor get_validated_constructor(Variant::Type p_type, int p_constructor); static PTRConstructor get_ptr_constructor(Variant::Type p_type, int p_constructor); static int get_constructor_argument_count(Variant::Type p_type, int p_constructor); static Variant::Type get_constructor_argument_type(Variant::Type p_type, int p_constructor, int p_argument); static String get_constructor_argument_name(Variant::Type p_type, int p_constructor, int p_argument); static void construct(Variant::Type, Variant &base, const Variant **p_args, int p_argcount, Callable::CallError &r_error); static void get_constructor_list(Type p_type, List *r_list); //convenience /* Destructors */ // Only ptrcall is available. typedef void (*PTRDestructor)(void *base); static PTRDestructor get_ptr_destructor(Variant::Type p_type); static bool has_destructor(Variant::Type p_type); /* Properties */ void set_named(const StringName &p_member, const Variant &p_value, bool &r_valid); Variant get_named(const StringName &p_member, bool &r_valid) const; typedef void (*ValidatedSetter)(Variant *base, const Variant *value); typedef void (*ValidatedGetter)(const Variant *base, Variant *value); static bool has_member(Variant::Type p_type, const StringName &p_member); static Variant::Type get_member_type(Variant::Type p_type, const StringName &p_member); static void get_member_list(Type p_type, List *r_members); static int get_member_count(Type p_type); static ValidatedSetter get_member_validated_setter(Variant::Type p_type, const StringName &p_member); static ValidatedGetter get_member_validated_getter(Variant::Type p_type, const StringName &p_member); typedef void (*PTRSetter)(void *base, const void *value); typedef void (*PTRGetter)(const void *base, void *value); static PTRSetter get_member_ptr_setter(Variant::Type p_type, const StringName &p_member); static PTRGetter get_member_ptr_getter(Variant::Type p_type, const StringName &p_member); /* Indexing */ static bool has_indexing(Variant::Type p_type); static Variant::Type get_indexed_element_type(Variant::Type p_type); static uint32_t get_indexed_element_usage(Variant::Type p_type); typedef void (*ValidatedIndexedSetter)(Variant *base, int64_t index, const Variant *value, bool *oob); typedef void (*ValidatedIndexedGetter)(const Variant *base, int64_t index, Variant *value, bool *oob); static ValidatedIndexedSetter get_member_validated_indexed_setter(Variant::Type p_type); static ValidatedIndexedGetter get_member_validated_indexed_getter(Variant::Type p_type); typedef void (*PTRIndexedSetter)(void *base, int64_t index, const void *value); typedef void (*PTRIndexedGetter)(const void *base, int64_t index, void *value); static PTRIndexedSetter get_member_ptr_indexed_setter(Variant::Type p_type); static PTRIndexedGetter get_member_ptr_indexed_getter(Variant::Type p_type); void set_indexed(int64_t p_index, const Variant &p_value, bool &r_valid, bool &r_oob); Variant get_indexed(int64_t p_index, bool &r_valid, bool &r_oob) const; uint64_t get_indexed_size() const; /* Keying */ static bool is_keyed(Variant::Type p_type); typedef void (*ValidatedKeyedSetter)(Variant *base, const Variant *key, const Variant *value, bool *valid); typedef void (*ValidatedKeyedGetter)(const Variant *base, const Variant *key, Variant *value, bool *valid); typedef bool (*ValidatedKeyedChecker)(const Variant *base, const Variant *key, bool *valid); static ValidatedKeyedSetter get_member_validated_keyed_setter(Variant::Type p_type); static ValidatedKeyedGetter get_member_validated_keyed_getter(Variant::Type p_type); static ValidatedKeyedChecker get_member_validated_keyed_checker(Variant::Type p_type); typedef void (*PTRKeyedSetter)(void *base, const void *key, const void *value); typedef void (*PTRKeyedGetter)(const void *base, const void *key, void *value); typedef uint32_t (*PTRKeyedChecker)(const void *base, const void *key); static PTRKeyedSetter get_member_ptr_keyed_setter(Variant::Type p_type); static PTRKeyedGetter get_member_ptr_keyed_getter(Variant::Type p_type); static PTRKeyedChecker get_member_ptr_keyed_checker(Variant::Type p_type); void set_keyed(const Variant &p_key, const Variant &p_value, bool &r_valid); Variant get_keyed(const Variant &p_key, bool &r_valid) const; bool has_key(const Variant &p_key, bool &r_valid) const; /* Generic */ enum VariantSetError { SET_OK, SET_KEYED_ERR, SET_NAMED_ERR, SET_INDEXED_ERR }; enum VariantGetError { GET_OK, GET_KEYED_ERR, GET_NAMED_ERR, GET_INDEXED_ERR }; void set(const Variant &p_index, const Variant &p_value, bool *r_valid = nullptr, VariantSetError *err_code = nullptr); Variant get(const Variant &p_index, bool *r_valid = nullptr, VariantGetError *err_code = nullptr) const; bool in(const Variant &p_index, bool *r_valid = nullptr) const; bool iter_init(Variant &r_iter, bool &r_valid) const; bool iter_next(Variant &r_iter, bool &r_valid) const; Variant iter_get(const Variant &r_iter, bool &r_valid) const; void get_property_list(List *p_list) const; static void call_utility_function(const StringName &p_name, Variant *r_ret, const Variant **p_args, int p_argcount, Callable::CallError &r_error); static bool has_utility_function(const StringName &p_name); typedef void (*ValidatedUtilityFunction)(Variant *r_ret, const Variant **p_args, int p_argcount); typedef void (*PTRUtilityFunction)(void *r_ret, const void **p_args, int p_argcount); static ValidatedUtilityFunction get_validated_utility_function(const StringName &p_name); static PTRUtilityFunction get_ptr_utility_function(const StringName &p_name); enum UtilityFunctionType { UTILITY_FUNC_TYPE_MATH, UTILITY_FUNC_TYPE_RANDOM, UTILITY_FUNC_TYPE_GENERAL, }; static UtilityFunctionType get_utility_function_type(const StringName &p_name); static MethodInfo get_utility_function_info(const StringName &p_name); static int get_utility_function_argument_count(const StringName &p_name); static Variant::Type get_utility_function_argument_type(const StringName &p_name, int p_arg); static String get_utility_function_argument_name(const StringName &p_name, int p_arg); static bool has_utility_function_return_value(const StringName &p_name); static Variant::Type get_utility_function_return_type(const StringName &p_name); static bool is_utility_function_vararg(const StringName &p_name); static uint32_t get_utility_function_hash(const StringName &p_name); static void get_utility_function_list(List *r_functions); static int get_utility_function_count(); //argsVariant call() bool operator==(const Variant &p_variant) const; bool operator!=(const Variant &p_variant) const; bool operator<(const Variant &p_variant) const; uint32_t hash() const; uint32_t recursive_hash(int recursion_count) const; // By default, performs a semantic comparison. Otherwise, numeric/binary comparison (if appropriate). bool hash_compare(const Variant &p_variant, int recursion_count = 0, bool semantic_comparison = true) const; bool identity_compare(const Variant &p_variant) const; bool booleanize() const; String stringify(int recursion_count = 0) const; String to_json_string() const; void static_assign(const Variant &p_variant); static void get_constants_for_type(Variant::Type p_type, List *p_constants); static int get_constants_count_for_type(Variant::Type p_type); static bool has_constant(Variant::Type p_type, const StringName &p_value); static Variant get_constant_value(Variant::Type p_type, const StringName &p_value, bool *r_valid = nullptr); static void get_enums_for_type(Variant::Type p_type, List *p_enums); static void get_enumerations_for_enum(Variant::Type p_type, const StringName &p_enum_name, List *p_enumerations); static int get_enum_value(Variant::Type p_type, const StringName &p_enum_name, const StringName &p_enumeration, bool *r_valid = nullptr); typedef String (*ObjectDeConstruct)(const Variant &p_object, void *ud); typedef void (*ObjectConstruct)(const String &p_text, void *ud, Variant &r_value); String get_construct_string() const; static void construct_from_string(const String &p_string, Variant &r_value, ObjectConstruct p_obj_construct = nullptr, void *p_construct_ud = nullptr); void operator=(const Variant &p_variant); // only this is enough for all the other types static void register_types(); static void unregister_types(); Variant(const Variant &p_variant); _FORCE_INLINE_ Variant() : type(NIL) {} _FORCE_INLINE_ ~Variant() { clear(); } }; //typedef Dictionary Dictionary; no //typedef Array Array; template Vector varray(VarArgs... p_args) { Vector v; Variant args[sizeof...(p_args) + 1] = { p_args..., Variant() }; // +1 makes sure zero sized arrays are also supported. uint32_t argc = sizeof...(p_args); if (argc > 0) { v.resize(argc); Variant *vw = v.ptrw(); for (uint32_t i = 0; i < argc; i++) { vw[i] = args[i]; } } return v; } struct VariantHasher { static _FORCE_INLINE_ uint32_t hash(const Variant &p_variant) { return p_variant.hash(); } }; struct VariantComparator { static _FORCE_INLINE_ bool compare(const Variant &p_lhs, const Variant &p_rhs) { return p_lhs.hash_compare(p_rhs); } }; struct StringLikeVariantComparator { static bool compare(const Variant &p_lhs, const Variant &p_rhs); }; Variant::ObjData &Variant::_get_obj() { return *reinterpret_cast(&_data._mem[0]); } const Variant::ObjData &Variant::_get_obj() const { return *reinterpret_cast(&_data._mem[0]); } template String vformat(const String &p_text, const VarArgs... p_args) { Variant args[sizeof...(p_args) + 1] = { p_args..., Variant() }; // +1 makes sure zero sized arrays are also supported. Array args_array; args_array.resize(sizeof...(p_args)); for (uint32_t i = 0; i < sizeof...(p_args); i++) { args_array[i] = args[i]; } bool error = false; String fmt = p_text.sprintf(args_array, &error); ERR_FAIL_COND_V_MSG(error, String(), fmt); return fmt; } template Variant Callable::call(VarArgs... p_args) const { Variant args[sizeof...(p_args) + 1] = { p_args..., 0 }; // +1 makes sure zero sized arrays are also supported. const Variant *argptrs[sizeof...(p_args) + 1]; for (uint32_t i = 0; i < sizeof...(p_args); i++) { argptrs[i] = &args[i]; } Variant ret; CallError ce; callp(sizeof...(p_args) == 0 ? nullptr : (const Variant **)argptrs, sizeof...(p_args), ret, ce); return ret; } template Callable Callable::bind(VarArgs... p_args) const { Variant args[sizeof...(p_args) + 1] = { p_args..., Variant() }; // +1 makes sure zero sized arrays are also supported. const Variant *argptrs[sizeof...(p_args) + 1]; for (uint32_t i = 0; i < sizeof...(p_args); i++) { argptrs[i] = &args[i]; } return bindp(sizeof...(p_args) == 0 ? nullptr : (const Variant **)argptrs, sizeof...(p_args)); } Variant &Array::Iterator::operator*() const { if (unlikely(read_only)) { *read_only = *element_ptr; return *read_only; } return *element_ptr; } Variant *Array::Iterator::operator->() const { if (unlikely(read_only)) { *read_only = *element_ptr; return read_only; } return element_ptr; } Array::Iterator &Array::Iterator::operator++() { element_ptr++; return *this; } Array::Iterator &Array::Iterator::operator--() { element_ptr--; return *this; } const Variant &Array::ConstIterator::operator*() const { if (unlikely(read_only)) { *read_only = *element_ptr; return *read_only; } return *element_ptr; } const Variant *Array::ConstIterator::operator->() const { if (unlikely(read_only)) { *read_only = *element_ptr; return read_only; } return element_ptr; } Array::ConstIterator &Array::ConstIterator::operator++() { element_ptr++; return *this; } Array::ConstIterator &Array::ConstIterator::operator--() { element_ptr--; return *this; } #endif // VARIANT_H