Variable expansion (the standard term is parameter expansion, and it's also sometimes called variable substitution) basically means replacing the variable by its value. More precisely, it means replacing the $VARIABLE
construct (or ${VARIABLE}
or ${VARIABLE#TEXT}
or other constructs) by some other text which is built from the value of the variable. This other text is the expansion of the variable.
The expansion process goes as follows. (I only discuss the common case, some shell settings and extensions modify the behavior.)
- Take the value of the variable, which is a string. If the variable is not defined, use the empty string.
- If the construct includes a transformation, apply it. For example, if the construct is
${VARIABLE#TEXT}
, and the value of the variable begins withTEXT
, removeTEXT
from the beginning of the value. - If the context calls for a single word (for example within double quotes, or in the right-hand side of an assignment, or inside a here document), stop here. Otherwise continue with the next steps.
- Split the value into separate words at each sequence of whitespace. (The variable
IFS
can be changed to split at characters other than whitespace.) The result is thus no longer a string, but a list of strings. This list can be empty if the value contained only whitespace. - Treat each element of the list as a file name wildcard pattern, i.e. a glob. If the pattern matches some files, it is replaces by the list of matching file names, otherwise it is left alone.
For example, suppose that the variable foo
contains a* b* c*
and the current directory contains the files bar
, baz
and paz
. Then ${foo#??}
is expanded as follows:
- The value of the variable is the 8-character string
a* b* c*
. #??
means strip off the first two characters, resulting in the 6-character stringb* c*
(with an initial space).- If the expansion is in a list context (i.e. not in double quotes or other similar context), continue.
- Split the string into whitespace-delimited words, resulting in a list of two-strings:
b*
andc*
. - The string
b*
, interpreted as a pattern, matches two files:bar
andbaz
. The stringc*
matches no file so it is left alone. The result is a list of three strings:bar
,baz
,c*
.
For example echo ${foo#??}
prints bar baz c*
(the command echo
joins its arguments with a space in between).
For more details, see: