Enum Ref 

pub enum Ref {
    Cell {
        sheet: Option<String>,
        addr: CellAddr,
    },
    Range {
        sheet: Option<String>,
        start: CellAddr,
        end: CellAddr,
    },
    Name(String),
}

A parsed reference. Resolution (what the reference evaluates to) is delegated to the embedding application; see the workbook v1 scope ADR.

Variants

Cell

A single cell, optionally sheet-qualified: A1, Sheet1!A1, 'Q2 Data'!A1.

Fields

sheet: Option<String>

Sheet name without quoting/escaping; None for a bare A1 reference.

addr: CellAddr

Range

A rectangular range, optionally sheet-qualified: A1:D4, Sheet1!A1:B2.

Fields

sheet: Option<String>

Sheet name without quoting/escaping; None for a bare range.

start: CellAddr

end: CellAddr

Name(String)

A named reference (named range, defined name): TAX_RATE.

Implementations

impl Ref

pub fn classify(text: &str) -> Ref

Classify a bare identifier or range string into a Ref.

"A1" → Ref::Cell (no sheet), "A1:D4" → Ref::Range (no sheet), anything else → Ref::Name. This is the mapping used for bare identifiers in formulas, which stay crate::Expr::Variable nodes in the AST for compatibility.

pub fn relative_display(&self) -> String

Canonical text with all $ anchors stripped — an identity/lookup key where $ must not affect equality (e.g. resolver-override lookups, dependency-graph dedup). Built structurally (zeroing col_abs/ row_abs before formatting), not by string-replacing $ out of the rendered text, so a quoted sheet name that legitimately contains a literal $ is not corrupted.

Trait Implementations

impl Clone for Ref

fn clone(&self) -> Ref

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ref

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

Formats the value using the given formatter.

impl Display for Ref

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

Canonical text form per the workbook JSON schema v1 spec: sheet name single-quoted iff it is not a bare identifier or would parse as an A1 address; embedded single quotes doubled ('').

impl PartialEq for Ref

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Ref