How to check if a variable is set in Bash?

(Usually) 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.

(Often) The wrong way

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

This is often wrong 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 output “var is blank”.

The distinction between unset and “set to the empty string” 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.

The distinction may not be essential in every scenario though. In those cases [ -z "$var" ] will be just fine.

Related Posts:

  1. How do I split a string on a delimiter in Bash?
  2. Ubuntu says “bash: ./program Permission denied” [closed]
  3. How to concatenate string variables in Bash
  4. -bash: syntax error near unexpected token `)’
  5. An example of how to use getopts in bash
  6. How do I iterate over a range of numbers defined by variables in Bash?
  7. How do I iterate over a range of numbers defined by variables in Bash?
  8. “unary operator expected” error in Bash if condition
  9. What does “-ne” mean in bash?
  10. How to generate random number in Bash?
  11. How can I compare numbers in Bash?
  12. Open and write data to text file using Bash?
  13. How do I set a variable to the output of a command in Bash?
  14. Is there a TRY CATCH command in Bash
  15. Run a string as a command within a Bash script
  16. Meaning of “! -S” in shell script
  17. “No such file or directory” but it exists
  18. How do I pause my shell script for a second before continuing?
  19. In the shell, what does ” 2>&1 ” mean?
  20. Extract substring in Bash
  21. Should I put #! (shebang) in Python scripts, and what form should it take?
  22. Should I put #! (shebang) in Python scripts, and what form should it take?
  23. In the shell, what does ” 2>&1 ” mean?
  24. How do I use a regex in a shell script?
  25. How do I copy a folder from remote to local using scp?
  26. How to grep for case insensitive string in a file?
  27. Difference between wait and sleep
  28. Multi-line string with extra space (preserved indentation)
  29. ‘\r’: command not found – .bashrc / .bash_profile [duplicate]
  30. How to mkdir only if a directory does not already exist?
  31. How can I check if a directory exists in a Bash shell script?
  32. How to set ssh timeout?
  33. commands not found on zsh
  34. sudo: apt-get: command not found
  35. Why do people write #!/usr/bin/env python on the first line of a Python script?
  36. Using find to locate files that match one of multiple patterns
  37. “sed” command in bash
  38. How to reload .bashrc settings without logging out and back in again?
  39. Is there a Python equivalent to the ‘which’ command
  40. How can I declare and use Boolean variables in a shell script?
  41. How to reload .bash_profile from the command line?
  42. What is the purpose of “&&” in a shell command?
  43. How do I split a string on a delimiter in Bash?
  44. Pseudo-terminal will not be allocated because stdin is not a terminal
  45. How to trim whitespace from a Bash variable?
  46. Who can access a file with octal permissions “000” on Linux/UNIX?
  47. What is a list in Bash?
  48. What does the line “#!/bin/sh” mean in a UNIX shell script?
  49. How can I count all the lines of code in a directory recursively?
  50. How can I kill a process by name instead of PID, on Linux?
  51. Pass variable from one Jenkins stage to others in sh
  52. Which characters need to be escaped when using Bash?
  53. How to remove the quotes when reading a variable in jq in shell?
  54. Shell: How to call one shell script from another shell script?
  55. Pseudo-terminal will not be allocated because stdin is not a terminal
  56. How to trim whitespace from a Bash variable?
  57. find: missing argument to -exec
  58. python getoutput() equivalent in subprocess
  59. ./configure : /bin/sh^M : bad interpreter
  60. How to check if an environment variable exists and get its value?
  61. Create timestamp variable in bash script
  62. How to convert a string to lower case in Bash?
  63. dquote> result of a execution a program in linux shell
  64. Using sudo with Python script
  65. How to modify a global variable within a function in bash?
  66. How to modify a global variable within a function in bash?
  67. how to fix the issue “Command /bin/sh failed with exit code 1” in iphone
  68. Create a new file in git bash
  69. conditional binary operator expected in shell script
  70. How to specify the private SSH-key to use when executing shell command on Git?
  71. Block Comments in a Shell Script
  72. Sorting data based on second column of a file
  73. Writing a simple shell in C using fork/execvp
  74. Speed up rsync with Simultaneous/Concurrent File Transfers?
  75. Multi-dimensional arrays in Bash
  76. Variable interpolation in the shell
  77. chmod: changing permissions of ‘my_script.sh’: Operation not permitted
  78. What’s the meaning of the parameter -e for bash shell command line?
  79. zip error – Nothing to do
  80. How to sort an array in Bash
  81. What does set -e mean in a bash script?
  82. What does set -e mean in a bash script?
  83. Check existence of input argument in a Bash shell script
  84. Associative arrays in Shell scripts
  85. How to split one string into multiple strings separated by at least one space in bash shell?
  86. Copy multiple files from one directory to another from Linux shell
  87. Shell script not running, command not found
  88. source command not found in sh shell
  89. How to get a shell environment variable in a makefile?
  90. Difference between sh and Bash
  91. What are the uses of the exec command in shell scripts? 
  92. using rot13 and tr command for having an encrypted email address
  93. Shell Script: Execute a python program from within a shell script
  94. How to parse XML in Bash?
  95. How do I know the script file name in a Bash script?
  96. What is the difference between double and single square brackets in bash?
  97. What is “-bash: !”: event not found”
  98. How to add a timestamp to bash script log?
  99. Colors in bash after piping through less?
  100. How to run command as user who has /usr/sbin/nologin as Shell?

Leave a Comment

tech