跳转至

Split List 列表按索引或元素切分拆解节点

Split List 节点允许创作者将一个母列表一分为二,拆解为两个独立的子列表(Output A 与 Output B)。它支持按指定的数字索引下标进行切分,也支持依据匹配特定的目标元素值进行断点拆分。

输入引脚规范 (Inputs)

  • Items(list):待执行切分拆解的目标母列表。
  • Split Index(int):执行切分的断点数字索引下标(仅当 Split By 设置为 "index" 时动态可见)。
  • Split Item(any):执行切分的分隔参照元素项(仅当 Split By 设置为 "item" 时动态可见)。

面板属性 (Properties)

  • Split By(str):切分拆解列表的基准策略:
    • "index":在指定的索引下标位置切断;
    • "item":在与特定元素值匹配的位置切断。
  • Keep Split Item(bool):按元素切分时,是否将该分隔参考元素保留在后半段列表中(布尔开关,仅当 Split By 设置为 "item" 时动态展现)。

输出引脚规范 (Outputs)

  • Output A(list):切分后得到的前半部分子列表。
  • Output B(list):切分后得到的后半部分子列表。

使用示例 (Example)

# 原始输入列表 Items: [1, 2, 3, 4]

# 方式一:按索引切分 (Split by index)
# Split Index: 2
# Output A: [1, 2]
# Output B: [3, 4]

# 方式二:按元素值切分并保留切分项 (Keep Split Item: True)
# Split Item: 3
# Keep Split Item: True
# Output A: [1, 2]
# Output B: [3, 4]

# 方式三:按元素值切分并剔除切分项 (Keep Split Item: False)
# Split Item: 3
# Keep Split Item: False
# Output A: [1, 2]
# Output B: [4]

关键技术特性 (Notes)

  • 索引切分归属:当使用 "index" 模式时,指定下标处的元素默认归入后半段子列表(Output B);
  • 灵活保留分隔符:当使用 "item" 模式时,可通过 Keep Split Item 开关自由决定是将参考项留在 Output B 中,还是直接作为分隔符从两个列表中均予以剥离;
  • 元素未找到保底:若按元素切分时母列表中未找到该项,节点不会拆解,Output A 安全返回原列表,Output B 返回空列表 [];
  • 索引边界安全性:按索引切分时,输入的下标必须处于列表合法长度边界内;
  • 不可变原则 (Immutability):操作绝不会直接修改原始母列表,而是分别生成并返回两个全新的子列表副本。