Enum CellValue 

#[non_exhaustive]
pub enum CellValue {
    Empty,
    Text(String),
    Integer(i64),
    Number(f64),
    Bool(bool),
    DateTime(CellDateTime),
    Duration(CellDuration),
    Error(CellError),
    Unsupported {
        display: String,
        reason: String,
    },
}

Typed representation of a spreadsheet cell value (RFC-033 §2).

Integer and Number are kept distinct (reflecting calamine’s Data::Int / Data::Float). Default comparison treats Integer(1) vs Number(1.0) as a TypeChanged difference; cross-type numeric equality is opt-in (RFC-019).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Empty

Text(String)

Integer(i64)

Cannot occur through any .xlsx input this crate accepts: calamine’s Xlsx reader routes every numeric cell through Data::Float, never Data::Int. A match arm on this variant is unreachable today; it is retained against future input-format support, not as a live case.

Number(f64)

Bool(bool)

DateTime(CellDateTime)

Duration(CellDuration)

Cannot occur through any .xlsx input this crate accepts: the only calamine source this maps from, Data::DurationIso, is emitted by calamine’s ODS reader only, and this crate opens workbooks exclusively via calamine::Xlsx (open.rs). A match arm on this variant is unreachable today; it is retained against future input-format support, not as a live case.

Error(CellError)

Unsupported

Cannot occur: nothing in this crate constructs Unsupported. A match arm on this variant is unreachable today; it is retained as a forward-compatible catch-all for a future cell shape with no typed representation here, not as a live case.

Fields

display: String

reason: String

Implementations

impl CellValue

pub fn display_string(&self) -> String

A human-readable display string. For use in reports only; never used as an equality key.

pub fn is_empty(&self) -> bool

True if the value is Empty.

pub fn display_default(&self) -> String

Alias for display_string — preferred name per RFC-020.

Trait Implementations

impl Clone for CellValue

fn clone(&self) -> CellValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CellValue

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

Formats the value using the given formatter.

impl PartialEq for CellValue

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CellValue