Struct Locator 

pub struct Locator { /* private fields */ }

A Locator encodes a path to a nested field as a sequence of 4-byte packed values (sfield codes or array indices) in a compact binary format understood by the host.

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() -> Locator

Create a new empty Locator.

pub fn pack(&mut self, sfield_or_index: impl Into<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: impl Into<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 Eq for Locator

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 StructuralPartialEq for Locator