Struct ArcArray 

pub struct ArcArray<T: Element, D: Dimension> { /* private fields */ }

A reference-counted N-dimensional array with copy-on-write semantics.

Multiple ArcArray instances can share the same underlying buffer. When a mutation is requested and the reference count is greater than 1, the buffer is cloned first (copy-on-write). Views derived from an ArcArray observe the data at creation time; subsequent mutations to the source (which trigger a CoW clone) do not affect existing views.

Implementations

impl<T: Element, D: Dimension> ArcArray<T, D>

pub fn from_owned(arr: Array<T, D>) -> Self

Create an ArcArray from an owned Array.

pub fn shape(&self) -> &[usize]

Shape as a slice.

pub fn ndim(&self) -> usize

Number of dimensions.

pub fn size(&self) -> usize

Total number of elements.

pub fn is_empty(&self) -> bool

Whether the array has zero elements.

pub fn strides(&self) -> &[isize]

Strides as a slice.

pub fn layout(&self) -> MemoryLayout

Memory layout.

pub fn dim(&self) -> &D

Return a reference to the dimension descriptor.

pub fn ref_count(&self) -> usize

Number of shared references to the underlying buffer.

pub fn is_unique(&self) -> bool

Whether this is the sole owner of the data (refcount == 1).

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

Get a slice of the data for this array.

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

Raw pointer to the first element.

pub fn view(&self) -> ArrayView<'_, T, D>

Create an immutable view of the data.

The view borrows from this ArcArray and will see the data as it exists at creation time. If the ArcArray is later mutated (triggering a CoW clone), the view continues to see the old data.

pub fn as_slice_mut(&mut self) -> &mut [T]

Get a mutable slice of the data, performing a CoW clone if necessary.

pub fn mapv_inplace(&mut self, f: impl Fn(T) -> T)

Apply a function to each element, performing CoW if needed.

pub fn into_owned(self) -> Array<T, D>

Convert to an owned Array, cloning if shared.

pub fn copy(&self) -> Self

Deep copy — always creates a new independent buffer.

pub fn flags(&self) -> ArrayFlags

Array flags.

Trait Implementations

impl<T: Element, D: Dimension> AsRawBuffer for ArcArray<T, D>

fn raw_ptr(&self) -> *const u8

Raw pointer to the first element.

fn raw_shape(&self) -> &[usize]

Shape as a slice of dimension sizes.

fn raw_strides_bytes(&self) -> Vec<isize>

Strides in bytes (not elements).

fn raw_dtype(&self) -> DType

Runtime dtype descriptor.

fn is_c_contiguous(&self) -> bool

Whether the data is C-contiguous.

fn is_f_contiguous(&self) -> bool

Whether the data is Fortran-contiguous.

impl<T: Element, D: Dimension> Clone for ArcArray<T, D>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Element, D: Dimension> Debug for ArcArray<T, D>

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

Formats the value using the given formatter.

impl<T: Element, D: Dimension> Display for ArcArray<T, D>

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

Formats the value using the given formatter.

impl<T: Element, D: Dimension> From<Array<T, D>> for ArcArray<T, D>

fn from(arr: Array<T, D>) -> Self

Converts to this type from the input type.