Enum OwnedValue 

#[non_exhaustive]
pub enum OwnedValue {
    Empty,
    Bool(bool),
    Int(i64),
    Float(f64),
    Decimal(Decimal),
    Text(Arc<str>),
    Timestamp(DateTime<Utc>),
    Custom(Arc<dyn GridValue>),
}

An owned cell value: a group key kept across snapshots, an aggregate result.

Two values are equal exactly when CellValue::cmp_total calls them equal, and equal values hash alike: Int(1) == Float(1.0), while -0.0 and 0.0 are two values and a NaN equals only itself, bit for bit. A Decimal equals the numbers of its value: Decimal(1.00) == Int(1), Decimal(0.5) == Float(0.5).

Serialized as JSON-like data: Empty as null, Bool as a boolean, Int as an integer, Float as a number with a fraction or an exponent (1.0, never 1, so it reads back as a Float), Text as a string, Decimal as {"decimal": "12.30"}, text that keeps the scale, Timestamp as {"timestamp": "2026-11-04T12:34:56Z"}, RFC 3339 in UTC with the fraction it has. A NaN, an infinity or a timestamp outside the years 0 to 9999 is not serialized: writing one fails. A string reads back as Text, never as a timestamp.

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

No value.

Bool(bool)

A boolean.

Int(i64)

An integer.

Float(f64)

A floating point number.

Decimal(Decimal)

An exact decimal number with its scale. Needs the decimal feature.

Text(Arc<str>)

Text.

Timestamp(DateTime<Utc>)

A point in time.

Custom(Arc<dyn GridValue>)

A value of the application’s own type, shared: what GridValue::to_owned_value returns to keep its order and text. Two are equal when GridValue::cmp_value says so; it hashes by its type. Serialized as its GridValue::export_value, else as its text, and read back as that: a restored layout’s group of a custom key does not find the group again.

Implementations

impl OwnedValue

pub fn custom(value: impl GridValue) -> Self

A value of the application’s own type, kept as itself: for GridValue::to_owned_value, usually OwnedValue::custom(self.clone()). Allocates once.

pub fn from_cell(value: CellValue<'_>) -> Self

Copies a borrowed value; allocates only for Text and Icon, and for Custom as its GridValue::to_owned_value does. An Icon becomes the Text of its text: the icon is the cell’s look, its text the value.

pub fn as_cell(&self) -> CellValue<'_>

Borrows the value back, to show it as a cell does or to compare it.

pub fn cmp_total(&self, other: &Self) -> Ordering

The order of CellValue::cmp_total.

Trait Implementations

impl Clone for OwnedValue

fn clone(&self) -> OwnedValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OwnedValue

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for OwnedValue

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Hash for OwnedValue

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 PartialEq for OwnedValue

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for OwnedValue

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Eq for OwnedValue