Struct Array 

pub struct Array {
    pub shape: Vec<usize>,
    pub data: Data,
    /* private fields */
}

An array: a logical shape, a flat buffer, and the layout joining them.

data is the buffer as it lies. A reader that indexes it must either honour Array::layout or take Array::to_row_major first; the runtime’s rule is that a value reaching a verb has already been made row-major unless that verb asked for the other one.

Fields

shape: Vec<usize>

data: Data

Implementations

impl Array

pub fn new(shape: Vec<usize>, data: Data) -> Array

pub fn col_major(shape: Vec<usize>, data: Data) -> Array

An array whose buffer holds its first axis fastest — the columns of a matrix, end to end. Rank 0 and 1 have only one layout and take it.

pub fn with_layout(self, layout: Layout) -> Array

The same buffer read the other way round. The caller is asserting that the buffer really is in layout order for this shape.

pub fn layout(&self) -> Layout

How this array’s buffer is ordered.

pub fn is_row_major(&self) -> bool

pub fn row_major_data(&self) -> &Data

The flat buffer, for a reader that indexes it row-major. Debug builds refuse a buffer that is not in that order, which is what keeps a column-major table from being read as if it were rows.

pub fn to_row_major(&self) -> Array

This array with its elements in row-major order, materialising them once if they are not. Already row-major: a refcount bump.

pub fn scalar_i64(v: i64) -> Array

pub fn scalar_f64(v: f64) -> Array

pub fn scalar_bool(v: bool) -> Array

pub fn from_i64(values: Vec<i64>) -> Array

pub fn from_f64(values: Vec<f64>) -> Array

pub fn from_chars(values: Vec<char>) -> Array

pub fn empty(dtype: DType) -> Array

pub fn boxed(value: Array) -> Array

y as a scalar box (J <).

pub fn box_fill() -> Array

The element that fills a boxed array: J’s a:, a box holding an empty numeric list.

pub fn dtype(&self) -> DType

pub fn rank(&self) -> usize

pub fn count(&self) -> usize

Total number of elements.

pub fn items(&self) -> usize

Number of items (major cells): leading axis length, 1 for a scalar.

pub fn item_size(&self) -> usize

Elements per item.

pub fn cast(&self, to: DType) -> Option<Array>

Widen the elements. A cast reads and writes the buffer as it lies, so the layout comes through untouched.

pub fn cells(&self, frame_rank: usize) -> Vec<Array>

Split into cells: the trailing cell_rank axes form the cell shape, the leading axes form the frame.

pub fn cell_at(&self, frame_rank: usize, index: usize) -> Array

One cell without materialising all of them.

pub fn item(&self, i: usize) -> Array

Item i (major cell along the leading axis).

pub fn as_i64_slice(&self) -> Option<&[i64]>

pub fn as_boxes(&self) -> Option<&[Array]>

The boxed elements, if the array holds boxes.

pub fn as_f64_slice(&self) -> Option<&[f64]>

pub fn as_ext_slice(&self) -> Option<&[Ext]>

The extended integers, if the array holds them.

pub fn as_rat_slice(&self) -> Option<&[Rat]>

The rationals, if the array holds them.

pub fn as_complex_slice(&self) -> Option<&[Cx]>

pub fn to_complex_vec(&self) -> Option<Vec<Cx>>

Numeric contents widened to complex. None for character or boxed data.

pub fn to_f64_vec(&self) -> Option<Vec<f64>>

Numeric contents widened to f64. None for character data.

pub fn to_i64_vec(&self) -> Option<Vec<i64>>

Numeric contents as i64 if exactly representable.

Trait Implementations

impl Clone for Array

fn clone(&self) -> Array

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Array

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

Formats the value using the given formatter.

impl PartialEq for Array

Two arrays are equal when they hold the same elements at the same indices, whatever buffer order each of them keeps.

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

Equality operator ==.

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

Inequality operator !=.