Struct Formula 

pub struct Formula {
    pub text: String,
    pub expr: Option<Arc<Expr>>,
    pub array: Option<RangeRef>,
    pub dynamic: bool,
}

A parsed formula. text is the canonical formula text without the leading =.

Fields

text: String

expr: Option<Arc<Expr>>

array: Option<RangeRef>

Legacy array formula (Ctrl+Shift+Enter) covering this range; the formula lives in the top-left cell.

dynamic: bool

Read from a file that marks this formula as a dynamic-array formula (cell metadata cm). The writer keeps the mark, so a formula Excel evaluates as an array is never saved as a legacy formula (which Excel evaluates with implicit intersection). Formulas entered or rewritten in GridCraft start without it, and the writer decides from their shape.

Implementations

impl Formula

pub fn new(text: &str) -> Formula

Parses text (with or without =). Unparseable formulas keep their text and evaluate to #NAME?.

pub fn from_expr(e: Expr) -> Formula

pub fn expr(&self) -> Option<Expr>

The parsed expression, re-parsing after deserialization.

pub fn expr_arc(&self) -> Option<Arc<Expr>>

The parsed expression without copying it (re-parses after deserialization).

pub fn with_expr<R>(&self, f: impl FnOnce(&Expr) -> R) -> Option<R>

Runs f on the parsed expression, borrowing the cached tree or, after deserialization, a freshly parsed one that is dropped afterwards. Unlike expr it never copies the tree, and unlike expr_arc it needs no reference count or Arc allocation. None when the text does not parse.

Trait Implementations

impl Clone for Formula

fn clone(&self) -> Formula

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Formula

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Formula

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Formula

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Formula

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Formula