File: CanonicalCall.swift

package info (click to toggle)
swiftlang 6.2.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 2,856,264 kB
  • sloc: cpp: 9,995,718; ansic: 2,234,019; asm: 1,092,167; python: 313,940; objc: 82,726; f90: 80,126; lisp: 38,373; pascal: 25,580; sh: 20,378; ml: 5,058; perl: 4,751; makefile: 4,725; awk: 3,535; javascript: 3,018; xml: 918; fortran: 664; cs: 573; ruby: 396
file content (77 lines) | stat: -rw-r--r-- 2,751 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
@_exported import WasmTypes

/// Error type for canonical ABI operations.
public struct CanonicalABIError: Error, CustomStringConvertible {
    public let description: String

    @_documentation(visibility: internal)
    public init(description: String) {
        self.description = description
    }
}

/// Call context for `(canon lift)` or `(canon lower)` operations.
/// This type corresponds to `CallContext` in the Canonical ABI spec.
///
/// > Note:
/// <https://github.com/WebAssembly/component-model/blob/main/design/mvp/CanonicalABI.md#runtime-state>
public struct CanonicalCallContext {
    /// The options used for lifting or lowering operations.
    public let options: CanonicalOptions
    /// The module instance that defines the lift/lower operation.
    public let instance: Instance
    /// A reference to the guest memory.
    public var guestMemory: Memory {
        options.memory
    }

    public init(options: CanonicalOptions, instance: Instance) {
        self.options = options
        self.instance = instance
    }

    /// Call `cabi_realloc` export with the given arguments.
    public func realloc(
        old: UInt32,
        oldSize: UInt32,
        oldAlign: UInt32,
        newSize: UInt32
    ) throws -> UnsafeGuestRawPointer {
        guard let realloc = options.realloc else {
            throw CanonicalABIError(description: "Missing required \"cabi_realloc\" export")
        }
        let results = try realloc(
            [.i32(old), .i32(oldSize), .i32(oldAlign), .i32(newSize)]
        )
        guard results.count == 1 else {
            throw CanonicalABIError(description: "\"cabi_realloc\" export should return a single value")
        }
        guard case let .i32(new) = results[0] else {
            throw CanonicalABIError(description: "\"cabi_realloc\" export should return an i32 value")
        }
        return UnsafeGuestRawPointer(memorySpace: guestMemory, offset: new)
    }
}

extension CanonicalCallContext {
    @available(*, deprecated, renamed: "instance")
    public var moduleInstance: Instance {
        return instance
    }

    @available(*, deprecated, renamed: "init(options:instance:)")
    public init(options: CanonicalOptions, moduleInstance: Instance, runtime: Runtime) {
        self.init(options: options, instance: moduleInstance)
    }
}

@available(*, deprecated, renamed: "Memory", message: "WasmKitGuestMemory has been removed; use Memory instead")
public typealias WasmKitGuestMemory = Memory

extension Memory {
    /// Creates a new memory instance from the given store and address
    @available(*, unavailable, message: "WasmKitGuestMemory has been removed; use Memory instead")
    public init(store: Store, memory: Memory) {
        fatalError()
    }
}