Struct HeapH256 

pub struct HeapH256(/* private fields */);

Old smart contracts were using this H256 implementation, which was explicitly relying on the heap, to avoid large data copies on the stack.

It is no longer used, kept for reference.

Implementations

impl HeapH256

pub fn from_slice(slice: &[u8]) -> HeapH256

impl HeapH256

pub fn zero() -> HeapH256

Returns a new zero-initialized fixed hash. Allocates directly in heap. Minimal resulting wasm code (14 bytes if not inlined).

pub fn len_bytes() -> usize

Returns the size of this hash in bytes.

pub fn as_bytes(&self) -> &[u8]

Extracts a byte slice containing the entire fixed hash.

pub fn as_array(&self) -> &[u8; 32]

pub fn copy_to_array(&self, target: &mut [u8; 32])

pub fn to_vec(&self) -> Vec<u8>

pub fn as_ptr(&self) -> *const u8

Pointer to the data on the heap.

pub fn as_mut_ptr(&mut self) -> *mut u8

Returns an unsafe mutable pointer to the data on the heap. Used by the API to populate data.

pub fn is_zero(&self) -> bool

True if all 32 bytes of the hash are zero.

pub fn into_boxed_bytes(self) -> BoxedBytes

Transmutes self to an (in principle) variable length boxed bytes object. Both BoxedBytes and H256 keep the data on the heap, so only the pointer to that data needs to be transmuted. Does not reallocate or copy data, the data on the heap remains untouched.

Trait Implementations

impl AsMut<[u8]> for HeapH256

fn as_mut(&mut self) -> &mut [u8]

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

impl AsRef<[u8]> for HeapH256

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

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

impl Clone for HeapH256

fn clone(&self) -> HeapH256

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HeapH256

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

Formats the value using the given formatter.

impl<'a> From<&'a [u8; 32]> for HeapH256

fn from(bytes: &'a [u8; 32]) -> HeapH256

Constructs a hash type from the given reference to the bytes array of fixed length.

Note

The given bytes are interpreted in big endian order.

impl<'a> From<&'a HeapAddress> for &'a HeapH256

fn from(address: &'a HeapAddress) -> &'a HeapH256

Converts to this type from the input type.

impl<'a> From<&'a mut [u8; 32]> for HeapH256

fn from(bytes: &'a mut [u8; 32]) -> HeapH256

Constructs a hash type from the given reference to the mutable bytes array of fixed length.

Note

The given bytes are interpreted in big endian order.

impl From<[u8; 32]> for HeapH256

fn from(arr: [u8; 32]) -> HeapH256

Constructs a hash type from the given bytes array of fixed length.

Note

The given bytes are interpreted in big endian order.

impl From<Box<[u8; 32]>> for HeapH256

fn from(bytes: Box<[u8; 32]>) -> HeapH256

Converts to this type from the input type.

impl From<HeapAddress> for HeapH256

fn from(address: HeapAddress) -> HeapH256

Converts to this type from the input type.

impl From<HeapH256> for HeapAddress

fn from(hash: HeapH256) -> HeapAddress

Converts to this type from the input type.

impl Hash for HeapH256

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl NestedDecode for HeapH256

fn dep_decode_or_handle_err<I, H>( input: &mut I, h: H, ) -> Result<HeapH256, <H as DecodeErrorHandler>::HandledErr>

where I: NestedDecodeInput, H: DecodeErrorHandler,

Version of dep_decode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

fn dep_decode<I>(input: &mut I) -> Result<Self, DecodeError>

where I: NestedDecodeInput,

Attempt to deserialise the value from input, using the format of an object nested inside another structure. In case of success returns the deserialized value and the number of bytes consumed during the operation.

impl NestedEncode for HeapH256

fn dep_encode_or_handle_err<O, H>( &self, dest: &mut O, _h: H, ) -> Result<(), <H as EncodeErrorHandler>::HandledErr>

where O: NestedEncodeOutput, H: EncodeErrorHandler,

Version of dep_encode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

fn dep_encode<O>(&self, dest: &mut O) -> Result<(), EncodeError>

where O: NestedEncodeOutput,

NestedEncode to output, using the format of an object nested inside another structure. Does not provide compact version.

impl PartialEq for HeapH256

fn eq(&self, other: &HeapH256) -> 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 TopDecode for HeapH256

fn top_decode_or_handle_err<I, H>( input: I, h: H, ) -> Result<HeapH256, <H as DecodeErrorHandler>::HandledErr>

where I: TopDecodeInput, H: DecodeErrorHandler,

Version of top_decode that can handle errors as soon as they occur. For instance it can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

fn top_decode<I>(input: I) -> Result<Self, DecodeError>

where I: TopDecodeInput,

Attempt to deserialize the value from input.

impl TopEncode for HeapH256

fn top_encode_or_handle_err<O, H>( &self, output: O, _h: H, ) -> Result<(), <H as EncodeErrorHandler>::HandledErr>

where O: TopEncodeOutput, H: EncodeErrorHandler,

Version of top_encode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

fn top_encode<O>(&self, output: O) -> Result<(), EncodeError>

where O: TopEncodeOutput,

Attempt to serialize the value to output.

impl Eq for HeapH256

impl StructuralPartialEq for HeapH256