summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docsite/rst/playbooks_conditionals.rst16
1 files changed, 16 insertions, 0 deletions
diff --git a/docsite/rst/playbooks_conditionals.rst b/docsite/rst/playbooks_conditionals.rst
index f28ee4ec0b..f66f2a89c7 100644
--- a/docsite/rst/playbooks_conditionals.rst
+++ b/docsite/rst/playbooks_conditionals.rst
@@ -271,6 +271,22 @@ fields::
with_items: home_dirs.stdout_lines
# same as with_items: home_dirs.stdout.split()
+As shown previously, the registered variable's string contents are accessible with the 'stdout' value.
+You may check the registered variable's string contents for emptiness::
+
+ - name: check registered variable for emptiness
+ hosts: all
+
+ tasks:
+
+ - name: list contents of directory
+ command: ls mydir
+ register: contents
+
+ - name: check contents for emptiness
+ debug: msg="Directory is empty"
+ when: contents.stdout == ""
+
.. seealso::