普贤教程 › 包参考

concurrent_map 包

并发安全映射

⚠️ 含并发（mutex）—— 必须编译模式运行（px build）；

项	值
包名	`concurrent_map`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`concurrent_map.px`
分类	`并发与通用模式`
文件数 / 行数	`1 / 96`

安装与引入

bash

pxpkg init          # 首次
pxpkg add concurrent_map@0.2.0
pxpkg install

import concurrent_map

所属分类教程：并发与通用模式

公开接口

函数	参数
`cm_new`
`cm_set`	`m, k, v`
`cm_get`	`m, k, default=null`
`cm_has`	`m, k`
`cm_delete`	`m, k`
`cm_len`	`m`
`cm_keys`	`m`

其余 3 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`cm_clear`	`m`
`cm_values`	`m`
`cm_to_string`	`m`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/concurrent_map —— 并发安全映射
------------------------------------------------------------
⚠️ 含并发（mutex）—— 必须编译模式运行（px build）；
解释器 px run 是 Mini 子集，无并发原语。
var m = cm_new()                    # 创建（mutex + dict）
cm_set(m, k, v) / cm_get(m, k, 默认) / cm_has / cm_delete / cm_len / cm_keys
说明：
- dict 键限定 str（底层 dict 限制）；锁保护整表（读写互斥，非分段锁）
- cm_get 返回 Ok(v) | Err(键不存在)——或传默认值
============================================================