/src/WasmEdge/lib/executor/engine/refInstr.cpp

Source
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright The WasmEdge Authors

#include "executor/executor.h"

namespace WasmEdge {
namespace Executor {

namespace {

template <typename... T>
ErrCode logError(const ErrCode &Code, const AST::Instruction &Instr,
                 T &&...F) noexcept {
  spdlog::error(Code);
  (F(), ...);
  spdlog::error(ErrInfo::InfoInstruction(Instr.getOpCode(), Instr.getOffset()));
  return Code;
}

ErrCode logError(const ErrCode &Code, const AST::Instruction &Instr) noexcept {
  spdlog::error(Code);
  spdlog::error(ErrInfo::InfoInstruction(Instr.getOpCode(), Instr.getOffset()));
  return Code;
}

void logArrayOOB(const ErrCode &Code, const uint32_t Idx, const uint32_t Cnt,
                 const RefVariant &Ref) noexcept {
  if (Code == ErrCode::Value::ArrayOutOfBounds) {
    const auto *Inst = Ref.getPtr<Runtime::Instance::ArrayInstance>();
    spdlog::error(ErrInfo::InfoBoundary(static_cast<uint64_t>(Idx), Cnt,
                                        Inst->getLength()));
  }
}

void logDoubleArrayOOB(const ErrCode &Code, const uint32_t Idx1,
                       const uint32_t Cnt1, const RefVariant &Ref1,
                       const uint32_t Idx2, const uint32_t Cnt2,
                       const RefVariant &Ref2) noexcept {
  if (Code == ErrCode::Value::ArrayOutOfBounds) {
    const auto *Inst1 = Ref1.getPtr<Runtime::Instance::ArrayInstance>();
    const auto *Inst2 = Ref2.getPtr<Runtime::Instance::ArrayInstance>();
    if (static_cast<uint64_t>(Idx1) + static_cast<uint64_t>(Cnt1) >
        Inst1->getLength()) {
      spdlog::error(ErrInfo::InfoBoundary(static_cast<uint64_t>(Idx1), Cnt1,
                                          Inst1->getLength()));
    } else if (static_cast<uint64_t>(Idx2) + static_cast<uint64_t>(Cnt2) >
               Inst2->getLength()) {
      spdlog::error(ErrInfo::InfoBoundary(static_cast<uint64_t>(Idx2), Cnt2,
                                          Inst2->getLength()));
    }
  }
}

void logMemoryOOB(const ErrCode &Code,
                  const Runtime::Instance::DataInstance &DataInst,
                  const uint32_t Idx, const uint32_t Length) noexcept {
  if (Code == ErrCode::Value::MemoryOutOfBounds) {
    spdlog::error(ErrInfo::InfoBoundary(
        static_cast<uint64_t>(Idx), Length,
        static_cast<uint32_t>(DataInst.getData().size())));
  }
}

void logTableOOB(const ErrCode &Code,
                 const Runtime::Instance::ElementInstance &ElemInst,
                 const uint32_t Idx, const uint32_t Length) noexcept {
  if (Code == ErrCode::Value::TableOutOfBounds) {
    auto ElemSrc = ElemInst.getRefs();
    spdlog::error(ErrInfo::InfoBoundary(static_cast<uint64_t>(Idx), Length,
                                        static_cast<uint32_t>(ElemSrc.size())));
  }
}

} // namespace

Expect<void> Executor::runRefNullOp(Runtime::StackManager &StackMgr,
                                    const ValType &Type) const noexcept {
  // A null reference is typed with the least type in its respective hierarchy.
  StackMgr.push(RefVariant(toBottomType(StackMgr.getModule(), Type)));
  return {};
}

Expect<void> Executor::runRefIsNullOp(ValVariant &Val) const noexcept {
  Val.emplace<uint32_t>(Val.get<RefVariant>().isNull() ? 1U : 0U);
  return {};
}

Expect<void> Executor::runRefFuncOp(Runtime::StackManager &StackMgr,
                                    uint32_t Idx) const noexcept {
  const auto *FuncInst = getFuncInstByIdx(StackMgr.getModule(), Idx);
  StackMgr.push(RefVariant(FuncInst->getDefType(), FuncInst));
  return {};
}

Expect<void> Executor::runRefEqOp(ValVariant &Val1,
                                  const ValVariant &Val2) const noexcept {
  Val1.emplace<uint32_t>(Val1.get<RefVariant>().getPtr<void>() ==
                                 Val2.get<RefVariant>().getPtr<void>()
                             ? 1U
                             : 0U);
  return {};
}

Expect<void>
Executor::runRefAsNonNullOp(RefVariant &Ref,
                            const AST::Instruction &Instr) const noexcept {
  if (Ref.isNull()) {
    return Unexpect(logError(ErrCode::Value::CastNullToNonNull, Instr));
  }
  Ref.getType().toNonNullableRef();
  return {};
}

Expect<void> Executor::runStructNewOp(Runtime::StackManager &StackMgr,
                                      const uint32_t TypeIdx,
                                      const bool IsDefault) const noexcept {
  if (IsDefault) {
    StackMgr.push(*structNew(StackMgr.getModule(), TypeIdx));
  } else {
    const auto &CompType = getCompositeTypeByIdx(StackMgr.getModule(), TypeIdx);
    const uint32_t N = static_cast<uint32_t>(CompType.getFieldTypes().size());
    std::vector<ValVariant> Vals = StackMgr.pop(N);
    StackMgr.push(*structNew(StackMgr.getModule(), TypeIdx, Vals));
  }
  return {};
}

Expect<void> Executor::runStructGetOp(Runtime::StackManager &StackMgr,
                                      const uint32_t TypeIdx,
                                      const uint32_t Off,
                                      const AST::Instruction &Instr,
                                      const bool IsSigned) const noexcept {
  const RefVariant Ref = StackMgr.getTop().get<RefVariant>();
  EXPECTED_TRY(auto Val,
               structGet(StackMgr.getModule(), Ref, TypeIdx, Off, IsSigned)
                   .map_error([&](auto E) { return logError(E, Instr); }));
  StackMgr.getTop() = Val;
  return {};
}

Expect<void>
Executor::runStructSetOp(Runtime::StackManager &StackMgr, const ValVariant &Val,
                         const uint32_t TypeIdx, const uint32_t Off,
                         const AST::Instruction &Instr) const noexcept {
  const RefVariant Ref = StackMgr.pop().get<RefVariant>();
  EXPECTED_TRY(structSet(StackMgr.getModule(), Ref, Val, TypeIdx, Off)
                   .map_error([&](auto E) { return logError(E, Instr); }));
  return {};
}

Expect<void> Executor::runArrayNewOp(Runtime::StackManager &StackMgr,
                                     const uint32_t TypeIdx,
                                     const uint32_t InitCnt,
                                     uint32_t Length) const noexcept {
  assuming(InitCnt == 0 || InitCnt == 1 || InitCnt == Length);
  if (InitCnt == 0) {
    StackMgr.push(*arrayNew(StackMgr.getModule(), TypeIdx, Length));
  } else if (InitCnt == 1) {
    StackMgr.getTop().emplace<RefVariant>(
        *arrayNew(StackMgr.getModule(), TypeIdx, Length, {StackMgr.getTop()}));
  } else {
    StackMgr.push(
        *arrayNew(StackMgr.getModule(), TypeIdx, Length, StackMgr.pop(Length)));
  }
  return {};
}

Expect<void>
Executor::runArrayNewDataOp(Runtime::StackManager &StackMgr,
                            const uint32_t TypeIdx, const uint32_t DataIdx,
                            const AST::Instruction &Instr) const noexcept {
  const uint32_t Length = StackMgr.pop().get<uint32_t>();
  const uint32_t Start = StackMgr.getTop().get<uint32_t>();
  EXPECTED_TRY(
      auto InstRef,
      arrayNewData(StackMgr.getModule(), TypeIdx, DataIdx, Start, Length)
          .map_error([&](auto E) {
            auto *DataInst = getDataInstByIdx(StackMgr.getModule(), DataIdx);
            const uint32_t BSize =
                getArrayStorageTypeByIdx(StackMgr.getModule(), TypeIdx)
                    .getBitWidth() /
                8;
            return logError(E, Instr, [&]() {
              return logMemoryOOB(E, *DataInst, Start, BSize * Length);
            });
          }));
  StackMgr.getTop().emplace<RefVariant>(InstRef);
  return {};
}

Expect<void>
Executor::runArrayNewElemOp(Runtime::StackManager &StackMgr,
                            const uint32_t TypeIdx, const uint32_t ElemIdx,
                            const AST::Instruction &Instr) const noexcept {
  const uint32_t Length = StackMgr.pop().get<uint32_t>();
  const uint32_t Start = StackMgr.getTop().get<uint32_t>();
  EXPECTED_TRY(
      auto InstRef,
      arrayNewElem(StackMgr.getModule(), TypeIdx, ElemIdx, Start, Length)
          .map_error([&](auto E) {
            auto *ElemInst = getElemInstByIdx(StackMgr.getModule(), ElemIdx);
            return logError(E, Instr, [&]() {
              return logTableOOB(E, *ElemInst, Start, Length);
            });
          }));
  StackMgr.getTop().emplace<RefVariant>(InstRef);
  return {};
}

Expect<void> Executor::runArrayGetOp(Runtime::StackManager &StackMgr,
                                     const uint32_t TypeIdx,
                                     const AST::Instruction &Instr,
                                     const bool IsSigned) const noexcept {
  const uint32_t Idx = StackMgr.pop().get<uint32_t>();
  const RefVariant Ref = StackMgr.getTop().get<RefVariant>();
  EXPECTED_TRY(auto Val,
               arrayGet(StackMgr.getModule(), Ref, TypeIdx, Idx, IsSigned)
                   .map_error([&](auto E) {
                     return logError(E, Instr, [&]() {
                       return logArrayOOB(E, Idx, 1, Ref);
                     });
                   }));
  StackMgr.getTop() = Val;
  return {};
}

Expect<void>
Executor::runArraySetOp(Runtime::StackManager &StackMgr, const ValVariant &Val,
                        const uint32_t TypeIdx,
                        const AST::Instruction &Instr) const noexcept {
  const uint32_t Idx = StackMgr.pop().get<uint32_t>();
  const RefVariant Ref = StackMgr.pop().get<RefVariant>();
  EXPECTED_TRY(arraySet(StackMgr.getModule(), Ref, Val, TypeIdx, Idx)
                   .map_error([&](auto E) {
                     return logError(E, Instr, [&]() {
                       return logArrayOOB(E, Idx, 1, Ref);
                     });
                   }));
  return {};
}

Expect<void>
Executor::runArrayLenOp(ValVariant &Val,
                        const AST::Instruction &Instr) const noexcept {
  const auto *Inst =
      Val.get<RefVariant>().getPtr<Runtime::Instance::ArrayInstance>();
  if (Inst == nullptr) {
    return Unexpect(logError(ErrCode::Value::AccessNullArray, Instr));
  }
  Val.emplace<uint32_t>(Inst->getLength());
  return {};
}

Expect<void>
Executor::runArrayFillOp(Runtime::StackManager &StackMgr, const uint32_t Cnt,
                         const ValVariant &Val, const uint32_t TypeIdx,
                         const AST::Instruction &Instr) const noexcept {
  const uint32_t Idx = StackMgr.pop().get<uint32_t>();
  const RefVariant Ref = StackMgr.pop().get<RefVariant>();
  EXPECTED_TRY(arrayFill(StackMgr.getModule(), Ref, Val, TypeIdx, Idx, Cnt)
                   .map_error([&](auto E) {
                     return logError(E, Instr, [&]() {
                       return logArrayOOB(E, Idx, Cnt, Ref);
                     });
                   }));
  return {};
}

Expect<void>
Executor::runArrayCopyOp(Runtime::StackManager &StackMgr, const uint32_t Cnt,
                         const uint32_t DstTypeIdx, const uint32_t SrcTypeIdx,
                         const AST::Instruction &Instr) const noexcept {
  const uint32_t SrcIdx = StackMgr.pop().get<uint32_t>();
  const RefVariant SrcRef = StackMgr.pop().get<RefVariant>();
  const uint32_t DstIdx = StackMgr.pop().get<uint32_t>();
  const RefVariant DstRef = StackMgr.pop().get<RefVariant>();
  EXPECTED_TRY(arrayCopy(StackMgr.getModule(), DstRef, DstTypeIdx, DstIdx,
                         SrcRef, SrcTypeIdx, SrcIdx, Cnt)
                   .map_error([&](auto E) {
                     return logError(E, Instr, [&]() {
                       return logDoubleArrayOOB(E, SrcIdx, Cnt, SrcRef, DstIdx,
                                                Cnt, DstRef);
                     });
                   }));
  return {};
}

Expect<void> Executor::runArrayInitDataOp(
    Runtime::StackManager &StackMgr, const uint32_t Cnt, const uint32_t TypeIdx,
    const uint32_t DataIdx, const AST::Instruction &Instr) const noexcept {
  const uint32_t SrcIdx = StackMgr.pop().get<uint32_t>();
  const uint32_t DstIdx = StackMgr.pop().get<uint32_t>();
  const RefVariant Ref = StackMgr.pop().get<RefVariant>();
  EXPECTED_TRY(
      arrayInitData(StackMgr.getModule(), Ref, TypeIdx, DataIdx, DstIdx, SrcIdx,
                    Cnt)
          .map_error([&](auto E) {
            auto *DataInst = getDataInstByIdx(StackMgr.getModule(), DataIdx);
            const uint32_t BSize =
                getArrayStorageTypeByIdx(StackMgr.getModule(), TypeIdx)
                    .getBitWidth() /
                8;
            return logError(
                E, Instr, [&]() { return logArrayOOB(E, DstIdx, Cnt, Ref); },
                [&]() {
                  return logMemoryOOB(E, *DataInst, SrcIdx, Cnt * BSize);
                });
          }));
  return {};
}

Expect<void> Executor::runArrayInitElemOp(
    Runtime::StackManager &StackMgr, const uint32_t Cnt, const uint32_t TypeIdx,
    const uint32_t ElemIdx, const AST::Instruction &Instr) const noexcept {
  const uint32_t SrcIdx = StackMgr.pop().get<uint32_t>();
  const uint32_t DstIdx = StackMgr.pop().get<uint32_t>();
  const RefVariant Ref = StackMgr.pop().get<RefVariant>();
  EXPECTED_TRY(
      arrayInitElem(StackMgr.getModule(), Ref, TypeIdx, ElemIdx, DstIdx, SrcIdx,
                    Cnt)
          .map_error([&](auto E) {
            auto *ElemInst = getElemInstByIdx(StackMgr.getModule(), ElemIdx);
            return logError(
                E, Instr, [&]() { return logArrayOOB(E, DstIdx, Cnt, Ref); },
                [&]() { return logTableOOB(E, *ElemInst, SrcIdx, Cnt); });
          }));
  return {};
}

Expect<void>
Executor::runRefTestOp(const Runtime::Instance::ModuleInstance *ModInst,
                       ValVariant &Val, const AST::Instruction &Instr,
                       const bool IsCast) const noexcept {
  // Copy the value type here due to handling the externalized case.
  auto VT = Val.get<RefVariant>().getType();
  if (VT.isExternalized()) {
    VT = ValType(VT.isNullableRefType() ? TypeCode::RefNull : TypeCode::Ref,
                 TypeCode::ExternRef);
  }
  Span<const AST::SubType *const> GotTypeList = ModInst->getTypeList();
  if (!VT.isAbsHeapType()) {
    auto *Inst =
        Val.get<RefVariant>().getPtr<Runtime::Instance::CompositeBase>();
    // Reference must not be nullptr here because the null references are typed
    // with the least abstract heap type.
    assuming(Inst);
    if (Inst->getModule()) {
      GotTypeList = Inst->getModule()->getTypeList();
    }
  }

  if (AST::TypeMatcher::matchType(ModInst->getTypeList(), Instr.getValType(),
                                  GotTypeList, VT)) {
    if (!IsCast) {
      Val.emplace<uint32_t>(1U);
    }
  } else {
    if (IsCast) {
      spdlog::error(ErrCode::Value::CastFailed);
      spdlog::error(ErrInfo::InfoMismatch(Instr.getValType(), VT));
      spdlog::error(
          ErrInfo::InfoInstruction(Instr.getOpCode(), Instr.getOffset()));
      return Unexpect(ErrCode::Value::CastFailed);
    } else {
      Val.emplace<uint32_t>(0U);
    }
  }
  return {};
}

Expect<void> Executor::runRefConvOp(RefVariant &Ref,
                                    TypeCode TCode) const noexcept {
  if (TCode == TypeCode::AnyRef) {
    // Internalize.
    if (Ref.isNull()) {
      Ref = RefVariant(ValType(TypeCode::RefNull, TypeCode::NullRef));
    } else {
      Ref.getType().setInternalized();
      if (Ref.getType().isExternRefType()) {
        Ref.getType() = ValType(TypeCode::Ref, TypeCode::AnyRef);
      }
    }
  } else {
    // Externalize.
    if (Ref.isNull()) {
      Ref = RefVariant(ValType(TypeCode::RefNull, TypeCode::NullExternRef));
    } else {
      // Use the externalize flag because the value type information should be
      // reserved when a reference being externalized and internalized.
      Ref.getType().setExternalized();
    }
  }
  return {};
}

Expect<void> Executor::runRefI31Op(ValVariant &Val) const noexcept {
  uint32_t RefNum = (Val.get<uint32_t>() & 0x7FFFFFFFU) | 0x80000000U;
  Val = RefVariant(ValType(TypeCode::Ref, TypeCode::I31Ref),
                   reinterpret_cast<void *>(static_cast<uint64_t>(RefNum)));
  return {};
}

Expect<void> Executor::runI31GetOp(ValVariant &Val,
                                   const AST::Instruction &Instr,
                                   const bool IsSigned) const noexcept {
  uint32_t RefNum = static_cast<uint32_t>(
      reinterpret_cast<uintptr_t>(Val.get<RefVariant>().getPtr<void>()));
  if ((RefNum & 0x80000000U) == 0) {
    return Unexpect(logError(ErrCode::Value::AccessNullI31, Instr));
  }
  RefNum &= 0x7FFFFFFFU;
  if (IsSigned) {
    RefNum |= ((RefNum & 0x40000000U) << 1);
  }
  Val.emplace<uint32_t>(RefNum);
  return {};
}

Expect<RefVariant>
Executor::structNew(const Runtime::Instance::ModuleInstance *ModInstArg,
                    const uint32_t TypeIdx,
                    Span<const ValVariant> Args) const noexcept {
  /// TODO: The array and struct instances are currently owned by the module
  /// instance because they refer to the defined types of the module instances.
  /// This may be changed after applying the garbage collection mechanism.
  const auto &CompType = getCompositeTypeByIdx(ModInstArg, TypeIdx);
  uint32_t N = static_cast<uint32_t>(CompType.getFieldTypes().size());
  auto *ModInst = const_cast<Runtime::Instance::ModuleInstance *>(ModInstArg);
  std::vector<ValVariant> Vals(N);
  for (uint32_t I = 0; I < N; I++) {
    const auto &VType = CompType.getFieldTypes()[I].getStorageType();
    if (Args.size() > 0) {
      Vals[I] = packVal(VType, Args[I]);
    } else {
      Vals[I] = VType.isRefType()
                    ? ValVariant(RefVariant(toBottomType(ModInstArg, VType)))
                    : ValVariant(static_cast<uint128_t>(0U));
    }
  }
  WasmEdge::Runtime::Instance::StructInstance *Inst =
      ModInst->newStruct(TypeIdx, std::move(Vals));
  return RefVariant(Inst->getDefType(), Inst);
}

Expect<ValVariant>
Executor::structGet(const Runtime::Instance::ModuleInstance *ModInst,
                    const RefVariant Ref, const uint32_t TypeIdx,
                    const uint32_t Off, const bool IsSigned) const noexcept {
  const auto *Inst = Ref.getPtr<Runtime::Instance::StructInstance>();
  if (Inst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullStruct);
  }
  const auto &VType = getStructStorageTypeByIdx(ModInst, TypeIdx, Off);
  return unpackVal(VType, Inst->getField(Off), IsSigned);
}

Expect<void>
Executor::structSet(const Runtime::Instance::ModuleInstance *ModInst,
                    const RefVariant Ref, const ValVariant Val,
                    const uint32_t TypeIdx, const uint32_t Off) const noexcept {
  auto *Inst = Ref.getPtr<Runtime::Instance::StructInstance>();
  if (Inst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullStruct);
  }
  const auto &VType = getStructStorageTypeByIdx(ModInst, TypeIdx, Off);
  Inst->getField(Off) = packVal(VType, Val);
  return {};
}

