Struct StringArray 

pub struct StringArray<D: Dimension> { /* private fields */ }

A specialized N-dimensional array of strings.

Unlike ferray_core::Array, this type does not require Element — it stores Vec<String> directly with shape metadata for indexing.

The data is stored in row-major (C) order.

Implementations

impl<D: Dimension> StringArray<D>

pub fn from_vec(dim: D, data: Vec<String>) -> FerrayResult<Self>

Create a new StringArray from a flat vector of strings and a shape.

Errors

Returns FerrayError::ShapeMismatch if data.len() does not equal the product of the shape dimensions.

pub fn empty(dim: D) -> FerrayResult<Self>

Create a StringArray filled with empty strings.

Errors

This function is infallible for valid shapes but returns Result for API consistency.

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

Return the shape as a slice.

pub fn ndim(&self) -> usize

Return the number of dimensions.

pub fn len(&self) -> usize

Return the total number of elements.

pub fn is_empty(&self) -> bool

Return true if the array has no elements.

pub fn dim(&self) -> &D

Return a reference to the dimension descriptor.

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

Return a reference to the flat data.

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

Return a mutable reference to the flat data.

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

Consume self and return the underlying Vec<String>.

pub fn map<F>(&self, f: F) -> FerrayResult<StringArray<D>>

where F: Fn(&str) -> String,

Apply a function to each element, producing a new StringArray.

pub fn map_to_vec<T, F>(&self, f: F) -> Vec<T>

where F: Fn(&str) -> T,

Apply a function to each element, producing a Vec<T>.

This is a lower-level helper used by search and boolean operations that need to produce typed arrays (e.g., Array<bool, D>).

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

Iterate over all elements.

impl StringArray<Ix1>

pub fn from_slice(items: &[&str]) -> FerrayResult<Self>

Create a 1-D StringArray from a slice of string-like values.

Examples

let a = StringArray1::from_slice(&["hello", "world"]).unwrap();

impl StringArray<Ix2>

pub fn from_rows(rows: &[&[&str]]) -> FerrayResult<Self>

Create a 2-D StringArray from nested slices.

Errors

Returns FerrayError::ShapeMismatch if inner slices have different lengths.

impl StringArray<IxDyn>

pub fn from_vec_dyn(shape: &[usize], data: Vec<String>) -> FerrayResult<Self>

Create a dynamic-rank StringArray from a flat vec and a dynamic shape.

Trait Implementations

impl<D: Clone + Dimension> Clone for StringArray<D>

fn clone(&self) -> StringArray<D>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<D: Debug + Dimension> Debug for StringArray<D>

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

Formats the value using the given formatter.

impl<D: Dimension> PartialEq for StringArray<D>

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<D: Dimension> Eq for StringArray<D>