Merge pull request #6984 from clconway/variable-re-doc

Adds search/match examples to "Playbooks > Variables > Jinja2 Filters" d...

1 files changed, 12 insertions, 0 deletions

diff --git a/docsite/rst/playbooks_variables.rst b/docsite/rst/playbooks_variables.rst
index b8cfbff380..f09bce8e98 100644
--- a/docsite/rst/playbooks_variables.rst
+++ b/docsite/rst/playbooks_variables.rst
@@ -298,6 +298,18 @@ doesn't know it is a boolean value::
    - debug: msg=test
      when: some_string_value | bool
 
+To match strings against a regex, use the "match" or "search" filter::
+
+    vars:
+      url: "http://example.com/users/foo/resources/bar"
+
+    tasks:
+        - debug: 'msg="Resource URI: {{ url }}"'
+          when: url | match("http://example.com/users/.*/resources/.*")
+
+        - debug: 'msg="Resource path: {{ url }}"'
+          when: url | search("/users/.*/resources/.*")
+
 To replace text in a string with regex, use the "regex_replace" filter::
 
     # convert "ansible" to "able"