1314

I have a whole bunch of tests on variables in a bash (3.00) shell script where if the variable is not set, then it assigns a default, e.g.:

if [ -z "${VARIABLE}" ]; then 
    FOO='default'
else 
    FOO=${VARIABLE}
fi

I seem to recall there's some syntax to doing this in one line, something resembling a ternary operator, e.g.:

FOO=${ ${VARIABLE} : 'default' }

(though I know that won't work...)

Am I crazy, or does something like that exist?

2

11 Answers 11

2337

Very close to what you posted, actually. You can use something called Bash parameter expansion to accomplish this.

To get the assigned value, or default if it's missing:

FOO="${VARIABLE:-default}"  # FOO will be assigned 'default' value if VARIABLE not set or null.
# The value of VARIABLE remains untouched.

To do the same, as well as assign default to VARIABLE:

FOO="${VARIABLE:=default}"  # If VARIABLE not set or null, set it's value to 'default'. 
# Then that value will be assigned to FOO
15
  • 142
    If I wanted to find this in the documentation, what would a google for? Googling with special characters like ${:-} isn't very easy. Apr 24, 2013 at 18:34
  • 45
    In response to solarmist: "bash variable assignment default" let me to this page, and searching bash's manual page with 'variable ass' got me to the right section after ~five 'next'
    – Mooshu
    Sep 19, 2013 at 20:09
  • 117
    Note that it's not bash-specific and will work with the whole shell-family. It's safe for generic-scripts. Feb 3, 2014 at 19:58
  • 32
    @solarmist The key word is "bash parameter expansion", if you want to find more about it and its companions.
    – duleshi
    Apr 30, 2014 at 2:43
  • 31
    Here's a more in-depth explanation on the topic unix.stackexchange.com/a/122848/2407
    – jottr
    Jan 29, 2016 at 23:27
595

For command line arguments:

VARIABLE="${1:-$DEFAULTVALUE}"

which assigns to VARIABLE the value of the 1st argument passed to the script or the value of DEFAULTVALUE if no such argument was passed. Quoting prevents globbing and word splitting.

1
  • Technically you don't need the quotes in this instance, because the RHS value in a variable assignment is already not subject to the globbing or word splitting that the quotes are intended to prevent; only tilde expansion, parameter expansion, command substitution, arithmetic expansion, and quote removal. Same applies to the stuff between the :- and the closing brace. That said, using quotes is pretty harmless.
    – flabdablet
    Sep 7 at 8:58
428

If the variable is same, then

: "${VARIABLE:=DEFAULT_VALUE}"

assigns DEFAULT_VALUE to VARIABLE if not defined.

  • The colon builtin (:) ensures the variable result is not executed
  • The double quotes (") prevent globbing and word splitting.

Also see Section 3.5.3, Shell Parameter Expansion, in the Bash manual.

8
  • 47
    This tricky trick wasn't obvious to me, using the : no-effect builtin to eat the expansion of the ${..} BUT leaving VARIABLE set. Until now I was doing this: VARIABLE="${VARIABLE:-DEFAULT_VALUE}" and feeling dorky for using VARIABLE twice.
    – dino
    Oct 6, 2015 at 18:06
  • 1
    It turns out THIS DOES NOT ALWAYS WORK FOR BASH-BUILTIN VARIABLES. It's very very weird. Currently those known to me are HISTTIMEFORMAT
    – Otheus
    Apr 13, 2016 at 10:20
  • 13
    @Hans: The colon is the command (which does nothing) and thus is needed only once. E.g. : ${FOO:=DEFAULT1} ${BAR:=DEFAULT2}
    – Patrik
    May 29, 2016 at 15:45
  • 5
    Any chance to use something like this with export? I want to make this variable available to the scripts called from the current script. Sep 29, 2021 at 22:02
  • 1
    @SergeRogatch Just call export VARIABLE after you set it.
    – Sekenre
    Oct 12, 2021 at 13:59
131

To answer your question and on all variable substitutions

echo "${var}"
echo "Substitute the value of var."
    

echo "${var:-word}"
echo "If var is null or unset, word is substituted for var. The value of var does not change."
    

echo "${var:=word}"
echo "If var is null or unset, var is set to the value of word."
    

echo "${var:?message}"
echo "If var is null or unset, message is printed to standard error. This checks that variables are set correctly."
    

echo "${var:+word}"
echo "If var is set, word is substituted for var. The value of var does not change."

You can escape the whole expression by putting a \ between the dollar sign and the rest of the expression.

echo "$\{var}"
4
  • 5
    There's also {var-default} where default will be used only when var is undefined. If var is defined but null, default won't be used.
    – matt
    Oct 11, 2020 at 20:02
  • 6
    Why is there a a backslash in each line? Other answers don't have it.
    – Asclepius
    Nov 11, 2020 at 3:07
  • The "${var:?message}" can be super-helpful later on when you're stuck with only the output as log for, let's say, why some CI script failed for example: Instead of MyCmd --key ${API_KEY} erroring with (let's pretend): "MyCmd [ERROR] argument required", if you instead just do MyCmd --key ${API_KEY:?}, everyone can see an understandable error: sh: API_KEY: parameter not set and if set -e, the script will exit with error immediately 👏
    – conny
    Jun 9 at 3:38
  • echo "$\{var}" produces $\{var}, maybe you want echo "\${var}" which produces ${var}. Jul 6 at 8:29
63

Even you can use like default value the value of another variable

having a file defvalue.sh

#!/bin/bash
variable1=$1
variable2=${2:-$variable1}

echo $variable1
echo $variable2

run ./defvalue.sh first-value second-value output

first-value
second-value

and run ./defvalue.sh first-value output

first-value
first-value
0
42

FWIW, you can provide an error message like so:

USERNAME=${1:?"Specify a username"}

This displays a message like this and exits with code 1:

./myscript.sh
./myscript.sh: line 2: 1: Specify a username

A more complete example of everything:

#!/bin/bash
ACTION=${1:?"Specify 'action' as argv[1]"}
DIRNAME=${2:-$PWD}
OUTPUT_DIR=${3:-${HOMEDIR:-"/tmp"}}

echo "$ACTION"
echo "$DIRNAME"
echo "$OUTPUT_DIR"

Output:

$ ./script.sh foo
foo
/path/to/pwd
/tmp

$ export HOMEDIR=/home/myuser
$ ./script.sh foo
foo
/path/to/pwd
/home/myuser
  • $ACTION takes the value of the first argument, and exits if empty
  • $DIRNAME is the 2nd argument, and defaults to the current directory
  • $OUTPUT_DIR is the 3rd argument, or $HOMEDIR (if defined), else, /tmp. This works on OS X, but I'm not positive that it's portable.
1
  • It's no wonder these timesaver bash functions are unknown by a lot of people. How can you search for them? bash macros, bash functions, bash builtins nothing gets you there. Nov 14 at 16:54
42

see here under 3.5.3(shell parameter expansion)

so in your case

${VARIABLE:-default}
33

It is possible to chain default values like so:

DOCKER_LABEL=${GIT_TAG:-${GIT_COMMIT_AND_DATE:-latest}}

i.e. if $GIT_TAG doesnt exist, take $GIT_COMMIT_AND_DATE - if this doesnt exist, take "latest"

1
  • 1
    Very nice and useful 👌
    – SRG
    Nov 10, 2022 at 7:46
23

Then there's the way of expressing your 'if' construct more tersely:

FOO='default'
[ -n "${VARIABLE}" ] && FOO=${VARIABLE}
0
13

Here is an example

#!/bin/bash

default='default_value'
value=${1:-$default}

echo "value: [$value]"

save this as script.sh and make it executable. run it without params

./script.sh
> value: [default_value]

run it with param

./script.sh my_value
> value: [my_value]
3

If you want 1 liner for your if-then-else, then we can consider rewriting:

if [ -z "${VARIABLE}" ]; then 
    FOO='default'
else 
    FOO=${VARIABLE}
fi

with semicolons:

if [ -z ${VARIABLE} ]; then FOO=`default`; else FOO=${VARIABLE}; fi

Alternatively, you can drop the if-then-else-fi keywords if you use boolean operators such as:

[ -z "${VARIABLE}" ] && FOO='default' || FOO=${VARIABLE}

Generalizing, the boolean operator pattern is:

conditional && then_command || else_command

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.