Struct Locator 

pub struct Locator { /* private fields */ }

A Locator allows a WASM developer located any field in any object (even nested fields) by specifying a slot_num (1 byte); a locator_field_type (1 byte); then one of an sfield (4 bytes) or an index (4 bytes).

Derived Traits

• Debug: Useful for development and debugging
• Clone: Reasonable for this 72-byte struct when explicit copying is needed
• Eq, PartialEq: Enable comparisons between locators

Note: Copy is intentionally not derived due to the struct’s size (72 bytes). Large Copy types can lead to accidental expensive copies and poor performance. Use .clone() when you need to duplicate a locator.

Implementations

impl Locator

pub fn new_with_slot(slot_num: u8) -> Locator

Create a new Locator using an unsigned 8-bit slot number. Valid slots are 0 to 255.

pub fn new() -> Locator

Create a new Locator. Valid slots are 0 to 255.

pub fn pack(&mut self, sfield_or_index: i32) -> bool

pub fn as_ptr(&self) -> *const u8

pub fn num_packed_bytes(&self) -> usize

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn repack_last(&mut self, sfield_or_index: i32) -> bool

Trait Implementations

impl Clone for Locator

fn clone(&self) -> Locator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Locator

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

Formats the value using the given formatter.

impl Default for Locator

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Locator

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for Locator

impl StructuralPartialEq for Locator