Struct near_sdk::collections::LookupMap

pub struct LookupMap<K, V> { /* fields omitted */ }

An non-iterable implementation of a map that stores its content directly on the trie.

Implementations

impl<K, V> LookupMap<K, V>

pub fn new<S>(key_prefix: S) -> Self where
    S: IntoStorageKey, 

Create a new map. Use key_prefix as a unique prefix for keys.

pub fn insert_raw(
    &mut self,
    key_raw: &[u8],
    value_raw: &[u8]
) -> Option<Vec<u8>>

Inserts a serialized key-value pair into the map. If the map did not have this key present, None is returned. Otherwise returns a serialized value. Note, the keys that have the same hash value are undistinguished by the implementation.

pub fn remove_raw(&mut self, key_raw: &[u8]) -> Option<Vec<u8>>

Removes a serialized key from the map, returning the serialized value at the key if the key was previously in the map.

impl<K, V> LookupMap<K, V> where
    K: BorshSerialize,
    V: BorshSerialize + BorshDeserialize, 

pub fn contains_key(&self, key: &K) -> bool

Returns true if the map contains a given key.

pub fn get(&self, key: &K) -> Option<V>

Returns the value corresponding to the key.

pub fn remove(&mut self, key: &K) -> Option<V>

Removes a key from the map, returning the value at the key if the key was previously in the map.

pub fn insert(&mut self, key: &K, value: &V) -> Option<V>

Inserts a key-value pair into the map. If the map did not have this key present, None is returned. Otherwise returns a value. Note, the keys that have the same hash value are undistinguished by the implementation.

pub fn extend<IT: IntoIterator<Item = (K, V)>>(&mut self, iter: IT)

Trait Implementations

impl<K, V> BorshDeserialize for LookupMap<K, V> where
    Vec<u8>: BorshDeserialize, 

fn deserialize(buf: &mut &[u8]) -> Result<Self, Error>

Deserializes this instance from a given slice of bytes. Updates the buffer to point at the remaining bytes.

fn try_from_slice(v: &[u8]) -> Result<Self, Error>

Deserialize this instance from a slice of bytes.

fn is_u8() -> bool

Whether Self is u8. NOTE: Vec<u8> is the most common use-case for serialization and deserialization, it’s worth handling it as a special case to improve performance. It’s a workaround for specific Vec<u8> implementation versus generic Vec<T> implementation. See https://github.com/rust-lang/rfcs/pull/1210 for details.

impl<K, V> BorshSerialize for LookupMap<K, V> where
    Vec<u8>: BorshSerialize, 

fn serialize<W: Write>(&self, writer: &mut W) -> Result<(), Error>

fn try_to_vec(&self) -> Result<Vec<u8, Global>, Error>

Serialize this instance into a vector of bytes.

fn is_u8() -> bool

Whether Self is u8. NOTE: Vec<u8> is the most common use-case for serialization and deserialization, it’s worth handling it as a special case to improve performance. It’s a workaround for specific Vec<u8> implementation versus generic Vec<T> implementation. See https://github.com/rust-lang/rfcs/pull/1210 for details.