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):操作绝不会直接修改原始母列表,而是分别生成并返回两个全新的子列表副本。