ansible.builtin.intersect 过滤器 – 列表的交集

注意

此过滤器插件是 ansible-core 的一部分,包含在所有 Ansible 安装中。在大多数情况下,您可以使用简短的插件名称 intersect。但是,我们建议您使用完全限定集合名称 (FQCN) ansible.builtin.intersect,以便轻松链接到插件文档,并避免与其他可能具有相同过滤器插件名称的集合冲突。

概要

  • 提供一个包含来自其他列表的公共元素的列表。

  • 结果列表中的项目以任意顺序返回。

输入

这描述了过滤器的输入,即 | ansible.builtin.intersect 前面的值。

参数

注释

输入

list / elements=string / required

一个列表。

关键字参数

这描述了过滤器的关键字参数。 这些是以下示例中 key1=value1, key2=value2 等的值:input | ansible.builtin.intersect(key1=value1, key2=value2, ...)

参数

注释

_second_list

list / elements=string / required

一个列表。

另请参阅

另请参阅

ansible.builtin.difference 过滤器插件

一个列表与另一个列表的差集。

ansible.builtin.symmetric_difference 过滤器插件

来自两个列表的不同项。

ansible.builtin.unique 过滤器插件

列表的唯一项的集合。

ansible.builtin.union 过滤器插件

列表的并集。

示例

# return only the common elements of list1 and list2
# list1: [1, 2, 5, 3, 4, 10]
# list2: [1, 2, 3, 4, 5, 11, 99]
{{ list1 | intersect(list2) }}
# => [1, 2, 5, 3, 4]

返回值

描述

返回值

list / elements=string

包含两个列表共有的唯一元素的列表,也称为集合。

已返回: 成功

作者

  • Brian Coca (@bcoca)

提示

每个条目类型的配置条目都具有从低到高的优先级顺序。 例如,列表中较低的变量将覆盖较高的变量。