Expect<RefVariant>
Executor::arrayNew(const Runtime::Instance::ModuleInstance *ModInstArg,
                   const uint32_t TypeIdx, const uint32_t Length,
                   Span<const ValVariant> Args) const noexcept {
  /// TODO: The array and struct instances are currently owned by the module
  /// instance because they refer to the defined types of the module instances.
  /// This may be changed after applying the garbage collection mechanism.
  const auto &VType = getArrayStorageTypeByIdx(ModInstArg, TypeIdx);
  WasmEdge::Runtime::Instance::ArrayInstance *Inst = nullptr;
  auto *ModInst = const_cast<Runtime::Instance::ModuleInstance *>(ModInstArg);
  if (Args.size() == 0) {
    // New and fill with default values.
    auto InitVal = VType.isRefType()
                       ? ValVariant(RefVariant(toBottomType(ModInstArg, VType)))
                       : ValVariant(static_cast<uint128_t>(0U));
    Inst = ModInst->newArray(TypeIdx, Length, InitVal);
  } else if (Args.size() == 1) {
    // Create and fill with the argument value.
    Inst = ModInst->newArray(TypeIdx, Length, packVal(VType, Args[0]));
  } else {
    // Create with arguments.
    Inst = ModInst->newArray(
        TypeIdx,
        packVals(VType, std::vector<ValVariant>(Args.begin(), Args.end())));
  }
  return RefVariant(Inst->getDefType(), Inst);
}

