Struct StorageString 

pub struct StorageString(pub StorageBytes);

Accessor for storage-backed bytes

Tuple Fields

0: StorageBytes

Implementations

impl StorageString

pub fn is_empty(&self) -> bool

Returns true if the collection contains no elements.

pub fn len(&self) -> usize

Gets the number of bytes stored.

pub fn push(&mut self, c: char)

Adds a char to the end.

pub fn get_string(&self) -> String

Gets the underlying String, ignoring any invalid data.

pub fn set_str(&mut self, text: impl AsRef<str>)

Overwrites the underlying String, erasing what was previously stored.

Trait Implementations

impl Erase for StorageString

fn erase(&mut self)

Erase the value from persistent storage.

impl Extend<char> for StorageString

fn extend<T: IntoIterator<Item = char>>(&mut self, iter: T)

Extends a collection with the contents of an iterator.

fn extend_one(&mut self, item: A)

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

Extends a collection with exactly one element.

fn extend_reserve(&mut self, additional: usize)

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

Reserves capacity in a collection for the given number of additional elements.

impl<T> From<&T> for StorageString

where T: Host + Clone + 'static,

fn from(host: &T) -> Self

Converts to this type from the input type.

impl HostAccess for StorageString

fn vm(&self) -> &dyn Host

Provides access to the parametrized host of a contract, giving access to all the desired hostios from the user.

impl StorageType for StorageString

type Wraps<'a> = StorageGuard<'a, StorageString> where Self: 'a

For primitive types, this is the type being stored. For collections, this is the StorageType being collected.

type WrapsMut<'a> = StorageGuardMut<'a, StorageString> where Self: 'a

Mutable accessor to the type being stored.

unsafe fn new(slot: U256, offset: u8, host: VM) -> Self

Where in persistent storage the type should live. Although useful for framework designers creating new storage types, most user programs shouldn’t call this. Note: implementations will have to be const once generic_const_exprs stabilizes.

fn load<'s>(self) -> Self::Wraps<'s>

Load the wrapped type, consuming the accessor. Note: most types have a get and/or getter, which don’t consume Self.

fn load_mut<'s>(self) -> Self::WrapsMut<'s>

Load the wrapped mutable type, consuming the accessor. Note: most types have a set and/or setter, which don’t consume Self.

const SLOT_BYTES: usize = 32usize

The number of bytes in a slot needed to represent the type. Must not exceed 32. For types larger than 32 bytes that are stored inline with a struct’s fields, set this to 32 and return the full size in StorageType::new.

const REQUIRED_SLOTS: usize = 0usize

The number of words this type must fill. For primitives this is always 0. For complex types requiring more than one inline word, set this to the total size.