Skip to content

Instantly share code, notes, and snippets.

@micrub
Created February 19, 2018 21:17
Show Gist options
  • Save micrub/5f58279d9ab6e4ccd798cfbac4e049e3 to your computer and use it in GitHub Desktop.
Save micrub/5f58279d9ab6e4ccd798cfbac4e049e3 to your computer and use it in GitHub Desktop.
check if a variable is set in bash

The right way

if [ -z ${var+x} ]; then echo "var is unset"; else echo "var is set to '$var'"; fi

where ${var+x} is a parameter expansion which evaluates to nothing if var is unset, and substitutes the string x otherwise.

Quotes Digression

Quotes can be omitted (so we can say ${var+x} instead of "${var+x}") because this syntax & usage guarantees this will only expand to something that does not require quotes (since it either expands to x (which contains no word breaks so it needs no quotes), or to nothing (which results in [ -z ], which conveniently evaluates to the same value (true) that [ -z "" ] does as well)).

However, while quotes can be safely omitted, and it was not immediately obvious to all (it wasn't even apparent to the first author of this quotes explanation who is also a major Bash coder), it would sometimes be better to write the solution with quotes as [ -z "${var+x}" ], at the very small possible cost of an O(1) speed penalty. The first author also added this as a comment next to the code using this solution giving the URL to this answer, which now also includes the explanation for why the quotes can be safely omitted.

The wrong way

if [ -z "$var" ]; then echo "var is unset"; else echo "var is set to '$var'"; fi

This is because it doesn't distinguish between a variable that is unset and a variable that is set to the empty string. That is to say, if var='', then the above solution will incorrectly output that var is unset.

But this distinction is essential in situations where the user has to specify an extension, or additional list of properties, and that not specifying them defaults to a non-empty value, whereas specifying the empty string should make the script use an empty extension or list of additional properties.

<Edits must be at least 6 characters - this is buffer text>

https://stackoverflow.com/questions/3601515/how-to-check-if-a-variable-is-set-in-bash/13864829#13864829

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment