设置遍历

移动

移动（计数：编号，来源：设置）

移动（值：字符串，来源：设置）

移动（计数：数字，值：字符串，源：设置）

移动功能遍历集合中每个父节点的许多父节点，但不包括遍历失败的所有节点。可以作为参数提供要遍历的节点数，遍历的目标节点的名称或两者。

• 如果提供了节点数，但没有提供目标节点名，则具有指定父节点数的任何节点都将通过遍历；父节点用完的任何节点将从集合中删除
• 如果指定了目标的名称，但没有遍历的节点数，则父级在层次结构中任意位置具有匹配名称的节点将通过遍历；没有匹配父节点的任何节点都将被排除
• 如果同时提供了节点数和目标名称，则只有在指定偏移量处具有指定名称的父节点的节点才能通过遍历；所有其他节点都从集合中删除

这些调用有可能（甚至可能）生成具有重复值的集合。这是设计使然，因为集合的具体规则并未将它们定义为离散的。如果（在大多数情况下）希望您的集合是离散的，请使用“ 辅助函数帮助”主题中描述的“离散”函数。

此示例提取了一个名为“ OPERATION”的所有节点的集合，然后将每个节点向上遍历到其直接父级。排除没有父项的任何“ OPERATION”节点。

move（1，getByNode（“ OPERATION”））

此示例提取一组名为“ OPERATION”的所有节点，然后遍历每个节点直至第一个“ CLASS”父节点。排除没有“ CLASS”父级的任何“ OPERATION”节点。

move（“ CLASS”，getByNode（“ OPERATION”））

此示例提取了一个名为“ OPERATION”的所有节点的集合，然后将每个节点向上遍历到其直接父级。如果父节点不是“ CLASS”节点，或者该节点无法通过父节点而无法遍历，则将其排除在外。

move（1，“ CLASS”，getByNode（“ OPERATION”））

过滤

过滤器（计数：编号，来源：设置）

过滤器（值：字符串，来源：设置）

过滤器（计数：数字，值：字符串，来源：设置）

“过滤器”功能与“移动”功能相同，不同之处在于它不修改节点-它是非破坏性的。如果节点无法通过指定的遍历，则将其从集合中删除。通过遍历的节点保持不变。

通常希望通过当前节点名称来过滤集合。这可以用来确保从“ getByName”或“ getByValue”调用返回的节点具有特定的节点类型。本示例返回属性值为“ CFoo”的所有节点，其中结果节点为“ TYPE”节点。

filter（0，“ TYPE”，getByValue（“ CFoo”））

有关使用“过滤器”功能的更多详细信息，请参见“移动”功能。