ansible/community.general
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2024-09-14 20:13:21 +02:00
Code Releases Activity

Documenting second parameter of the default filter (#31184)

Browse source 
* Documenting second parameter of the default filter

* Edited for clarity and grammar.

* Adding missing colon
This commit is contained in:
Jiri Tyr 2017-11-13 23:51:22 +00:00 committed by scottb
parent ea3638b580
commit f4f5c4d92a
1 changed files with 6 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
docs/docsite/rst/playbooks_filters.rst
View file

@ -63,13 +63,18 @@ The variable value will be used as is, but the template evaluation will raise an
Defaulting Undefined Variables Defaulting Undefined Variables
`````````````````````````````` ``````````````````````````````
Jinja2 provides a useful 'default' filter, that is often a better approach to failing if a variable is not defined:: Jinja2 provides a useful 'default' filter that is often a better approach to failing if a variable is not defined::
{{ some_variable | default(5) }} {{ some_variable | default(5) }}
In the above example, if the variable 'some_variable' is not defined, the value used will be 5, rather than an error In the above example, if the variable 'some_variable' is not defined, the value used will be 5, rather than an error
being raised. being raised.
If the variable evaluates to an empty string, the second parameter of the filter should be set to
`true`::
{{ lookup('env', 'MY_USER') | default('admin', true) }}
.. _omitting_undefined_variables: .. _omitting_undefined_variables: