Struct Value

pub struct Value<T = ()> {
    pub value: ValueDef<T>,
    pub context: T,
}

Value holds a representation of some value that has been decoded, as well as some arbitrary context.

Not all SCALE encoded types have an similar-named value; for instance, the values corresponding to sequence, array and composite types can all be represented with Composite. Only enough information is preserved here to to be able to encode and decode SCALE bytes with a known type to and from Values losslessly.

Fields

value: ValueDef<T>

The shape and associated data for this Value

context: T

Some additional arbitrary context that can be associated with a value.

Implementations

impl Value<()>

pub fn named_composite<S, Vals>(vals: Vals) -> Self

where S: Into<String>, Vals: IntoIterator<Item = (S, Value<()>)>,

Construct a named composite type from any type which produces a tuple of keys and values when iterated over.

pub fn unnamed_composite<Vals>(vals: Vals) -> Self

where Vals: IntoIterator<Item = Value<()>>,

Construct an unnamed composite type from any type which produces values when iterated over.

pub fn variant<S: Into<String>>(name: S, values: Composite<()>) -> Value<()>

Create a new variant value without additional context.

pub fn named_variant<S, F, Vals>(name: S, fields: Vals) -> Value<()>

where S: Into<String>, F: Into<String>, Vals: IntoIterator<Item = (F, Value<()>)>,

Create a new variant value with named fields and without additional context.

pub fn unnamed_variant<S, Vals>(name: S, fields: Vals) -> Value<()>

where S: Into<String>, Vals: IntoIterator<Item = Value<()>>,

Create a new variant value with tuple-like fields and without additional context.

pub fn bit_sequence(bits: BitSequence) -> Value<()>

Create a new bit sequence value without additional context.

pub fn primitive(primitive: Primitive) -> Value<()>

Create a new primitive value without additional context.

pub fn string<S: Into<String>>(val: S) -> Value<()>

Create a new string value without additional context.

pub fn bool(val: bool) -> Value<()>

Create a new boolean value without additional context.

pub fn char(val: char) -> Value<()>

Create a new char without additional context.

pub fn u128(val: u128) -> Value<()>

Create a new unsigned integer without additional context.

pub fn i128(val: i128) -> Value<()>

Create a new signed integer without additional context.

pub fn from_bytes(bytes: impl AsRef<[u8]>) -> Value<()>

Create a new Value from a set of bytes; useful for converting things like AccountIds.

impl Value<()>

pub fn without_context(value: ValueDef<()>) -> Value<()>

Create a new value with no associated context.

impl<T> Value<T>

pub fn with_context(value: ValueDef<T>, context: T) -> Value<T>

Create a new value with some associated context.

pub fn remove_context(self) -> Value<()>

Remove the context.

pub fn map_context<F, U>(self, f: F) -> Value<U>

where F: Clone + FnMut(T) -> U,

Map the context to some different type.

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

If the value is a boolean value, return it.

pub fn as_char(&self) -> Option<char>

If the value is a char, return it.

pub fn as_u128(&self) -> Option<u128>

If the value is a u128, return it.

pub fn as_i128(&self) -> Option<i128>

If the value is an i128, return it.

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

If the value is a string, return it.

Trait Implementations

impl<Ctx> At<Ctx> for Value<Ctx>

fn at<L: AsLocation>(&self, loc: L) -> Option<&Value<Ctx>>

Index into a value, returning a reference to the value if one exists, or None if not.

impl<T: Clone> Clone for Value<T>

fn clone(&self) -> Value<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Value<T>

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<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, T> Deserializer<'de> for Value<T>

type Error = DeserializerError

The error type that can be returned if some error occurs during deserialization.

fn deserialize_any<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Require the Deserializer to figure out how to drive the visitor based on what data type is in the input.

fn deserialize_bool<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a bool value.

fn deserialize_i8<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i8 value.

fn deserialize_i16<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i16 value.

fn deserialize_i32<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i32 value.

fn deserialize_i64<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i64 value.

fn deserialize_i128<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an i128 value.

fn deserialize_u8<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a u8 value.

fn deserialize_u16<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a u16 value.

fn deserialize_u32<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a u32 value.

fn deserialize_u64<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a u64 value.

fn deserialize_u128<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an u128 value.

fn deserialize_f32<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a f32 value.

fn deserialize_f64<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a f64 value.

fn deserialize_char<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a char value.

fn deserialize_str<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a string value and does not benefit from taking ownership of buffered data owned by the Deserializer.

fn deserialize_string<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a string value and would benefit from taking ownership of buffered data owned by the Deserializer.

fn deserialize_bytes<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a byte array and does not benefit from taking ownership of buffered data owned by the Deserializer.

fn deserialize_byte_buf<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a byte array and would benefit from taking ownership of buffered data owned by the Deserializer.

fn deserialize_option<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an optional value.

fn deserialize_unit<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a unit value.

fn deserialize_seq<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a sequence of values.

fn deserialize_map<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a map of key-value pairs.

fn deserialize_identifier<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting the name of a struct field or the discriminant of an enum variant.

fn deserialize_ignored_any<V>(self, visitor: V) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type needs to deserialize a value whose type doesn’t matter because it is ignored.

