Struct ShapeArray 

pub struct ShapeArray { /* private fields */ }

Unified array with C-ABI-stable layout for JIT and VM.

Elements are ValueWord values stored in a contiguous heap buffer. Clone/Drop correctly manage heap-tagged ValueWord reference counts.

Implementations

impl ShapeArray

Byte offsets for JIT inline access.

pub const OFFSET_DATA: usize = 0

Byte offset of the data pointer field.

pub const OFFSET_LEN: usize = 8

Byte offset of the len field.

pub const OFFSET_CAP: usize = 16

Byte offset of the cap field.

impl ShapeArray

pub fn new() -> Self

Create an empty array with no allocation.

pub fn with_capacity(cap: usize) -> Self

Create an array with pre-allocated capacity.

pub fn from_iter(iter: impl IntoIterator<Item = ValueWord>) -> Self

Create an array from an iterator of ValueWord values.

pub fn from_vec(vec: Vec<ValueWord>) -> Self

Create an array from an owned Vec<ValueWord>.

pub fn from_slice(elements: &[ValueWord]) -> Self

Create an array by cloning from a slice of ValueWord.

pub unsafe fn from_raw_u64_slice(elements: &[u64]) -> Self

Create from a raw u64 slice (for JIT interop).

Safety

The caller must ensure that each u64 is a valid ValueWord bit pattern. For heap-tagged values, the caller must ensure the Arc refcount has been incremented appropriately (or that this array takes ownership).

pub fn len(&self) -> usize

Number of elements.

pub fn is_empty(&self) -> bool

Check if empty.

pub fn capacity(&self) -> usize

Allocated capacity.

pub fn as_slice(&self) -> &[ValueWord]

View elements as a slice.

pub fn as_mut_slice(&mut self) -> &mut [ValueWord]

View elements as a mutable slice.

pub fn as_raw_u64_slice(&self) -> &[u64]

View raw buffer as u64 slice (for JIT interop).

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

Raw pointer to the data buffer (for JIT inline access).

pub fn as_mut_ptr(&mut self) -> *mut ValueWord

Raw mutable pointer to the data buffer (for JIT inline access).

pub fn get(&self, index: usize) -> Option<&ValueWord>

Get element by index (bounds-checked).

pub fn push(&mut self, value: ValueWord)

Push an element (amortized O(1) with doubling growth).

pub fn pop(&mut self) -> Option<ValueWord>

Pop the last element.

pub fn iter(&self) -> Iter<'_, ValueWord>

Iterate over elements.

pub fn first(&self) -> Option<&ValueWord>

Get first element.

pub fn last(&self) -> Option<&ValueWord>

Get last element.

pub fn to_vec(&self) -> Vec<ValueWord>

Convert to Vec (copies the data).

pub fn into_vec(self) -> Vec<ValueWord>

Consume and convert into Vec (transfers ownership, no copy).

Trait Implementations

impl Clone for ShapeArray

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ShapeArray

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

Formats the value using the given formatter.

impl Default for ShapeArray

fn default() -> Self

Returns the “default value” for a type.

impl Drop for ShapeArray

fn drop(&mut self)

Executes the destructor for this type.

impl From<Arc<Vec<ValueWord>>> for ShapeArray

fn from(arc: Arc<Vec<ValueWord>>) -> Self

Convert from the legacy VMArray (Arc<Vec<ValueWord>>). Clones the elements since the Arc may be shared.

impl From<ShapeArray> for Vec<ValueWord>

fn from(arr: ShapeArray) -> Self

Converts to this type from the input type.

impl From<Vec<ValueWord>> for ShapeArray

fn from(vec: Vec<ValueWord>) -> Self

Converts to this type from the input type.

impl Index<usize> for ShapeArray

type Output = ValueWord

The returned type after indexing.

fn index(&self, index: usize) -> &ValueWord

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for ShapeArray

fn index_mut(&mut self, index: usize) -> &mut ValueWord

Performs the mutable indexing (container[index]) operation.

impl<'a> IntoIterator for &'a ShapeArray

type Item = &'a ValueWord

The type of the elements being iterated over.

type IntoIter = Iter<'a, ValueWord>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for ShapeArray

fn eq(&self, other: &Self) -> 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 Send for ShapeArray

impl Sync for ShapeArray