Expect<RefVariant>
Executor::arrayNewData(const Runtime::Instance::ModuleInstance *ModInstArg,
                       const uint32_t TypeIdx, const uint32_t DataIdx,
                       const uint32_t Start,
                       const uint32_t Length) const noexcept {
  const auto &VType = getArrayStorageTypeByIdx(ModInstArg, TypeIdx);
  const uint32_t BSize = VType.getBitWidth() / 8;
  auto *DataInst = getDataInstByIdx(ModInstArg, DataIdx);
  assuming(DataInst);
  if (static_cast<uint64_t>(Start) + static_cast<uint64_t>(Length) * BSize >
      DataInst->getData().size()) {
    return Unexpect(ErrCode::Value::MemoryOutOfBounds);
  }
  auto *ModInst = const_cast<Runtime::Instance::ModuleInstance *>(ModInstArg);
  std::vector<ValVariant> Args;
  Args.reserve(Length);
  for (uint32_t Idx = 0; Idx < Length; Idx++) {
    // The value has been packed.
    Args.push_back(DataInst->loadValue(Start + Idx * BSize, BSize));
  }
  WasmEdge::Runtime::Instance::ArrayInstance *Inst =
      ModInst->newArray(TypeIdx, std::move(Args));
  return RefVariant(Inst->getDefType(), Inst);
}

