ansible.builtin.contains 测试 – 列表是否包含此元素

注意

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

概要 

检查提供的元素是否存在于输入列表中。

输入 

这描述了测试的输入，即 is ansible.builtin.contains 或 is not ansible.builtin.contains 之前的值。

参数	注释
输入 list / elements=any / required	要比较的元素列表。

关键字参数 

这描述了测试的关键字参数。这些是以下示例中的值 key1=value1、key2=value2 等：input is ansible.builtin.contains(key1=value1, key2=value2, ...) 和 input is not ansible.builtin.contains(key1=value1, key2=value2, ...)

参数	注释
_contained any / required	要测试的元素。

示例 

# simple expression
{{ listofthings is contains('this') }}

# as a selector
- action: module=doessomething
  when: (lacp_groups|selectattr('interfaces', 'contains', 'em1')|first).master
  vars:
    lacp_groups:
      - master: lacp0
        network: 10.65.100.0/24
        gateway: 10.65.100.1
        dns4:
          - 10.65.100.10
          - 10.65.100.11
        interfaces:
          - em1
          - em2

      - master: lacp1
        network: 10.65.120.0/24
        gateway: 10.65.120.1
        dns4:
          - 10.65.100.10
          - 10.65.100.11
        interfaces:
            - em3
            - em4

返回值 

键	描述
返回值布尔值	如果指定的元素包含在提供的序列中，则返回 `True`，否则返回 `False`。返回：成功

作者

Ansible Core

提示

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