Meaning of “[: too many arguments” error from if [] (square brackets)

If your $VARIABLE is a string containing spaces or other special characters, and single square brackets are used (which is a shortcut for the test command), then the string may be split out into multiple words. Each of these is treated as a separate argument.

So that one variable is split out into many arguments:

VARIABLE=$(/some/command);  
# returns "hello world"

if [ $VARIABLE == 0 ]; then
  # fails as if you wrote:
  # if [ hello world == 0 ]
fi

The same will be true for any function call that puts down a string containing spaces or other special characters.

Easy fix

Wrap the variable output in double quotes, forcing it to stay as one string (therefore one argument). For example,

VARIABLE=$(/some/command);
if [ "$VARIABLE" == 0 ]; then
  # some action
fi

Simple as that. But skip to “Also beware…” below if you also can’t guarantee your variable won’t be an empty string, or a string that contains nothing but whitespace.

Or, an alternate fix is to use double square brackets (which is a shortcut for the new test command).

This exists only in bash (and apparently korn and zsh) however, and so may not be compatible with default shells called by /bin/sh etc.

This means on some systems, it might work from the console but not when called elsewhere, like from cron, depending on how everything is configured.

It would look like this:

VARIABLE=$(/some/command);
if [[ $VARIABLE == 0 ]]; then
  # some action
fi

If your command contains double square brackets like this and you get errors in logs but it works from the console, try swapping out the [[ for an alternative suggested here, or, ensure that whatever runs your script uses a shell that supports [[ aka new test.

Also beware of the [: unary operator expected error

If you’re seeing the “too many arguments” error, chances are you’re getting a string from a function with unpredictable output. If it’s also possible to get an empty string (or all whitespace string), this would be treated as zero arguments even with the above “quick fix”, and would fail with [: unary operator expected

It’s the same ‘gotcha’ if you’re used to other languages – you don’t expect the contents of a variable to be effectively printed into the code like this before it is evaluated.

Here’s an example that prevents both the [: too many arguments and the [: unary operator expected errors: replacing the output with a default value if it is empty (in this example, 0), with double quotes wrapped around the whole thing:

VARIABLE=$(/some/command);
if [ "${VARIABLE:-0}" == 0 ]; then
  # some action
fi

(here, the action will happen if $VARIABLE is 0, or empty. Naturally, you should change the 0 (the default value) to a different default value if different behaviour is wanted)

Final note: Since [ is a shortcut for test, all the above is also true for

Related Posts:

  1. How do I parse command line arguments in Bash?
  2. How to make “if not true condition”?
  3. An “and” operator for an “if” statement in Bash
  4. Passing parameters to a Bash function
  5. An “and” operator for an “if” statement in Bash
  6. How do I compare two string variables in an ‘if’ statement in Bash?
  7. find: missing argument to -exec
  8. Bash if statement with multiple conditions throws an error
  9. How do I pause my shell script for a second before continuing?
  10. Cp: target is not a directory
  11. How to create a file in Linux from terminal window? [closed]
  12. In the shell, what does ” 2>&1 ” mean?
  13. What is the preferred Bash shebang?
  14. How to compare strings in Bash
  15. How to decode Seagate’s hard drive date code in a Bash script
  16. What does export PS1=”\[\033[36m\]\u\[\033[m\]@\[\033[32m\]\h:\[\033[33;1m\]\w\[\033[m\]\$ ” mean in MacOS’ bash Terminal?
  17. How do I use a regex in a shell script?
  18. How do I execute a bash script in Terminal?
  19. Multi-line string with extra space (preserved indentation)
  20. Bash script and /bin/bash^M: bad interpreter: No such file or directory
  21. ‘\r’: command not found – .bashrc / .bash_profile [duplicate]
  22. How can I check if a directory exists in a Bash shell script?
  23. Echo newline in Bash prints literal \n
  24. What is $@ in Bash? [duplicate]
  25. Bash script and /bin/bash^M: bad interpreter: No such file or directory [duplicate]
  26. Echo newline in Bash prints literal \n
  27. What is $@ in Bash?
  28. How can I use “:” as an AWK field separator?
  29. “while :” vs. “while true” [duplicate]
  30. How can I declare and use Boolean variables in a shell script?
  31. What is the meaning of 2 in 2> /dev/null
  32. How to reload .bash_profile from the command line?
  33. What is the purpose of “&&” in a shell command?
  34. Replace one substring for another string in shell script
  35. Parsing JSON with Unix tools
  36. “[ ]” vs. “[[ ]]” in Bash shell
  37. Bash scripting missing ‘]’
  38. Cannot use mkdir in home directory: permission denied (Linux Lubuntu)
  39. Using find command in bash script
  40. Return value in a Bash function
  41. Emulating a do-while loop in Bash
  42. How can I count all the lines of code in a directory recursively?
  43. How can I kill a process by name instead of PID, on Linux?
  44. How to change the output color of echo in Linux
  45. Which characters need to be escaped when using Bash?
  46. Delete all local git branches
  47. How can I get the source directory of a Bash script from within the script itself?
  48. cp: missing destination file operand after
  49. BASH Syntax error near unexpected token ‘done’
  50. Shell: How to call one shell script from another shell script?
  51. bash assign default value
  52. What does -z mean in Bash?
  53. How can I match a string with a regex in Bash?
  54. echo that outputs to stderr
  55. How to define hash tables in Bash?
  56. How to escape single quotes within single quoted strings
  57. Grep ‘binary file matches’. How to get normal grep output?
  58. What is cp: cannot stat error in Unix, I get this error when trying to copy thing from one folder to another
  59. Simple logical operators in Bash
  60. Laravel PHP Command Not Found
  61. Getting an “ambiguous redirect” error
  62. Bash syntax error: unexpected end of file
  63. How to convert a string to lower case in Bash?
  64. Binary Data Posting with curl
  65. Difference between return and exit in Bash functions
  66. How to modify a global variable within a function in bash?
  67. How to modify a global variable within a function in bash?
  68. How do I automatically restart a Minecraft Spigot server in the event of a crash or /stop when using screen?
  69. How do I remove the file suffix and path portion from a path string in Bash?
  70. Sorting data based on second column of a file
  71. Using SED with wildcard
  72. How do I add a newline using printf?
  73. zip error – Nothing to do
  74. How to remove last n characters from a string in Bash?
  75. How can I check if a program exists from a Bash script?
  76. Bash command to sum a column of numbers
  77. Check existence of input argument in a Bash shell script
  78. How to split one string into multiple strings separated by at least one space in bash shell?
  79. “Error installing rails” because “extconf.rb failed” on Ubuntu 18.04
  80. Make a Bash alias that takes a parameter?
  81. Copy multiple files from one directory to another from Linux shell
  82. How to ssh from within a bash script?
  83. curl: no URL specified for restful api
  84. How can I do a recursive find/replace of a string with awk or sed?
  85. Running bash script from within python
  86. How to run C program on Mac OS X using Terminal?
  87. bash : cd : too many arguments
  88. Bash mkdir and subfolders
  89. How to get the first line of a file in a bash script?
  90. How to open Emacs inside Bash
  91. bash which OR operator to use – pipe v double pipe
  92. Integer expression expected error in shell script
  93. Error when using ‘sed’ with ‘find’ command on OS X: “invalid command code .”
  94. What is the difference between double and single square brackets in bash?
  95. How to create a UUID in bash?
  96. Check if array is empty in Bash
  97. Run an interactive bash subshell with initial commands without returning to the (“super”) shell immediately
  98. bash: print stderr in red color
  99. Clean way to write complex multi-line string to a variable
  100. Standard place for user defined bash_completion.d scripts?

Leave a Comment

tech