Add example of checking registered variable for emptiness. (#15510)

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::