GetListLength 列表元素计数与长度获取节点
节点核心功能 (What is it?)
GetListLength 节点是一个实用的列表度量工具节点，用于计算并输出任意列表中包含的子元素总数量（Length / Size）。它为创作者在工作流中量化列表规模提供了极简的标准接口。
典型适用场景 (When would I use it?)
在以下情况下使用 GetListLength 节点：
- 获知特定列表中当前包含的具体元素总数；
- 检查列表内元素数量是否达标或是否为空；
- 构建依赖于集合规模（Size-dependent）的循环分批或分支工作流；
- 在执行复杂矩阵计算或下游消费前校验列表长度是否合规；
- 监控工作流在多轮迭代中数据列表的动态扩张与收缩。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 GetListLength 节点。
- 将待测量的任意列表连接至
items输入插槽。 - 节点将自动计算其实际长度，并从
length引脚输出对应的整数计数值。
参数输入插槽 (Parameters)
- items：待测量长度的目标列表（
list类型输入端）。
输出引脚 (Outputs)
- length：表示输入列表中子项总数量的非负整数（
integer）。
典型工作流示例 (Example)
获取待办任务清单中的总任务条数：
- 在画布中添加 GetListLength 节点。
- 将任务列表数据连入
items输入插槽。 - 节点的
length输出引脚将即刻输出任务总数（例如输入包含 5 项任务，输出即为5）。
关键技术特性 (Important Notes)
- 响应式动态同步：只要输入列表的元素增删改动，输出的长度数值即刻自动重新计算并同步；
- 非负保底：计算出的长度数值始终为非负整数（$\ge 0$）；
- 全类型列表泛化兼容：兼容由任何数据类型构建的列表容器；
- 缺省与空列表处理：当输入为空列表或未接入任何连线时，长度安全输出为
0。
常见问题与排查 (Common Issues)
- 未接入输入 (Empty List)：未接入列表连线时，节点输出安全为
0。 - 非法类型接入 (Invalid Input)：如果输入引脚连接了非列表对象，节点同样会安全地将长度计为
0。