diff --git a/docsite/rst/playbooks_conditionals.rst b/docsite/rst/playbooks_conditionals.rst index f28ee4ec0b1..f66f2a89c7d 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::