#ifndef ENTT_META_UTILITY_HPP #define ENTT_META_UTILITY_HPP #include #include #include #include #include "../config/config.h" #include "../core/type_traits.hpp" #include "meta.hpp" #include "node.hpp" #include "policy.hpp" namespace entt { /*! @brief Primary template isn't defined on purpose. */ template struct meta_function_descriptor; /** * @brief Meta function descriptor. * @tparam Type Reflected type to which the meta function is associated. * @tparam Ret Function return type. * @tparam Class Actual owner of the member function. * @tparam Args Function arguments. */ template struct meta_function_descriptor { /*! @brief Meta function return type. */ using return_type = Ret; /*! @brief Meta function arguments. */ using args_type = std::conditional_t, type_list, type_list>; /*! @brief True if the meta function is const, false otherwise. */ static constexpr auto is_const = true; /*! @brief True if the meta function is static, false otherwise. */ static constexpr auto is_static = !std::is_same_v; }; /** * @brief Meta function descriptor. * @tparam Type Reflected type to which the meta function is associated. * @tparam Ret Function return type. * @tparam Class Actual owner of the member function. * @tparam Args Function arguments. */ template struct meta_function_descriptor { /*! @brief Meta function return type. */ using return_type = Ret; /*! @brief Meta function arguments. */ using args_type = std::conditional_t, type_list, type_list>; /*! @brief True if the meta function is const, false otherwise. */ static constexpr auto is_const = false; /*! @brief True if the meta function is static, false otherwise. */ static constexpr auto is_static = !std::is_same_v; }; /** * @brief Meta function descriptor. * @tparam Type Reflected type to which the meta function is associated. * @tparam Ret Function return type. * @tparam Args Function arguments. */ template struct meta_function_descriptor { /*! @brief Meta function return type. */ using return_type = Ret; /*! @brief Meta function arguments. */ using args_type = type_list; /*! @brief True if the meta function is const, false otherwise. */ static constexpr auto is_const = false; /*! @brief True if the meta function is static, false otherwise. */ static constexpr auto is_static = true; }; /** * @brief Meta function helper. * * Converts a function type to be associated with a reflected type into its meta * function descriptor. * * @tparam Type Reflected type to which the meta function is associated. * @tparam Candidate The actual function to associate with the reflected type. */ template class meta_function_helper { template static constexpr meta_function_descriptor get_rid_of_noexcept(Ret(Class:: *)(Args...) const); template static constexpr meta_function_descriptor get_rid_of_noexcept(Ret(Class:: *)(Args...)); template static constexpr meta_function_descriptor get_rid_of_noexcept(Ret(*)(Args...)); public: /*! @brief The meta function descriptor of the given function. */ using type = decltype(get_rid_of_noexcept(std::declval())); }; /** * @brief Helper type. * @tparam Type Reflected type to which the meta function is associated. * @tparam Candidate The actual function to associate with the reflected type. */ template using meta_function_helper_t = typename meta_function_helper::type; /** * @brief Returns the meta type of the i-th element of a list of arguments. * @tparam Args Actual types of arguments. * @return The meta type of the i-th element of the list of arguments. */ template [[nodiscard]] static meta_type meta_arg(type_list, const std::size_t index) ENTT_NOEXCEPT { return internal::meta_arg_node(type_list{}, index); } /** * @brief Constructs an instance given a list of erased parameters, if possible. * @tparam Type Actual type of the instance to construct. * @tparam Args Types of arguments expected. * @tparam Index Indexes to use to extract erased arguments from their list. * @param args Parameters to use to construct the instance. * @return A meta any containing the new instance, if any. */ template [[nodiscard]] meta_any meta_construct(meta_any * const args, std::index_sequence) { if(((args+Index)->allow_cast() && ...)) { return Type{(args+Index)->cast()...}; } return {}; } /** * @brief Sets the value of a given variable. * @tparam Type Reflected type to which the variable is associated. * @tparam Data The actual variable to set. * @param instance An opaque instance of the underlying type, if required. * @param value Parameter to use to set the variable. * @return True in case of success, false otherwise. */ template [[nodiscard]] bool meta_setter([[maybe_unused]] meta_handle instance, [[maybe_unused]] meta_any value) { if constexpr(!std::is_same_v && !std::is_same_v) { if constexpr(std::is_function_v>>) { using data_type = type_list_element_t<1u, typename meta_function_helper_t::args_type>; if(auto * const clazz = instance->try_cast(); clazz && value.allow_cast()) { Data(*clazz, value.cast()); return true; } } else if constexpr(std::is_member_function_pointer_v) { using data_type = type_list_element_t<0u, typename meta_function_helper_t::args_type>; if(auto * const clazz = instance->try_cast(); clazz && value.allow_cast()) { (clazz->*Data)(value.cast()); return true; } } else if constexpr(std::is_member_object_pointer_v) { using data_type = std::remove_reference_t().*Data)>; if constexpr(!std::is_array_v && !std::is_const_v) { if(auto * const clazz = instance->try_cast(); clazz && value.allow_cast()) { clazz->*Data = value.cast(); return true; } } } else { using data_type = std::remove_reference_t; if constexpr(!std::is_array_v && !std::is_const_v) { if(value.allow_cast()) { *Data = value.cast(); return true; } } } } return false; } /** * @brief Wraps a value depending on the given policy. * @tparam Policy Optional policy (no policy set by default). * @tparam Type Type of value to wrap. * @param value Value to wrap. * @return A meta any containing the returned value. */ template meta_any meta_dispatch(Type &&value) { if constexpr(std::is_same_v) { return meta_any{std::in_place_type, std::forward(value)}; } else if constexpr(std::is_same_v) { return meta_any{std::in_place_type, std::forward(value)}; } else if constexpr(std::is_same_v) { static_assert(std::is_lvalue_reference_v, "Invalid type"); return meta_any{std::in_place_type &>, std::as_const(value)}; } else { static_assert(std::is_same_v, "Policy not supported"); return meta_any{std::forward(value)}; } } /** * @brief Gets the value of a given variable. * @tparam Type Reflected type to which the variable is associated. * @tparam Data The actual variable to get. * @tparam Policy Optional policy (no policy set by default). * @param instance An opaque instance of the underlying type, if required. * @return A meta any containing the value of the underlying variable. */ template [[nodiscard]] meta_any meta_getter([[maybe_unused]] meta_handle instance) { if constexpr(std::is_function_v>>) { auto * const clazz = instance->try_cast, const Type, Type>>(); return clazz ? meta_dispatch(Data(*clazz)) : meta_any{}; } else if constexpr(std::is_member_function_pointer_v) { auto * const clazz = instance->try_cast, const Type, Type>>(); return clazz ? meta_dispatch((clazz->*Data)()) : meta_any{}; } else if constexpr(std::is_member_object_pointer_v) { if constexpr(!std::is_array_v().*Data)>>>) { if(auto * clazz = instance->try_cast(); clazz) { return meta_dispatch(clazz->*Data); } else if(auto * fallback = instance->try_cast(); fallback) { return meta_dispatch(fallback->*Data); } } return meta_any{}; } else if constexpr(std::is_pointer_v) { if constexpr(std::is_array_v>) { return meta_any{}; } else { return meta_dispatch(*Data); } } else { return meta_dispatch(Data); } } /** * @brief Invokes a function given a list of erased parameters, if possible. * @tparam Type Reflected type to which the function is associated. * @tparam Candidate The actual function to invoke. * @tparam Policy Optional policy (no policy set by default). * @tparam Index Indexes to use to extract erased arguments from their list. * @param instance An opaque instance of the underlying type, if required. * @param args Parameters to use to invoke the function. * @return A meta any containing the returned value, if any. */ template [[nodiscard]] std::enable_if_t, meta_any> meta_invoke([[maybe_unused]] meta_handle instance, meta_any *args, std::index_sequence) { using descriptor = meta_function_helper_t; const auto invoke = [](auto &&maybe_clazz, auto &&... other) { if constexpr(std::is_member_function_pointer_v) { if constexpr(std::is_void_v) { (std::forward(maybe_clazz).*Candidate)(std::forward(other)...); return meta_any{std::in_place_type}; } else { return meta_dispatch((std::forward(maybe_clazz).*Candidate)(std::forward(other)...)); } } else { if constexpr(std::is_void_v) { Candidate(std::forward(maybe_clazz), std::forward(other)...); return meta_any{std::in_place_type}; } else { return meta_dispatch(Candidate(std::forward(maybe_clazz), std::forward(other)...)); } } }; if constexpr(std::is_invocable_v...>) { if(const auto * const clazz = instance->try_cast(); clazz && ((args+Index)->allow_cast>() && ...)) { return invoke(*clazz, (args+Index)->cast>()...); } } else if constexpr(std::is_invocable_v...>) { if(auto * const clazz = instance->try_cast(); clazz && ((args+Index)->allow_cast>() && ...)) { return invoke(*clazz, (args+Index)->cast>()...); } } else { if(((args+Index)->allow_cast>() && ...)) { return invoke((args+Index)->cast>()...); } } return meta_any{}; } /** * @brief Invokes a function given a list of erased parameters, if possible. * @tparam Type Reflected type to which the function is associated. * @tparam Candidate The actual function to invoke. * @tparam Policy Optional policy (no policy set by default). * @tparam Index Indexes to use to extract erased arguments from their list. * @return A meta any containing the returned value, if any. */ template [[nodiscard]] std::enable_if_t, meta_any> meta_invoke(meta_handle, meta_any *, std::index_sequence) { if constexpr(std::is_void_v) { Candidate(); return meta_any{std::in_place_type}; } else { return meta_dispatch(Candidate()); } } } #endif