Struct IndexedFamily 

pub struct IndexedFamily<'a, K = IndexKey, F = VarFamily> { /* private fields */ }

Indexed family: maps an IndexKey to a single-element Expr (a variable or a parameter), tagged with the key type K its domain decodes to and the family kind F.

You normally name this through the IndexedVar/IndexedParam aliases, constructed by the indexed form of the variable!/param! macros.

When the domain is a contiguous integer range (or a Cartesian product of ranges) the family is stored densely (see the internal Storage). String, sparse, and filtered families fall back to a hash map.

Implementations

impl<'a, K, F> IndexedFamily<'a, K, F>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn is_dense(&self) -> bool

Whether this family is stored densely (domain was a range or product of ranges).

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

Per-axis lengths when stored densely, else None.

pub fn iter(&self) -> impl Iterator<Item = (&IndexKey, &Expr<'a>)> + '_

pub fn get<Q: Into<IndexKey>>(&self, key: Q) -> Option<Expr<'a>>

pub fn at<const N: usize>(&self, coords: [usize; N]) -> Expr<'a>

Zero-allocation typed index by integer coordinates. On a dense family this maps straight to a flat offset with no IndexKey built. On a sparse family it falls back to building a key.

Panics

Panics if the coordinates are out of range/not present.

pub fn get_at<const N: usize>(&self, coords: [usize; N]) -> Option<Expr<'a>>

Fallible form of Self::at.

impl<'a, K: FromIndexKey, F> IndexedFamily<'a, K, F>

pub fn keys(&self) -> impl Iterator<Item = (K, Expr<'a>)> + '_

Iterate the family’s entries with each key decoded to the typed K.

Trait Implementations

impl<'a, K, F> Clone for IndexedFamily<'a, K, F>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, K, F: Family> Debug for IndexedFamily<'a, K, F>

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

Formats the value using the given formatter.

impl<'a, K, F> Index<&IndexKey> for IndexedFamily<'a, K, F>

type Output = Expr<'a>

The returned type after indexing.

fn index(&self, key: &IndexKey) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'a, K, F, Q: Into<IndexKey>> Index<Q> for IndexedFamily<'a, K, F>

type Output = Expr<'a>

The returned type after indexing.

fn index(&self, key: Q) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'a, K, F, const N: usize> Index<[usize; N]> for IndexedFamily<'a, K, F>

type Output = Expr<'a>

The returned type after indexing.

fn index(&self, coords: [usize; N]) -> &Self::Output

Performs the indexing (container[index]) operation.