Struct SyncHashMapB 

pub struct SyncHashMapB<K, V>
where
    K: Eq + Hash,
{ /* private fields */ }

Bucketed hash map, distributing data to multiple sub-maps to improve concurrency performance 分桶哈希映射，将数据分散到多个子映射中以提高并发性能

Implementations

impl<K, V> SyncHashMapB<K, V>

where K: Eq + Hash,

pub fn new(bucket_count: Option<usize>) -> Self

Create a new bucketed hash map 创建新的分桶哈希映射

Arguments

• bucket_count - Number of buckets, defaults to 10 if None
• bucket_count - 分桶数量，如果为None则默认为10

Examples

use fast_able::map_hash::buckets::SyncHashMapB;

let map = SyncHashMapB::new(None);
map.insert(1, "a");
map.insert(2, "b");
assert_eq!(*map.get(&1).unwrap(), "a");
assert_eq!(*map.get(&2).unwrap(), "b");
assert!(map.get(&3).is_none());

pub fn insert(&self, k: K, v: V) -> Option<V>

Insert a key-value pair 插入键值对

pub fn insert_mut(&mut self, k: K, v: V) -> Option<V>

Insert operation under mutable reference 可变引用下的插入操作

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

Remove a key-value pair 移除键值对

pub fn is_empty(&self) -> bool

Check if empty 检查是否为空

pub fn len(&self) -> usize

Get total length 获取总长度

pub fn clear(&self)

Clear all buckets 清空所有桶

pub fn get(&self, k: &K) -> Option<MapReadGuard<'_, V>>

Get a reference to the value corresponding to the key, protected by read lock (value no lock) 获取键对应的值引用，使用读锁保护 (值无锁)

Returns a ReadGuardNoLock that holds the read lock until the guard is dropped. 返回一个 ReadGuardNoLock，在 guard 被释放前持有读锁。

pub fn get_mut(&self, k: &K) -> Option<WriteGuard<'_, V>>

Get a mutable reference to the value corresponding to the key, protected by write lock 获取键对应的可变值引用，使用写锁保护

Returns a WriteGuard that holds the write lock until the guard is dropped, ensuring concurrent access safety. 返回一个 WriteGuard，在 guard 被释放前持有写锁，保证并发访问安全。

pub fn bucket_count(&self) -> usize

Get the number of buckets 获取桶数量

pub fn keys(&self) -> impl Iterator<Item = &K>

Get an iterator of all keys 获取所有键的迭代器

pub fn get_clone(&self, k: &K) -> Option<V>

where V: Clone,

Get a clone of the value corresponding to the key 获取键对应的值的克隆

Trait Implementations

impl<K, V: Clone> Clone for SyncHashMapB<K, V>

where K: Eq + Hash + Clone,

fn clone(&self) -> SyncHashMapB<K, V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<K, V: Debug> Debug for SyncHashMapB<K, V>

where K: Eq + Hash + Debug,

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

Formats the value using the given formatter.

impl<K, V> Default for SyncHashMapB<K, V>

where K: Eq + Hash,

fn default() -> Self

Returns the “default value” for a type.