ansible.builtin.split 过滤器 – 将字符串拆分为列表

注意

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

ansible-core 2.11 中的新增功能

概要

  • 使用 Python 的文本对象方法 split,我们通过“拆分字符”将字符串转换为列表。

输入

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

参数

注释

输入

字符串 / 必需

要拆分的字符串。

位置参数

这描述了过滤器的位置参数。这些是在以下示例中的值 positional1positional2 等:input | ansible.builtin.split(positional1, positional2, ...)

参数

注释

_split_string

字符串

要在其上拆分原始字符串的字符串。

默认值: " "

注释

注意

  • 这是 Python 的 str.split 的传递。

示例

# listjojo => [ "jojo", "is", "a" ]
listjojo: "{{ 'jojo is a' | split }}"

# listjojocomma => [ "jojo is", " a" ]
listjojocomma: "{{ 'jojo is, a' | split(',') }}"

返回值

描述

返回值

列表 / 元素=字符串

从原始字符串拆分的子字符串列表。

返回值:成功

提示

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