Expect<RefVariant>
Executor::arrayNewElem(const Runtime::Instance::ModuleInstance *ModInstArg,
                       const uint32_t TypeIdx, const uint32_t ElemIdx,
                       const uint32_t Start,
                       const uint32_t Length) const noexcept {
  const auto &VType = getArrayStorageTypeByIdx(ModInstArg, TypeIdx);
  auto *ElemInst = getElemInstByIdx(ModInstArg, ElemIdx);
  assuming(ElemInst);
  auto ElemSrc = ElemInst->getRefs();
  if (static_cast<uint64_t>(Start) + static_cast<uint64_t>(Length) >
      ElemSrc.size()) {
    return Unexpect(ErrCode::Value::TableOutOfBounds);
  }
  std::vector<ValVariant> Refs(ElemSrc.begin() + Start,
                               ElemSrc.begin() + Start + Length);
  auto *ModInst = const_cast<Runtime::Instance::ModuleInstance *>(ModInstArg);
  WasmEdge::Runtime::Instance::ArrayInstance *Inst =
      ModInst->newArray(TypeIdx, packVals(VType, std::move(Refs)));
  return RefVariant(Inst->getDefType(), Inst);
}

Expect<ValVariant>
Executor::arrayGet(const Runtime::Instance::ModuleInstance *ModInst,
                   const RefVariant &Ref, const uint32_t TypeIdx,
                   const uint32_t Idx, const bool IsSigned) const noexcept {
  const auto *Inst = Ref.getPtr<Runtime::Instance::ArrayInstance>();
  if (Inst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullArray);
  }
  if (Idx >= Inst->getLength()) {
    return Unexpect(ErrCode::Value::ArrayOutOfBounds);
  }
  const auto &VType = getArrayStorageTypeByIdx(ModInst, TypeIdx);
  return unpackVal(VType, Inst->getData(Idx), IsSigned);
}

Expect<void>
Executor::arraySet(const Runtime::Instance::ModuleInstance *ModInst,
                   const RefVariant &Ref, const ValVariant &Val,
                   const uint32_t TypeIdx, const uint32_t Idx) const noexcept {
  auto *Inst = Ref.getPtr<Runtime::Instance::ArrayInstance>();
  if (Inst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullArray);
  }
  if (Idx >= Inst->getLength()) {
    return Unexpect(ErrCode::Value::ArrayOutOfBounds);
  }
  const auto &VType = getArrayStorageTypeByIdx(ModInst, TypeIdx);
  Inst->getData(Idx) = packVal(VType, Val);
  return {};
}

Expect<void>
Executor::arrayFill(const Runtime::Instance::ModuleInstance *ModInst,
                    const RefVariant &Ref, const ValVariant &Val,
                    const uint32_t TypeIdx, const uint32_t Idx,
                    const uint32_t Cnt) const noexcept {
  auto *Inst = Ref.getPtr<Runtime::Instance::ArrayInstance>();
  if (Inst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullArray);
  }
  if (static_cast<uint64_t>(Idx) + static_cast<uint64_t>(Cnt) >
      Inst->getLength()) {
    return Unexpect(ErrCode::Value::ArrayOutOfBounds);
  }
  const auto &VType = getArrayStorageTypeByIdx(ModInst, TypeIdx);
  auto Arr = Inst->getArray();
  std::fill(Arr.begin() + Idx, Arr.begin() + Idx + Cnt, packVal(VType, Val));
  return {};
}

