Skip to main content

Value

Enum Value 

Source
pub enum Value {
    Empty,
    Number(f64),
    Percentage(f64),
    Currency(f64, Option<String>),
    Date(String),
    Time(String),
    Boolean(bool),
    Text(String),
}
Expand description

What a cell holds, as ODF types it.

The type is the cell’s own declaration and is independent of how it is shown: a date is a date whatever format it is displayed in, which is what makes a spreadsheet sortable.

Variants§

§

Empty

Nothing. A cell that exists to carry a style, or to be spanned over.

§

Number(f64)

A number.

§

Percentage(f64)

A number that means a proportion: 0.15 shown as 15%.

§

Currency(f64, Option<String>)

An amount of money, with the currency code where the cell names one.

§

Date(String)

A date, as written: an ISO 8601 date or date and time.

§

Time(String)

A duration, as written: an ISO 8601 duration.

§

Boolean(bool)

True or false.

§

Text(String)

Text.

Implementations§

Source§

impl Value

Source

pub fn from_input(input: &str) -> Self

What a person typed into a cell, read the way a spreadsheet reads it: a number is a number, true and false are booleans, nothing is empty, and anything else is text.

A formula is not recognised here, because nothing in this version evaluates one; text beginning with = is text. Percentages, currencies and dates need the document’s number formats to read and are text too.

Source

pub fn input_text(&self) -> String

The text a person edits for the value: a number’s plain spelling, a date’s or a duration’s ISO form, TRUE and FALSE, the text itself. What Self::from_input reads back into the same value where it can, which is not everywhere: a percentage, a currency or a date typed again comes back as the number or the text it reads as, because reading it as what it was needs the number format the cell carries.

Source

pub fn cached_text(&self) -> String

The text a cell shows for the value, as this crate formats it: the shortest spelling of a number, TRUE and FALSE, the text itself. A document’s own number format is not applied; a spreadsheet application reformats the cell from the value when it next opens the file.

Source

pub fn is_numeric(&self) -> bool

Whether the value is one a spreadsheet puts against the right edge of its cell: every type but text, which is ODF’s own rule and every application’s default.

Trait Implementations§

Source§

impl Clone for Value

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Value

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for Value

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Value

Auto Trait Implementations§

§

impl Freeze for Value

§

impl RefUnwindSafe for Value

§

impl Send for Value

§

impl Sync for Value

§

impl Unpin for Value

§

impl UnsafeUnpin for Value

§

impl UnwindSafe for Value

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.