From fa3848a1f2264f1dfe3576db85d0fe3046027177 Mon Sep 17 00:00:00 2001
From: muffl0n <sven@schliesing.de>
Date: Thu, 26 Nov 2015 12:56:30 +0100
Subject: [PATCH] Add example for regex_replace using named groups

---
 docsite/rst/playbooks_filters.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docsite/rst/playbooks_filters.rst b/docsite/rst/playbooks_filters.rst
index 7d4ace9c4b1..32933ee9d4a 100644
--- a/docsite/rst/playbooks_filters.rst
+++ b/docsite/rst/playbooks_filters.rst
@@ -520,6 +520,9 @@ To replace text in a string with regex, use the "regex_replace" filter::
     # convert "foobar" to "bar"
     {{ 'foobar' | regex_replace('^f.*o(.*)$', '\\1') }}
 
+    # convert "localhost:80" to "localhost, 80" using named groups
+    {{ 'localhost:80' | regex_replace('^(?P<host>.+):(?P<port>\\d+)$', '\\g<host>, \\g<port>') }}
+
 .. note:: Prior to ansible 2.0, if "regex_replace" filter was used with variables inside YAML arguments (as opposed to simpler 'key=value' arguments),
    then you needed to escape backreferences (e.g. ``\\1``) with 4 backslashes (``\\\\``) instead of 2 (``\\``).