Expect<void> Executor::arrayInitData(
    const Runtime::Instance::ModuleInstance *ModInst, const RefVariant &Ref,
    const uint32_t TypeIdx, const uint32_t DataIdx, const uint32_t DstIdx,
    const uint32_t SrcIdx, const uint32_t Cnt) const noexcept {
  auto *Inst = Ref.getPtr<Runtime::Instance::ArrayInstance>();
  if (Inst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullArray);
  }
  if (static_cast<uint64_t>(DstIdx) + static_cast<uint64_t>(Cnt) >
      Inst->getLength()) {
    return Unexpect(ErrCode::Value::ArrayOutOfBounds);
  }
  const auto &VType = getArrayStorageTypeByIdx(ModInst, TypeIdx);
  const uint32_t BSize = VType.getBitWidth() / 8;
  auto *DataInst = getDataInstByIdx(ModInst, DataIdx);
  assuming(DataInst);
  if (static_cast<uint64_t>(SrcIdx) + static_cast<uint64_t>(Cnt) * BSize >
      DataInst->getData().size()) {
    return Unexpect(ErrCode::Value::MemoryOutOfBounds);
  }

  for (uint32_t Idx = 0; Idx < Cnt; Idx++) {
    // The value has been packed.
    Inst->getData(DstIdx + Idx) =
        DataInst->loadValue(SrcIdx + Idx * BSize, BSize);
  }
  return {};
}

