普贤教程 › 包参考

counter 包

计数（collections.Counter 心智）

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

安装与引入

bash

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

import counter

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

公开接口

函数	参数
`ct_count`	`l`
`ct_add`	`c, v, n = 1`
`ct_get`	`c, v`
`ct_total`	`c`
`ct_len`	`c`
`ct_most_common`	`c`
`ct_merge`	`a, b`

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

函数	参数
`ct_subtract`	`a, b`
`ct_intersect`	`a, b`
`ct_union`	`a, b`
`ct_top_n`	`c, n`
`ct_least_common`	`c`
`ct_keys_above`	`c, min_count`
`ct_frequencies`	`c`
`ct_keys`	`c`
`ct_from_dict`	`d`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/counter —— 计数（collections.Counter 心智）
------------------------------------------------------------
纯函数库（无 IO、无状态，计数状态以 dict 显式传递），双模式一致。
ct_count(l)           → dict     从 list 计数（元素 → 次数）
ct_add(c, v, n=1)     → c        增量（默认 +1，可链式）
ct_get(c, v)          → int      次数（无则 0）
ct_total(c)           → int      总次数
ct_len(c)             → int      不同元素的个数
ct_most_common(c)     → [[key, count]...]  按次数降序
ct_merge(a, b)        → dict     合并（次数相加）
元素类型：string（dict 键限定 str，见 docs/语言缺陷.md 写库限制）。
============================================================