wasmtime_environ

Enum VMGcKind

source
#[repr(u32)]
pub enum VMGcKind { ExternRef = 1_073_741_824, AnyRef = 2_147_483_648, EqRef = 2_684_354_560, ArrayRef = 2_818_572_288, StructRef = 2_952_790_016, }
Expand description

The kind of an object in a GC heap.

Note that this type is accessed from Wasm JIT code.

VMGcKind is a bitset where to test if a is a subtype of an “abstract-ish” type b, we can simply use a single bitwise-and operation:

a <: b   iff   a & b == b

For example, because VMGcKind::AnyRef has the high bit set, every kind representing some subtype of anyref also has its high bit set.

We say “abstract-ish” type because in addition to the abstract heap types (other than i31) we also have variants for externrefs that have been converted into an anyref via extern.convert_any and externrefs that have been converted into an anyref via any.convert_extern. Note that in the latter case, because any.convert_extern $foo produces a value that is not an instance of eqref, VMGcKind::AnyOfExternRef & VMGcKind::EqRef != VMGcKind::EqRef.

Furthermore, this type only uses the highest 6 bits of its u32 representation, allowing the lower 27 bytes to be bitpacked with other stuff as users see fit.

Variants§

§

ExternRef = 1_073_741_824

§

AnyRef = 2_147_483_648

§

EqRef = 2_684_354_560

§

ArrayRef = 2_818_572_288

§

StructRef = 2_952_790_016

Implementations§

source§

impl VMGcKind

source

pub const MASK: u32 = 4_160_749_568u32

Mask this value with a u32 to get just the bits that VMGcKind uses.

source

pub const UNUSED_MASK: u32 = 134_217_727u32

Mask this value with a u32 that potentially contains a VMGcKind to get the bits that VMGcKind doesn’t use.

source

pub fn value_fits_in_unused_bits(value: u32) -> bool

Does the given value fit in the unused bits of a VMGcKind?

source

pub fn from_high_bits_of_u32(val: u32) -> VMGcKind

Convert the given value into a VMGcKind by masking off the unused bottom bits.

source

pub fn matches(self, other: Self) -> bool

Does this kind match the other kind?

That is, is this kind a subtype of the other kind?

source

pub fn as_u32(self) -> u32

Get this VMGcKind as a raw u32.

Trait Implementations§

source§

impl Clone for VMGcKind

source§

fn clone(&self) -> VMGcKind

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for VMGcKind

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl PartialEq for VMGcKind

source§

fn eq(&self, other: &VMGcKind) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Copy for VMGcKind

source§

impl Eq for VMGcKind

source§

impl StructuralPartialEq for VMGcKind

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

source§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.