Struct IdMap 

pub struct IdMap<K: Id, V> { /* private fields */ }

极简版 IdMap：自动生成递增 Id + HashMap 存储 + 无条件编译

Implementations

impl<V> IdMap<DefaultId, V>

pub fn new() -> Self

创建空的 IdMap（初始 max_id = 0）

pub fn with_capacity(capacity: usize) -> Self

创建指定初始容量的 IdMap

impl<K: Id, V> IdMap<K, V>

pub fn with_id() -> Self

为自定义 Id 类型创建空 IdMap

pub fn with_id_capacity(capacity: usize) -> Self

自定义 Id 类型创建指定初始容量的 IdMap

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

插入值，自动生成递增 Id 并返回

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

【手动指定 Id】插入键值对，返回旧值（若存在）

注意：若手动传入的 Id 大于当前 max_id，会更新 max_id 以保证自动生成的 Id 不重复

pub fn from_vec(values: Vec<V>) -> (Self, Vec<K>)

从 Vec 批量插入值，自动生成递增 Id，返回对应的 Id 列表 生成的 Id 从当前 max_id + 1 开始连续递增

pub fn insert_cyclic<F>(&mut self, f: F) -> K

where F: FnOnce(K) -> V,

循环插入：先生成递增 Id，再通过闭包（Id → V）生成值并插入 适用于值需要依赖自身 Id 的场景（如循环引用/关联 Id 的场景）

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

根据 Id 查询值

pub fn get_mut(&mut self, id: K) -> Option<&mut V>

根据 Id 查询可变值

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

根据 Id 删除值

pub fn contains_id(&self, id: K) -> bool

判断是否包含指定 Id

pub fn max_id(&self) -> K

获取当前最大 Id（仅用于参考，删除 Id 后不会回退）

pub fn len(&self) -> usize

获取元素数量

pub fn is_empty(&self) -> bool

判断是否为空

pub fn clear(&mut self)

清空所有元素（保留 max_id 不变，避免 Id 重复）

Trait Implementations

impl<K: Clone + Id, V: Clone> Clone for IdMap<K, V>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<K: Debug + Id, V: Debug> Debug for IdMap<K, V>

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

Formats the value using the given formatter.

impl<K: Id, V> Default for IdMap<K, V>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, K: Id, V> Deserialize<'de> for IdMap<K, V>

where V: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<K: Id, V> Index<K> for IdMap<K, V>

type Output = V

The returned type after indexing.

fn index(&self, id: K) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<K: Id, V> IndexMut<K> for IdMap<K, V>

fn index_mut(&mut self, id: K) -> &mut Self::Output

Performs the mutable indexing (container[index]) operation.

impl<K: Id, V> Serialize for IdMap<K, V>

where V: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.