Struct locutus_runtime::prelude::StateSummary

pub struct StateSummary<'a>(_);

Summary of State changes.

Given a contract state, this is a small piece of data that can be used to determine a delta between two contracts as part of the state synchronization mechanism. The format of a state summary is determined by the state’s contract.

Implementations

impl StateSummary<'_>

pub fn into_bytes(self) -> Vec<u8, Global>

Extracts the owned data as a Vec<u8>.

pub fn size(&self) -> usize

Gets the number of bytes of data stored in the StateSummary.

pub fn into_owned(self) -> StateSummary<'static>

Methods from Deref<Target = Cow<'a, [u8]>>

pub fn is_borrowed(&self) -> bool

🔬This is a nightly-only experimental API. (cow_is_borrowed)

Returns true if the data is borrowed, i.e. if to_mut would require additional work.

Examples

#![feature(cow_is_borrowed)]
use std::borrow::Cow;

let cow = Cow::Borrowed("moo");
assert!(cow.is_borrowed());

let bull: Cow<'_, str> = Cow::Owned("...moo?".to_string());
assert!(!bull.is_borrowed());

pub fn is_owned(&self) -> bool

🔬This is a nightly-only experimental API. (cow_is_borrowed)

Returns true if the data is owned, i.e. if to_mut would be a no-op.

Examples

#![feature(cow_is_borrowed)]
use std::borrow::Cow;

let cow: Cow<'_, str> = Cow::Owned("moo".to_string());
assert!(cow.is_owned());

let bull = Cow::Borrowed("...moo?");
assert!(!bull.is_owned());

pub fn to_mut(&mut self) -> &mut <B as ToOwned>::Owned

Acquires a mutable reference to the owned form of the data.

Clones the data if it is not already owned.

Examples

use std::borrow::Cow;

let mut cow = Cow::Borrowed("foo");
cow.to_mut().make_ascii_uppercase();

assert_eq!(
  cow,
  Cow::Owned(String::from("FOO")) as Cow<str>
);

Trait Implementations

impl<'a> AsRef<[u8]> for StateSummary<'a>

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a> Clone for StateSummary<'a>

fn clone(&self) -> StateSummary<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for StateSummary<'a>

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

Formats the value using the given formatter.

impl<'a> Deref for StateSummary<'a>

type Target = Cow<'a, [u8]>

The resulting type after dereferencing.

fn deref(&self) -> &<StateSummary<'a> as Deref>::Target

Dereferences the value.

impl<'a> DerefMut for StateSummary<'a>

fn deref_mut(&mut self) -> &mut <StateSummary<'a> as Deref>::Target

Mutably dereferences the value.

impl<'de, 'a> Deserialize<'de> for StateSummary<'a>where
    'de: 'a,

fn deserialize<__D>(
    __deserializer: __D
) -> Result<StateSummary<'a>, <__D as Deserializer<'de>>::Error>where
    __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> From<&'a [u8]> for StateSummary<'a>

fn from(state: &'a [u8]) -> StateSummary<'a>

Converts to this type from the input type.

impl<'a> From<Vec<u8, Global>> for StateSummary<'a>

fn from(state: Vec<u8, Global>) -> StateSummary<'a>

Converts to this type from the input type.

impl<'a> Serialize for StateSummary<'a>

fn serialize<__S>(
    &self,
    __serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
    __S: Serializer,

Serialize this value into the given Serde serializer.