Struct near_sdk::collections::Set

pub struct Set<T> { /* fields omitted */ }

An iterable implementation of a set that stores its content directly on the trie.

Methods

impl<T> Set<T>

pub fn len(&self) -> u64

Returns the number of elements in the set, also referred to as its size.

pub fn new(id: Vec<u8>) -> Self

Create new map with zero elements. Use id as a unique identifier.

pub fn insert_raw(&mut self, element_raw: &[u8]) -> bool

Adds a value to the set. If the set did not have this value present, true is returned. If the set did have this value present, false is returned. Note, the elements that have the same hash value are undistinguished by the implementation.

pub fn remove_raw(&mut self, element_raw: &[u8]) -> bool

Removes a value from the set. Returns whether the value was present in the set.

impl<T> Set<T> where
    T: BorshSerialize + BorshDeserialize, 

pub fn contains(&self, element: &T) -> bool

Returns true if the set contains an element.

pub fn remove(&mut self, element: &T) -> bool

Removes a value from the set. Returns whether the value was present in the set.

pub fn insert(&mut self, element: &T) -> bool

Adds a value to the set. If the set did not have this value present, true is returned. If the set did have this value present, false is returned. Note, the elements that have the same hash value are undistinguished by the implementation.

pub fn clear(&mut self)

Clears the map, removing all elements.

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

Copies elements into an std::vec::Vec.

pub fn iter<'a>(&'a self) -> impl Iterator<Item = T> + 'a

Iterate over deserialized elements.

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

pub fn as_vector(&self) -> &Vector<T>

Returns a view of elements as a vector. It's sometimes useful to have random access to the elements.

Trait Implementations

impl<T> BorshDeserialize for Set<T> where
    Vec<u8>: BorshDeserialize,
    Vector<T>: 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<T> BorshSerialize for Set<T> where
    Vec<u8>: BorshSerialize,
    Vector<T>: BorshSerialize, 

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

fn try_to_vec(&self) -> Result<Vec<u8>, 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.

impl<T> Default for Set<T>

fn default() -> Self

Returns the "default value" for a type.