Struct CellRef 

pub struct CellRef {
    pub sheet: String,
    pub addr: Address,
}

A fully resolved cell coordinate: a sheet (by its position-independent, case-folded name) and an in-bounds Address.

Sheets are keyed by folded name, not tab index, so the key survives a sheet move (P3.1 move_sheet) and matches the case-insensitive sheet lookup of Workbook::sheet. A rename changes the key, which is why a rename forces a graph rebuild (see the module docs and DependencyGraph::build).

Fields

sheet: String

The target sheet’s name, simple-case-folded (schema spec §2).

addr: Address

The in-bounds A1 address within that sheet.

Implementations

impl CellRef

pub fn from_display_name(sheet: &str, addr: Address) -> Self

Builds the graph key for addr on the sheet named sheet, applying the simple case folding (schema spec §2) the graph indexes sheets by.

Named from_display_name — not resolve — because it does not consult a Workbook: it only folds the caller’s spelling into the graph’s key form, the same way new builds a CellRef from an already-folded one. resolve_ref and resolve_query_cell elsewhere in this crate do look a sheet up against a workbook; this does not, so it does not share their name.

The sheet field is public but holds a folded name, so a CellRef constructed literally from a user-facing sheet name (a tab label, a JSON key, an API argument) silently matches nothing in the graph whenever that name is not already folded. Any sheet name that did not come out of the graph itself should reach a query through here.

Folding is idempotent, so passing an already-folded name is a no-op. The sheet is not required to exist — an unknown sheet simply produces a key nothing in the graph matches.

Trait Implementations

impl Clone for CellRef

fn clone(&self) -> CellRef

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CellRef

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

Formats the value using the given formatter.

impl Eq for CellRef

impl Hash for CellRef

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for CellRef

fn cmp(&self, other: &CellRef) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for CellRef

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for CellRef

fn partial_cmp(&self, other: &CellRef) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for CellRef