Expect<void> Executor::arrayInitElem(
    const Runtime::Instance::ModuleInstance *ModInst, const RefVariant &Ref,
    const uint32_t TypeIdx, const uint32_t ElemIdx, const uint32_t DstIdx,
    const uint32_t SrcIdx, const uint32_t Cnt) const noexcept {
  auto *Inst = Ref.getPtr<Runtime::Instance::ArrayInstance>();
  if (Inst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullArray);
  }
  if (static_cast<uint64_t>(DstIdx) + static_cast<uint64_t>(Cnt) >
      Inst->getLength()) {
    return Unexpect(ErrCode::Value::ArrayOutOfBounds);
  }
  const auto &VType = getArrayStorageTypeByIdx(ModInst, TypeIdx);
  auto *ElemInst = getElemInstByIdx(ModInst, ElemIdx);
  assuming(ElemInst);
  auto ElemSrc = ElemInst->getRefs();
  if (static_cast<uint64_t>(SrcIdx) + static_cast<uint64_t>(Cnt) >
      ElemSrc.size()) {
    return Unexpect(ErrCode::Value::TableOutOfBounds);
  }

  auto Arr = Inst->getArray();
  // The value has been packed.
  std::transform(ElemSrc.begin() + SrcIdx, ElemSrc.begin() + SrcIdx + Cnt,
                 Arr.begin() + DstIdx,
                 [&](const RefVariant &V) { return packVal(VType, V); });
  return {};
}

