列表统计

📖 节点概述

统计指定元素在列表中出现的总次数（非重叠计数）。支持多种列表输入格式：列表对象、JSON 数组字符串或多行文本（每行一个元素）。输出为整数。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 词频统计：统计某个关键词在文本行列表中出现的次数。
• 数据质量检查：检查列表中某个值的重复程度（如统计缺失值 None 的出现次数）。
• 投票计数：统计某个选项被选择的次数。
• 库存盘点：统计特定商品 ID 在订单列表中的出现频次。
• 日志分析：统计某个错误码在日志记录列表中的出现次数。

🎮 实战连线指南：如何正确使用它？

节点有两个输入端口：列表 和 元素，输出端口 次数。

场景案例：统计水果列表中“banana”出现的次数

1. 准备列表：在“列表”多行文本框输入：

   apple
   banana
   cherry
   banana
   

   或从上游传入列表 ["apple", "banana", "cherry", "banana"]。

2. 设置元素：在“元素”输入框中填写 banana（或连线传入）。

3. 获取结果：次数 输出 2。

4. 后续使用：将次数用于判断或展示。

JSON 数组示例：

• 列表：[1, 2, 3, 2, 2]
• 元素：2
• 结果：3

多行文本与 JSON 混合：

• 列表文本框输入 ["apple","banana","apple"]（JSON 数组）
• 元素："apple" → 结果 2。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 行为说明

• 统计使用 Python 的 list.count() 方法，严格匹配（值相等且类型相同）。
• 如果列表输入是字符串（非 JSON 数组），节点会尝试解析为 JSON，失败则按行拆分为字符串列表。
• 列表中的每个元素会保留原始类型（数字、字符串、布尔等）。
• 如果元素不存在于列表中，返回 0。

⚠️ 注意事项

• 类型匹配：统计时要求元素类型与列表元素完全一致。例如列表包含整数 1，统计 "1"（字符串）会返回 0。
• 区分大小写：字符串统计区分大小写（"banana" 和 "Banana" 视为不同）。
• 多行文本输入：按行拆分后的每个元素均为字符串类型，因此统计的元素值也需提供字符串。
• JSON 数组：使用 JSON 格式可保留元素类型（如数字、布尔），但字符串必须使用双引号。
• 空列表：输入为空列表时，返回 0。
• 性能：统计操作时间复杂度 O(n)，n 为列表长度。

💎 小贴士：

• 若要统计多个不同元素的出现次数，可多次调用本节点。
• 结合【列表长度】节点，可计算某个元素的比例：次数 / 总长度。
• 如果需要统计满足条件的元素数量（如大于某个值的数字），请使用【列表过滤】节点后再获取长度。
• 该节点输出可直接用于【条件判断】节点中的数值比较（如大于阈值时触发）。
• 由于是纯数据节点，可在数据流中随时使用，无需执行信号。