列表长度

📖 节点概述

计算列表中元素的总个数（长度）。输入可以是列表对象、JSON 数组字符串或多行文本（每行视为一个元素）。输出为整数。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 循环控制：在使用【遍历列表】或【For 循环】前获取列表长度，决定循环次数。
• 数据验证：检查列表是否为空（长度为 0）或超过阈值。
• 分页计算：获取数据总量，结合每页大小计算总页数。
• 进度展示：在处理列表元素时，获取总长度用于显示处理进度。
• 性能预估：在处理前评估列表规模，决定是否采用分批处理策略。

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

节点有一个输入端口 列表 和一个输出端口 元素个数。

场景案例：获取水果列表的长度

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

   apple
   banana
   cherry
   

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

2. 获取结果：元素个数 输出 3。

3. 后续使用：将该数值用于条件判断（如是否为空）或循环次数。

JSON 数组示例：

• 列表：[1, 2, 3, 4] → 输出 4。
• 列表：[]（空 JSON 数组）→ 输出 0。

多行文本示例：

• 列表文本框输入（每行一个）：

  苹果
  香蕉
  （空行）
  橙子
  

  空行会被忽略，实际计数为 3（苹果、香蕉、橙子）。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 行为说明

• 输入解析与【列表反转】等节点一致：支持列表对象、JSON 数组、多行文本。
• 对于多行文本，按行拆分并自动过滤空行。
• 对于 JSON 数组，保留原始类型（数字、字符串等）。
• 如果输入为空值或无法解析，返回 0。

⚠️ 注意事项

• 空行过滤：多行文本输入中的空行会被忽略，不计入长度。如需保留空字符串作为可用元素，请使用 JSON 数组格式 ["a", "", "b"]。
• 嵌套列表：计算的是首层元素的个数，而非递归统计所有子元素。例如 [[1,2], 3] 长度为 2，不是 3。
• 性能：获取长度操作时间复杂度 O(1)（Python 列表内部维护长度）。
• 类型安全：如果输入是字符串但不是 JSON 数组，按行拆分后的结果均为字符串类型。

💎 小贴士：

• 常用于判断列表是否为空：长度 == 0。
• 配合【Range 生成器】生成索引列表：range(长度) 可生成 0 到 长度-1 的索引序列。
• 在循环中使用长度作为循环次数时，注意列表可能在循环过程中改变长度（如删除元素），建议提前获取并存储。
• 该节点是纯数据节点，无需执行信号，可在数据流中随时使用。