Expect<void>
Executor::arrayCopy(const Runtime::Instance::ModuleInstance *ModInst,
                    const RefVariant &DstRef, const uint32_t DstTypeIdx,
                    const uint32_t DstIdx, const RefVariant &SrcRef,
                    const uint32_t SrcTypeIdx, const uint32_t SrcIdx,
                    const uint32_t Cnt) const noexcept {
  auto *SrcInst = SrcRef.getPtr<Runtime::Instance::ArrayInstance>();
  auto *DstInst = DstRef.getPtr<Runtime::Instance::ArrayInstance>();
  if (SrcInst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullArray);
  }
  if (DstInst == nullptr) {
    return Unexpect(ErrCode::Value::AccessNullArray);
  }
  if (static_cast<uint64_t>(SrcIdx) + static_cast<uint64_t>(Cnt) >
      SrcInst->getLength()) {
    return Unexpect(ErrCode::Value::ArrayOutOfBounds);
  }
  if (static_cast<uint64_t>(DstIdx) + static_cast<uint64_t>(Cnt) >
      DstInst->getLength()) {
    return Unexpect(ErrCode::Value::ArrayOutOfBounds);
  }

  auto SrcArr = SrcInst->getArray();
  auto DstArr = DstInst->getArray();
  const auto &SrcVType = getArrayStorageTypeByIdx(ModInst, SrcTypeIdx);
  const auto &DstVType = getArrayStorageTypeByIdx(ModInst, DstTypeIdx);
  if (DstIdx <= SrcIdx) {
    std::transform(SrcArr.begin() + SrcIdx, SrcArr.begin() + SrcIdx + Cnt,
                   DstArr.begin() + DstIdx, [&](const ValVariant &V) {
                     return packVal(DstVType, unpackVal(SrcVType, V));
                   });
  } else {
    std::transform(std::make_reverse_iterator(SrcArr.begin() + SrcIdx + Cnt),
                   std::make_reverse_iterator(SrcArr.begin() + SrcIdx),
                   std::make_reverse_iterator(DstArr.begin() + DstIdx + Cnt),
                   [&](const ValVariant &V) {
                     return packVal(DstVType, unpackVal(SrcVType, V));
                   });
  }
  return {};
}

} // namespace Executor
} // namespace WasmEdge

Coverage Report

Created: 2026-09-28 06:22