pub struct RawValue<'a, E>where
E: CustomExtension,{
value_kind: ValueKind<<E as CustomExtension>::CustomValueKind>,
value_body: Cow<'a, [u8]>,
custom_extension: PhantomData<E>,
}
Expand description
A wrapper for a reference to a valid partial SBOR payload representing a single value.
Encode, Decode and Describe are implemented:
- For performance, the payload is encoded directly without checking if it is valid.
- Decoding goes through a traverser, which calculates the length of the bytes and ensures that the bytes are actually valid.
- Describe is implemented as Any.
Categorize can’t be implemented, because we can’t guarantee the value kind is constant. This means RawValue can’t be put as an immediate child to a Vec or Map.
Fields§
§value_kind: ValueKind<<E as CustomExtension>::CustomValueKind>
§value_body: Cow<'a, [u8]>
§custom_extension: PhantomData<E>
Implementations§
source§impl<'a, E> RawValue<'a, E>where
E: CustomExtension,
impl<'a, E> RawValue<'a, E>where
E: CustomExtension,
sourcepub fn new_from_valid_full_value_slice(
encoded_full_value: &'a [u8]
) -> RawValue<'a, E>
pub fn new_from_valid_full_value_slice( encoded_full_value: &'a [u8] ) -> RawValue<'a, E>
The bytes should include the value kind byte, but not the payload prefix byte.
The bytes must be at least 1 byte long, else this will panic.
sourcepub fn new_from_valid_value_body_slice(
value_kind: ValueKind<<E as CustomExtension>::CustomValueKind>,
encoded_value_body: &'a [u8]
) -> RawValue<'a, E>
pub fn new_from_valid_value_body_slice( value_kind: ValueKind<<E as CustomExtension>::CustomValueKind>, encoded_value_body: &'a [u8] ) -> RawValue<'a, E>
The bytes should include the value, not the value kind or the prefix byte
sourcepub fn new_from_valid_owned_value_body(
value_kind: ValueKind<<E as CustomExtension>::CustomValueKind>,
encoded_value_body: Vec<u8>
) -> RawValue<'a, E>
pub fn new_from_valid_owned_value_body( value_kind: ValueKind<<E as CustomExtension>::CustomValueKind>, encoded_value_body: Vec<u8> ) -> RawValue<'a, E>
The bytes should include the value, not the value kind or the prefix byte
pub fn value_kind(&self) -> ValueKind<<E as CustomExtension>::CustomValueKind>
pub fn value_body_bytes(&self) -> &[u8] ⓘ
Trait Implementations§
source§impl<'s, 'a, 'b, E> ContextualDisplay<ValueDisplayParameters<'s, 'a, E>> for RawValue<'b, E>where
E: FormattableCustomExtension,
impl<'s, 'a, 'b, E> ContextualDisplay<ValueDisplayParameters<'s, 'a, E>> for RawValue<'b, E>where
E: FormattableCustomExtension,
type Error = FormattingError
source§fn contextual_format<F>(
&self,
f: &mut F,
options: &ValueDisplayParameters<'s, 'a, E>
) -> Result<(), <RawValue<'b, E> as ContextualDisplay<ValueDisplayParameters<'s, 'a, E>>>::Error>where
F: Write,
fn contextual_format<F>(
&self,
f: &mut F,
options: &ValueDisplayParameters<'s, 'a, E>
) -> Result<(), <RawValue<'b, E> as ContextualDisplay<ValueDisplayParameters<'s, 'a, E>>>::Error>where
F: Write,
Formats the value to the given
fmt::Write
buffer, making use of the provided context.
See also format
, which is typically easier to use, as it takes an Into<Context>
instead of a &Context
.§fn format<F, TContext>(
&self,
f: &mut F,
context: TContext
) -> Result<(), Self::Error>
fn format<F, TContext>( &self, f: &mut F, context: TContext ) -> Result<(), Self::Error>
Formats the value to the given
fmt::Write
buffer, making use of the provided context.
See also contextual_format
, which takes a &Context
instead of an Into<Context>
. Read more§fn display<TContext, 'a, 'b>(
&'a self,
context: TContext
) -> ContextDisplayable<'a, Self, Context>where
TContext: Into<Context>,
fn display<TContext, 'a, 'b>(
&'a self,
context: TContext
) -> ContextDisplayable<'a, Self, Context>where
TContext: Into<Context>,
fn to_string<TContext, 'a, 'b>(&'a self, context: TContext) -> Stringwhere
TContext: Into<Context>,
source§impl<'s, 'a, 'b, E> ContextualSerialize<SerializationParameters<'s, 'a, E>> for RawValue<'b, E>where
E: SerializableCustomExtension,
impl<'s, 'a, 'b, E> ContextualSerialize<SerializationParameters<'s, 'a, E>> for RawValue<'b, E>where
E: SerializableCustomExtension,
source§fn contextual_serialize<S>(
&self,
serializer: S,
context: &SerializationParameters<'s, 'a, E>
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
fn contextual_serialize<S>(
&self,
serializer: S,
context: &SerializationParameters<'s, 'a, E>
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
§fn serialize<S, TContext>(
&self,
serializer: S,
context: TContext
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
TContext: Into<Context>,
fn serialize<S, TContext>(
&self,
serializer: S,
context: TContext
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
S: Serializer,
TContext: Into<Context>,
Serializes the value to the given
serde::Serializer
, making use of the provided context.
See also contextual_serialize
, which takes a &Context
instead of an Into<Context>
. Read more§fn serializable<TContext, 'a, 'b>(
&'a self,
context: TContext
) -> ContextSerializable<'a, Self, Context>where
TContext: Into<Context>,
fn serializable<TContext, 'a, 'b>(
&'a self,
context: TContext
) -> ContextSerializable<'a, Self, Context>where
TContext: Into<Context>,
Returns an object implementing
serde::Serialize
, which can be passed to serde
functions.source§impl<Ext, D> Decode<<Ext as CustomExtension>::CustomValueKind, D> for RawValue<'_, Ext>
impl<Ext, D> Decode<<Ext as CustomExtension>::CustomValueKind, D> for RawValue<'_, Ext>
source§fn decode_body_with_value_kind(
decoder: &mut D,
value_kind: ValueKind<<Ext as CustomExtension>::CustomValueKind>
) -> Result<RawValue<'_, Ext>, DecodeError>
fn decode_body_with_value_kind( decoder: &mut D, value_kind: ValueKind<<Ext as CustomExtension>::CustomValueKind> ) -> Result<RawValue<'_, Ext>, DecodeError>
Decodes the type from the decoder, which should match a preloaded value kind. Read more
source§impl<Ext, C> Describe<C> for RawValue<'_, Ext>
impl<Ext, C> Describe<C> for RawValue<'_, Ext>
source§const TYPE_ID: RustTypeId = _
const TYPE_ID: RustTypeId = _
The
TYPE_ID
should give a unique identifier for its SBOR schema type.
An SBOR schema type capture details about the SBOR payload, how it should be interpreted, validated and displayed. Read moresource§fn type_data() -> TypeData<C, RustTypeId>
fn type_data() -> TypeData<C, RustTypeId>
Returns the local schema for the given type. Read more
source§fn add_all_dependencies(aggregator: &mut TypeAggregator<C>)
fn add_all_dependencies(aggregator: &mut TypeAggregator<C>)
For each type referenced in
get_local_type_data
, we need to ensure that the type and all of its own references
get added to the aggregator. Read moresource§impl<Ext, E> Encode<<Ext as CustomExtension>::CustomValueKind, E> for RawValue<'_, Ext>
impl<Ext, E> Encode<<Ext as CustomExtension>::CustomValueKind, E> for RawValue<'_, Ext>
source§fn encode_value_kind(&self, encoder: &mut E) -> Result<(), EncodeError>
fn encode_value_kind(&self, encoder: &mut E) -> Result<(), EncodeError>
Encodes the SBOR value’s kind to the encoder
source§fn encode_body(&self, encoder: &mut E) -> Result<(), EncodeError>
fn encode_body(&self, encoder: &mut E) -> Result<(), EncodeError>
Encodes the SBOR body of the type to the encoder. Read more
Auto Trait Implementations§
impl<'a, E> RefUnwindSafe for RawValue<'a, E>
impl<'a, E> Send for RawValue<'a, E>
impl<'a, E> Sync for RawValue<'a, E>
impl<'a, E> Unpin for RawValue<'a, E>
impl<'a, E> UnwindSafe for RawValue<'a, E>
Blanket Implementations§
§impl<U> As for U
impl<U> As for U
§fn as_<T>(self) -> Twhere
T: CastFrom<U>,
fn as_<T>(self) -> Twhere
T: CastFrom<U>,
Casts
self
to type T
. The semantics of numeric casting with the as
operator are followed, so <T as As>::as_::<U>
can be used in the same way as T as U
for numeric conversions. Read moresource§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more