ansible.builtin.regex 测试 – 字符串是否从开头匹配正则表达式

注意

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

摘要

  • 使用 Python 的 match 或 search 函数将字符串与正则表达式进行比较。

输入

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

参数

注释

输入

字符串 / 必需

要匹配的字符串。

关键字参数

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

参数

注释

ignorecase

布尔值

使用不区分大小写的匹配。

选项

  • false ← (默认)

  • true

match_type

字符串

决定使用哪个函数进行匹配。

选项

  • "match"

  • "search" ← (默认)

multiline

布尔值

针对字符串中的多行进行匹配。

选项

  • false ← (默认)

  • true

pattern

字符串 / 必需

要匹配的正则表达式。

示例

url: "https://example.com/users/foo/resources/bar"
foundmatch: url is regex("example\.com/\w+/foo")

返回值

键

描述

返回值

布尔值

如果匹配，则返回 True，否则返回 False。

返回：success

作者

  • Ansible 核心

提示

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