5#ifndef INCLUDE_V8_FAST_API_CALLS_H_
6#define INCLUDE_V8_FAST_API_CALLS_H_
210#include <type_traits>
259 "ArrayBuffers and TypedArrays are not supported directly anymore.") =
262 "Range checks should be done by the API function.") =
266 "Restricted float checks should be done by the API function.") =
271 : type_(type), flags_(flags) {}
275 : type_(static_cast<
Type>((identifier >> 8) & 255)),
276 flags_(static_cast<
Flags>(identifier & 255)) {}
278 return static_cast<uint8_t
>(type_) << 8 |
279 static_cast<uint8_t
>(flags_);
331 return HasOptions() ? arg_count_ - 1 : arg_count_;
344 return arg_count_ > 0 && arg_info_[arg_count_ - 1].GetType() ==
345 CTypeInfo::kCallbackOptionsType;
350 const Int64Representation repr_;
351 const unsigned int arg_count_;
355struct FastApiCallbackOptions;
361#if defined(V8_ENABLE_LOCAL_OFF_STACK_CHECK) && V8_HAS_ATTRIBUTE_TRIVIAL_ABI
365 AnyCType& operator=(
const AnyCType& other) {
366 int64_value = other.int64_value;
387 "The union AnyCType should have size == 64 bits, as this is assumed "
388 "by FastApiCallLoweringReducer.");
392 constexpr CFunction() : address_(nullptr), type_info_(nullptr) {}
397 return type_info_->ArgumentInfo(index);
404 return type_info_->GetInt64Representation();
410 template <
typename F>
413 CFunctionInfo::Int64Representation::kNumber) {
414 CFunction result = ArgUnwrap<F*>::Make(func, int64_rep);
420 template <
typename R,
typename... Args,
typename R_Patch,
421 typename... Args_Patch>
423 R_Patch (*patching_func)(Args_Patch...),
425 CFunctionInfo::Int64Representation::kNumber) {
426 CFunction c_func = ArgUnwrap<R (*)(Args...)>::Make(func, int64_rep);
428 sizeof...(Args_Patch) ==
sizeof...(Args),
429 "The patching function must have the same number of arguments.");
430 c_func.address_ =
reinterpret_cast<void*
>(patching_func);
437 const void* address_;
440 template <
typename F>
442 static_assert(
sizeof(F) !=
sizeof(F),
443 "CFunction must be created from a function pointer.");
446 template <
typename R,
typename... Args>
447 class ArgUnwrap<R (*)(Args...)> {
449 static CFunction Make(R (*func)(Args...),
451 CFunctionInfo::Int64Representation::kNumber);
487template <
typename T,
typename... List>
488struct count : std::integral_constant<int, 0> {};
489template <
typename T,
typename... Args>
491 : std::integral_constant<std::size_t, 1 + count<T, Args...>::value> {};
492template <
typename T,
typename U,
typename... Args>
496 typename RetBuilder,
typename... ArgBuilders>
498 static constexpr int kOptionsArgCount =
500 static constexpr int kReceiverCount = 1;
502 static_assert(kOptionsArgCount == 0 || kOptionsArgCount == 1,
503 "Only one options parameter is supported.");
505 static_assert(
sizeof...(ArgBuilders) >= kOptionsArgCount + kReceiverCount,
506 "The receiver or the options argument is missing.");
511 arg_info_storage_, Representation),
512 arg_info_storage_{ArgBuilders::Build()...} {
524 "String and api object values are not currently "
525 "supported return types.");
529 const CTypeInfo arg_info_storage_[
sizeof...(ArgBuilders)];
534 static_assert(
sizeof(T) !=
sizeof(T),
"This type is not supported");
537#define SPECIALIZE_GET_TYPE_INFO_HELPER_FOR(T, Enum) \
539 struct TypeInfoHelper<T> { \
540 static constexpr CTypeInfo::Flags Flags() { \
541 return CTypeInfo::Flags::kNone; \
544 static constexpr CTypeInfo::Type Type() { return CTypeInfo::Type::Enum; } \
547template <CTypeInfo::Type type>
550#define DEFINE_TYPE_INFO_TRAITS(CType, Enum) \
552 struct CTypeInfoTraits<CTypeInfo::Type::Enum> { \
553 using ctype = CType; \
556#define PRIMITIVE_C_TYPES(V) \
560 V(uint32_t, kUint32) \
562 V(uint64_t, kUint64) \
564 V(double, kFloat64) \
568#define ALL_C_TYPES(V) \
569 PRIMITIVE_C_TYPES(V) \
571 V(v8::Local<v8::Value>, kV8Value) \
572 V(v8::Local<v8::Object>, kV8Value) \
573 V(v8::Local<v8::Array>, kV8Value) \
583#undef PRIMITIVE_C_TYPES
586#undef TYPED_ARRAY_C_TYPES
606#define STATIC_ASSERT_IMPLIES(COND, ASSERTION, MSG) \
607 static_assert(((COND) == 0) || (ASSERTION), MSG)
623 uint8_t(kFlags) & uint8_t(CTypeInfo::Flags::kEnforceRangeBit),
624 CTypeInfo::IsIntegralType(kType),
625 "kEnforceRangeBit is only allowed for integral types.");
627 uint8_t(kFlags) & uint8_t(CTypeInfo::Flags::kClampBit),
628 CTypeInfo::IsIntegralType(kType),
629 "kClampBit is only allowed for integral types.");
631 uint8_t(kFlags) & uint8_t(CTypeInfo::Flags::kIsRestrictedBit),
632 CTypeInfo::IsFloatingPointType(kType),
633 "kIsRestrictedBit is only allowed for floating point types.");
641 template <typename... Rest>
646 static constexpr CTypeInfo::Flags MergeFlags() {
return CTypeInfo::Flags(0); }
650template <
typename RetBuilder,
typename... ArgBuilders>
656 constexpr auto Ret() {
659 ArgBuilders...>(fn_);
663 constexpr auto Arg() {
666 return ArgImpl<N, Flags...>(
667 std::make_index_sequence<
sizeof...(ArgBuilders)>());
671 template <
typename Ret,
typename... Args>
672 auto Patch(
Ret (*patching_func)(Args...)) {
674 sizeof...(Args) ==
sizeof...(ArgBuilders),
675 "The patching function must have the same number of arguments.");
676 fn_ =
reinterpret_cast<void*
>(patching_func);
690 struct GetArgBuilder;
695 struct GetArgBuilder<false, N, Flags...> {
696 using type = std::tuple_element_t<N, std::tuple<ArgBuilders...>>;
702 struct GetArgBuilder<true, N, Flags...> {
704 typename std::tuple_element_t<N, std::tuple<ArgBuilders...>>::BaseType,
705 std::tuple_element_t<N, std::tuple<ArgBuilders...>>
::Build().GetFlags(),
713 constexpr auto ArgImpl(std::index_sequence<I...>) {
714 return CFunctionBuilderWithFunction<
715 RetBuilder,
typename GetArgBuilder<N == I, I, Flags...>::type...>(fn_);
725 template <
typename R,
typename... Args>
726 constexpr auto Fn(R (*fn)(Args...)) {
729 reinterpret_cast<const void*
>(fn));
736template <
typename R,
typename... Args>
737CFunction CFunction::ArgUnwrap<R (*)(Args...)>::Make(
740 return internal::CFunctionBuilder().Fn(func).
Build();
742 return internal::CFunctionBuilder()
744 .template Build<CFunctionInfo::Int64Representation::kBigInt>();
750static constexpr CTypeInfo kTypeInfoFloat64 =
765template <CTypeInfo::Identifier type_info_
id,
typename T>
767 Local<Array> src, T* dst, uint32_t max_length);
771TryToCopyAndConvertArrayToCppBuffer<CTypeInfoBuilder<int32_t>::Build().GetId(),
772 int32_t>(Local<Array> src, int32_t* dst,
773 uint32_t max_length);
777TryToCopyAndConvertArrayToCppBuffer<CTypeInfoBuilder<uint32_t>::Build().GetId(),
778 uint32_t>(Local<Array> src, uint32_t* dst,
779 uint32_t max_length);
783TryToCopyAndConvertArrayToCppBuffer<CTypeInfoBuilder<float>::Build().GetId(),
784 float>(Local<Array> src,
float* dst,
785 uint32_t max_length);
789TryToCopyAndConvertArrayToCppBuffer<CTypeInfoBuilder<double>::Build().GetId(),
791 uint32_t max_length);
Definition: v8-fast-api-calls.h:310
Int64Representation GetInt64Representation() const
Definition: v8-fast-api-calls.h:334
Int64Representation
Definition: v8-fast-api-calls.h:312
const CTypeInfo & ReturnInfo() const
Definition: v8-fast-api-calls.h:326
const CTypeInfo & ArgumentInfo(unsigned int index) const
bool HasOptions() const
Definition: v8-fast-api-calls.h:342
unsigned int ArgumentCount() const
Definition: v8-fast-api-calls.h:330
CFunctionInfo(const CTypeInfo &return_info, unsigned int arg_count, const CTypeInfo *arg_info, Int64Representation repr=Int64Representation::kNumber)
Definition: v8-fast-api-calls.h:390
const CTypeInfo & ReturnInfo() const
Definition: v8-fast-api-calls.h:394
constexpr CFunction()
Definition: v8-fast-api-calls.h:392
const CTypeInfo & ArgumentInfo(unsigned int index) const
Definition: v8-fast-api-calls.h:396
unsigned int ArgumentCount() const
Definition: v8-fast-api-calls.h:400
CFunctionInfo::Int64Representation GetInt64Representation() const
Definition: v8-fast-api-calls.h:403
CFunction(const void *address, const CFunctionInfo *type_info)
static CFunction Make(R(*func)(Args...), R_Patch(*patching_func)(Args_Patch...), CFunctionInfo::Int64Representation int64_rep=CFunctionInfo::Int64Representation::kNumber)
Definition: v8-fast-api-calls.h:422
const void * GetAddress() const
Definition: v8-fast-api-calls.h:402
OverloadResolution
Definition: v8-fast-api-calls.h:408
const CFunctionInfo * GetTypeInfo() const
Definition: v8-fast-api-calls.h:406
static CFunction Make(F *func, CFunctionInfo::Int64Representation int64_rep=CFunctionInfo::Int64Representation::kNumber)
Definition: v8-fast-api-calls.h:411
Definition: v8-fast-api-calls.h:609
static constexpr CTypeInfo Build()
Definition: v8-fast-api-calls.h:614
T BaseType
Definition: v8-fast-api-calls.h:611
Definition: v8-fast-api-calls.h:223
Flags
Definition: v8-fast-api-calls.h:256
constexpr CTypeInfo(Type type, Flags flags=Flags::kNone)
Definition: v8-fast-api-calls.h:270
static constexpr bool IsFloatingPointType(Type type)
Definition: v8-fast-api-calls.h:291
static constexpr bool IsPrimitive(Type type)
Definition: v8-fast-api-calls.h:295
static constexpr Type kCallbackOptionsType
Definition: v8-fast-api-calls.h:254
static constexpr bool IsIntegralType(Type type)
Definition: v8-fast-api-calls.h:285
constexpr Identifier GetId() const
Definition: v8-fast-api-calls.h:277
constexpr Type GetType() const
Definition: v8-fast-api-calls.h:282
constexpr Flags GetFlags() const
Definition: v8-fast-api-calls.h:283
Type
Definition: v8-fast-api-calls.h:225
uint32_t Identifier
Definition: v8-fast-api-calls.h:273
constexpr CTypeInfo(Identifier identifier)
Definition: v8-fast-api-calls.h:274
Definition: v8-isolate.h:305
Definition: v8-local-handle.h:356
Definition: v8-fast-api-calls.h:648
auto Build()
Definition: v8-fast-api-calls.h:679
constexpr auto Ret()
Definition: v8-fast-api-calls.h:653
constexpr auto Arg()
Definition: v8-fast-api-calls.h:660
auto Patch(Ret(*patching_func)(Args...))
Definition: v8-fast-api-calls.h:669
Definition: v8-fast-api-calls.h:718
constexpr CFunctionBuilder()
Definition: v8-fast-api-calls.h:720
constexpr auto Fn(R(*fn)(Args...))
Definition: v8-fast-api-calls.h:723
Definition: v8-fast-api-calls.h:497
constexpr CFunctionInfoImpl()
Definition: v8-fast-api-calls.h:509
Definition: libplatform.h:15
constexpr v8::ExternalPointerTypeTag kFastAPIPointerTag
Definition: v8-fast-api-calls.h:790
bool TryToCopyAndConvertArrayToCppBuffer(Local< Array > src, T *dst, uint32_t max_length)
uint16_t ExternalPointerTypeTag
Definition: v8-external.h:21
internal::CFunctionBuilder CFunctionBuilder
Definition: v8-fast-api-calls.h:744
Definition: v8-fast-api-calls.h:461
v8::Isolate * isolate
Definition: v8-fast-api-calls.h:470
v8::Local< v8::Data > data
Definition: v8-fast-api-calls.h:475
static FastApiCallbackOptions CreateForTesting(Isolate *isolate)
Definition: v8-fast-api-calls.h:466
v8::Local< v8::Data > DataV2() const
Definition: v8-fast-api-calls.h:481
Definition: v8-fast-api-calls.h:305
const char * data
Definition: v8-fast-api-calls.h:306
uint32_t length
Definition: v8-fast-api-calls.h:307
Definition: v8-fast-api-calls.h:548
Definition: v8-fast-api-calls.h:533
Definition: v8-fast-api-calls.h:488
Definition: v8-fast-api-calls.h:358
FastApiCallbackOptions * options_value
Definition: v8-fast-api-calls.h:382
AnyCType()
Definition: v8-fast-api-calls.h:359
const FastOneByteString * string_value
Definition: v8-fast-api-calls.h:381
Local< Array > sequence_value
Definition: v8-fast-api-calls.h:380
Local< Object > object_value
Definition: v8-fast-api-calls.h:379
double double_value
Definition: v8-fast-api-calls.h:377
void * pointer_value
Definition: v8-fast-api-calls.h:378
uint32_t uint32_value
Definition: v8-fast-api-calls.h:373
bool bool_value
Definition: v8-fast-api-calls.h:371
float float_value
Definition: v8-fast-api-calls.h:376
uint64_t uint64_value
Definition: v8-fast-api-calls.h:375
int32_t int32_value
Definition: v8-fast-api-calls.h:372
int64_t int64_value
Definition: v8-fast-api-calls.h:374
#define DEFINE_TYPE_INFO_TRAITS(CType, Enum)
Definition: v8-fast-api-calls.h:550
#define PRIMITIVE_C_TYPES(V)
Definition: v8-fast-api-calls.h:556
#define SPECIALIZE_GET_TYPE_INFO_HELPER_FOR(T, Enum)
Definition: v8-fast-api-calls.h:537
#define ALL_C_TYPES(V)
Definition: v8-fast-api-calls.h:568
#define STATIC_ASSERT_IMPLIES(COND, ASSERTION, MSG)
Definition: v8-fast-api-calls.h:603
#define V8_EXTERNAL_POINTER_TAG_COUNT
Definition: v8-internal.h:474
#define V8_EXPORT
Definition: v8config.h:875
#define V8_INLINE
Definition: v8config.h:519
#define V8_DEPRECATE_SOON(message)
Definition: v8config.h:632
#define END_ALLOW_USE_DEPRECATED()
Definition: v8config.h:652
#define V8_WARN_UNUSED_RESULT
Definition: v8config.h:689
#define V8_TRIVIAL_ABI
Definition: v8config.h:828
#define START_ALLOW_USE_DEPRECATED()
Definition: v8config.h:651