fn deserialize_unit_struct<V>( self, name: &'static str, visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a unit struct with a particular name.

fn deserialize_newtype_struct<V>( self, name: &'static str, visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a newtype struct with a particular name.

fn deserialize_tuple<V>( self, len: usize, visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a sequence of values and knows how many values there are without looking at the serialized data.

fn deserialize_tuple_struct<V>( self, name: &'static str, len: usize, visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a tuple struct with a particular name and number of fields.

fn deserialize_struct<V>( self, name: &'static str, fields: &'static [&'static str], visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting a struct with a particular name and fields.

fn deserialize_enum<V>( self, name: &'static str, variants: &'static [&'static str], visitor: V, ) -> Result<V::Value, Self::Error>

where V: Visitor<'de>,

Hint that the Deserialize type is expecting an enum value with a particular name and possible variants.

fn is_human_readable(&self) -> bool

Determine whether Deserialize implementations should expect to deserialize their human-readable form.

impl<T> Display for Value<T>

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

Formats the value using the given formatter.

impl<T> EncodeAsFields for Value<T>

fn encode_as_fields_to<R: TypeResolver>( &self, fields: &mut dyn FieldIter<'_, R::TypeId>, types: &R, out: &mut Vec<u8>, ) -> Result<(), Error>

Given some fields describing the shape of a type, attempt to encode to that shape.

fn encode_as_fields<R>( &self, fields: &mut dyn FieldIter<'_, <R as TypeResolver>::TypeId, Item = Field<'_, <R as TypeResolver>::TypeId>>, types: &R, ) -> Result<Vec<u8>, Error>

where R: TypeResolver,

This is a helper function which internally calls EncodeAsFields::encode_as_fields_to. Prefer to implement that instead.

impl<T> EncodeAsType for Value<T>

fn encode_as_type_to<R: TypeResolver>( &self, type_id: R::TypeId, types: &R, out: &mut Vec<u8>, ) -> Result<(), Error>

Given some type_id, types, a context and some output target for the SCALE encoded bytes, attempt to SCALE encode the current value into the type given by type_id.

fn encode_as_type<R>( &self, type_id: <R as TypeResolver>::TypeId, types: &R, ) -> Result<Vec<u8>, Error>

where R: TypeResolver,

This is a helper function which internally calls EncodeAsType::encode_as_type_to. Prefer to implement that instead.

impl From<&str> for Value<()>

fn from(val: &str) -> Self

Converts to this type from the input type.

impl From<Bits> for Value<()>

fn from(val: BitSequence) -> Self

Converts to this type from the input type.

impl From<Composite<()>> for Value<()>

fn from(val: Composite<()>) -> Self

Converts to this type from the input type.

impl From<String> for Value<()>

fn from(val: String) -> Self

Converts to this type from the input type.

impl From<Variant<()>> for Value<()>

fn from(val: Variant<()>) -> Self

Converts to this type from the input type.

impl<K: Into<String>, V: Into<Value<()>>> From<Vec<(K, V)>> for Value<()>

fn from(vals: Vec<(K, V)>) -> Self

Converts to this type from the input type.

impl<V: Into<Value<()>>> From<Vec<V>> for Value<()>

fn from(vals: Vec<V>) -> Self

Converts to this type from the input type.

impl From<bool> for Value<()>

fn from(val: bool) -> Self

Converts to this type from the input type.

impl From<char> for Value<()>

fn from(val: char) -> Self

Converts to this type from the input type.

impl From<i128> for Value<()>

fn from(val: i128) -> Self

Converts to this type from the input type.

impl From<i16> for Value<()>

fn from(val: i16) -> Self

Converts to this type from the input type.

impl From<i32> for Value<()>

fn from(val: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Value<()>

fn from(val: i64) -> Self

Converts to this type from the input type.

impl From<i8> for Value<()>

fn from(val: i8) -> Self

Converts to this type from the input type.

impl From<isize> for Value<()>

fn from(val: isize) -> Self

Converts to this type from the input type.

impl From<u128> for Value<()>

fn from(val: u128) -> Self

Converts to this type from the input type.

impl From<u16> for Value<()>

fn from(val: u16) -> Self

Converts to this type from the input type.

impl From<u32> for Value<()>

fn from(val: u32) -> Self

Converts to this type from the input type.

impl From<u64> for Value<()>

fn from(val: u64) -> Self

Converts to this type from the input type.

impl From<u8> for Value<()>

fn from(val: u8) -> Self

Converts to this type from the input type.

impl From<usize> for Value<()>

fn from(val: usize) -> Self

Converts to this type from the input type.

impl<'de, T> IntoDeserializer<'de, DeserializerError> for Value<T>

type Deserializer = Value<T>

The type of the deserializer being converted into.

fn into_deserializer(self) -> Self::Deserializer

Convert this value into a deserializer.

impl IntoVisitor for Value<()>

type AnyVisitor<R: TypeResolver> = VisitorWithCrateError<DecodeValueVisitor<R, EmptyContext>>

The visitor type used to decode SCALE encoded bytes to Self.

fn into_visitor<R: TypeResolver>() -> Self::AnyVisitor<R>

A means of obtaining this visitor.

impl<T: PartialEq> PartialEq for Value<T>

fn eq(&self, other: &Value<T>) -> 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<T> Serialize for Value<T>

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: Eq> Eq for Value<T>

impl<T> StructuralPartialEq for Value<T>