Enum toml_edit::easy::value::Value

pub enum Value {
    Integer(i64),
    Float(f64),
    Boolean(bool),
    Datetime(Datetime),
    String(String),
    Array(Array),
    Table(Table),
}

Representation of a TOML value.

Variants

Integer(i64)

Represents a TOML integer

Float(f64)

Represents a TOML float

Boolean(bool)

Represents a TOML boolean

Datetime(Datetime)

Represents a TOML datetime

String(String)

Represents a TOML string

Array(Array)

Represents a TOML array

Table(Table)

Represents a TOML table

Implementations

impl Value

pub fn try_from<T>(value: T) -> Result<Value, TomlError> where
    T: Serialize, 

Convert a T into toml::Value which is an enum that can represent any valid TOML data.

This conversion can fail if T’s implementation of Serialize decides to fail, or if T contains a map with non-string keys.

pub fn try_into<T>(self) -> Result<T, TomlError> where
    T: DeserializeOwned, 

Interpret a toml::Value as an instance of type T.

This conversion can fail if the structure of the Value does not match the structure expected by T, for example if T is a struct type but the Value contains something other than a TOML table. It can also fail if the structure is correct but T’s implementation of Deserialize decides that something is wrong with the data, for example required struct fields are missing from the TOML map or some number is too big to fit in the expected primitive type.

pub fn get<I: Index>(&self, index: I) -> Option<&Value>

Index into a TOML array or map. A string index can be used to access a value in a map, and a usize index can be used to access an element of an array.

Returns None if the type of self does not match the type of the index, for example if the index is a string and self is an array or a number. Also returns None if the given key does not exist in the map or the given index is not within the bounds of the array.

pub fn get_mut<I: Index>(&mut self, index: I) -> Option<&mut Value>

Mutably index into a TOML array or map. A string index can be used to access a value in a map, and a usize index can be used to access an element of an array.

Returns None if the type of self does not match the type of the index, for example if the index is a string and self is an array or a number. Also returns None if the given key does not exist in the map or the given index is not within the bounds of the array.

pub fn as_integer(&self) -> Option<i64>

Extracts the integer value if it is an integer.

pub fn is_integer(&self) -> bool

Tests whether this value is an integer.

pub fn as_float(&self) -> Option<f64>

Extracts the float value if it is a float.

pub fn is_float(&self) -> bool

Tests whether this value is a float.

pub fn as_bool(&self) -> Option<bool>

Extracts the boolean value if it is a boolean.

pub fn is_bool(&self) -> bool

Tests whether this value is a boolean.

pub fn as_str(&self) -> Option<&str>

Extracts the string of this value if it is a string.

pub fn is_str(&self) -> bool

Tests if this value is a string.

pub fn as_datetime(&self) -> Option<&Datetime>

Extracts the datetime value if it is a datetime.

Note that a parsed TOML value will only contain ISO 8601 dates. An example date is:

1979-05-27T07:32:00Z

pub fn is_datetime(&self) -> bool

Tests whether this value is a datetime.

pub fn as_array(&self) -> Option<&Vec<Value>>

Extracts the array value if it is an array.

pub fn as_array_mut(&mut self) -> Option<&mut Vec<Value>>

Extracts the array value if it is an array.

pub fn is_array(&self) -> bool

Tests whether this value is an array.

pub fn as_table(&self) -> Option<&Table>

Extracts the table value if it is a table.

pub fn as_table_mut(&mut self) -> Option<&mut Table>

Extracts the table value if it is a table.

pub fn is_table(&self) -> bool

Tests whether this value is a table.

pub fn same_type(&self, other: &Value) -> bool

Tests whether this and another value have the same type.

pub fn type_str(&self) -> &'static str

Returns a human-readable representation of the type of this value.

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Value

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Value

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

Deserialize this value from the given Serde deserializer.

impl Display for Value

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

Formats the value using the given formatter.

impl<'a> From<&'a str> for Value

fn from(val: &'a str) -> Value

Converts to this type from the input type.

impl<S: Into<String>, V: Into<Value>> From<BTreeMap<S, V>> for Value

fn from(val: BTreeMap<S, V>) -> Value

Converts to this type from the input type.

impl From<Datetime> for Value

fn from(val: Datetime) -> Value

Converts to this type from the input type.

impl<S: Into<String> + Hash + Eq, V: Into<Value>> From<HashMap<S, V, RandomState>> for Value

fn from(val: HashMap<S, V>) -> Value

Converts to this type from the input type.

impl From<Map<String, Value>> for Value

fn from(val: Table) -> Value

Converts to this type from the input type.

impl From<String> for Value

fn from(val: String) -> Value

Converts to this type from the input type.

impl<V: Into<Value>> From<Vec<V, Global>> for Value

fn from(val: Vec<V>) -> Value

Converts to this type from the input type.

impl From<bool> for Value

fn from(val: bool) -> Value

Converts to this type from the input type.

impl From<f32> for Value

fn from(val: f32) -> Value

Converts to this type from the input type.

impl From<f64> for Value

fn from(val: f64) -> Value

Converts to this type from the input type.

impl From<i32> for Value

fn from(val: i32) -> Value

Converts to this type from the input type.

impl From<i64> for Value

fn from(val: i64) -> Value

Converts to this type from the input type.

impl From<i8> for Value

fn from(val: i8) -> Value

Converts to this type from the input type.

impl From<u32> for Value

fn from(val: u32) -> Value

Converts to this type from the input type.

impl From<u8> for Value

fn from(val: u8) -> Value

Converts to this type from the input type.

impl FromStr for Value

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Value, Self::Err>

Parses a string s to return a value of this type.

impl<I> Index<I> for Value where
    I: Index, 

type Output = Value

The returned type after indexing.

fn index(&self, index: I) -> &Value

Performs the indexing (container[index]) operation.

impl<I> IndexMut<I> for Value where
    I: Index, 

fn index_mut(&mut self, index: I) -> &mut Value

Performs the mutable indexing (container[index]) operation.

impl PartialEq<Value> for Value

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Serialize for Value

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 Value