Representation of a TOML value.
Represents a TOML integer
Represents a TOML boolean
Represents a TOML datetime
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.
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.
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.
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.
Extracts the integer value if it is an integer.
Tests whether this value is an integer.
Extracts the float value if it is a float.
Tests whether this value is a float.
Extracts the boolean value if it is a boolean.
Tests whether this value is a boolean.
Extracts the string of this value if it is a string.
Tests if this value is a string.
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
Tests whether this value is a datetime.
Extracts the array value if it is an array.
Extracts the array value if it is an array.
Tests whether this value is an array.
Extracts the table value if it is a table.
Extracts the table value if it is a table.
Tests whether this value is a table.
Tests whether this and another value have the same type.
Returns a human-readable representation of the type of this value.
This method tests for self
and other
values to be equal, and is used by ==
. Read more
This method tests for !=
.
Performs copy-assignment from source
. Read more
Formats the value using the given formatter. Read more
Formats the value using the given formatter. Read more
The returned type after indexing.
Performs the indexing (container[index]
) operation.
Performs the mutable indexing (container[index]
) operation.
The associated error which can be returned from parsing.
Parses a string s
to return a value of this type. Read more
The type of the deserializer being converted into.
Convert this value into a deserializer.
Serialize this value into the given Serde serializer. Read more
The error type that can be returned if some error occurs during deserialization. Read more
Require the Deserializer
to figure out how to drive the visitor based on what data type is in the input. Read more
Hint that the Deserialize
type is expecting an enum value with a particular name and possible variants. Read more
Hint that the Deserialize
type is expecting an optional value. Read more
Hint that the Deserialize
type is expecting a newtype struct with a particular name. Read more
Hint that the Deserialize
type is expecting a bool
value.
Hint that the Deserialize
type is expecting a u8
value.
Hint that the Deserialize
type is expecting a u16
value.
Hint that the Deserialize
type is expecting a u32
value.
Hint that the Deserialize
type is expecting a u64
value.
Hint that the Deserialize
type is expecting an i8
value.
Hint that the Deserialize
type is expecting an i16
value.
Hint that the Deserialize
type is expecting an i32
value.
Hint that the Deserialize
type is expecting an i64
value.
Hint that the Deserialize
type is expecting a f32
value.
Hint that the Deserialize
type is expecting a f64
value.
Hint that the Deserialize
type is expecting a char
value.
Hint that the Deserialize
type is expecting a string value and does not benefit from taking ownership of buffered data owned by the Deserializer
. Read more
Hint that the Deserialize
type is expecting a string value and would benefit from taking ownership of buffered data owned by the Deserializer
. Read more
Hint that the Deserialize
type is expecting a unit value.
Hint that the Deserialize
type is expecting a sequence of values.
Hint that the Deserialize
type is expecting a byte array and does not benefit from taking ownership of buffered data owned by the Deserializer
. Read more
Hint that the Deserialize
type is expecting a byte array and would benefit from taking ownership of buffered data owned by the Deserializer
. Read more
Hint that the Deserialize
type is expecting a map of key-value pairs.
Hint that the Deserialize
type is expecting a unit struct with a particular name. Read more
Hint that the Deserialize
type is expecting a tuple struct with a particular name and number of fields. Read more
Hint that the Deserialize
type is expecting a struct with a particular name and fields. Read more
Hint that the Deserialize
type is expecting a sequence of values and knows how many values there are without looking at the serialized data. Read more
Hint that the Deserialize
type needs to deserialize a value whose type doesn't matter because it is ignored. Read more
Hint that the Deserialize
type is expecting the name of a struct field or the discriminant of an enum variant. Read more
Hint that the Deserialize
type is expecting an i128
value. Read more
Hint that the Deserialize
type is expecting an u128
value. Read more
Determine whether Deserialize
implementations should expect to deserialize their human-readable form. Read more
Deserialize this value from the given Serde deserializer. Read more
Creates owned data from borrowed data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
Converts the given value to a String
. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static