311

I am confused about a bash script.

I have the following code:

function grep_search() {
    magic_way_to_define_magic_variable_$1=`ls | tail -1`
    echo $magic_variable_$1
}

I want to be able to create a variable name containing the first argument of the command and bearing the value of e.g. the last line of ls.

So to illustrate what I want:

$ ls | tail -1
stack-overflow.txt

$ grep_search() open_box
stack-overflow.txt

So, how should I define/declare $magic_way_to_define_magic_variable_$1 and how should I call it within the script?

I have tried eval, ${...}, \$${...}, but I am still confused.

4
  • 4
    Don't. Use an associative array to map the command name to the data.
    – chepner
    Commented May 14, 2013 at 21:38
  • 7
    VAR=A; VAL=333; read "$VAR" <<< "$VAL"; echo "A = $A"
    – Grigory K
    Commented Apr 18, 2018 at 10:05
  • When can this be useful?
    – Timo
    Commented Nov 9, 2020 at 16:22
  • @Timo For example with argument indexes, as in "${!ARGUMENT_INDEX:-default}"
    – caw
    Commented Sep 17, 2021 at 4:34

20 Answers 20

414

I've been looking for better way of doing it recently. Associative array sounded like overkill for me. Look what I found:

suffix=bzz
declare prefix_$suffix=mystr

...and then...

varname=prefix_$suffix
echo ${!varname}

From the docs:

The ‘$’ character introduces parameter expansion, command substitution, or arithmetic expansion. ...

The basic form of parameter expansion is ${parameter}. The value of parameter is substituted. ...

If the first character of parameter is an exclamation point (!), and parameter is not a nameref, it introduces a level of indirection. Bash uses the value formed by expanding the rest of parameter as the new parameter; this is then expanded and that value is used in the rest of the expansion, rather than the expansion of the original parameter. This is known as indirect expansion. The value is subject to tilde expansion, parameter expansion, command substitution, and arithmetic expansion. ...

16
  • 16
    best to use encapsulated variable format: prefix_${middle}_postfix (ie. your formatting wouldn't not work for varname=$prefix_suffix)
    – msciwoj
    Commented Dec 5, 2014 at 12:08
  • 1
    I was stuck with bash 3 and could not use associative arrays; as such this was a life saver. ${!...} not easy to google on that one. I assume it just expands a var name.
    – Goblinhack
    Commented Jan 15, 2015 at 22:37
  • 23
    @NeilMcGill: See "man bash" gnu.org/software/bash/manual/html_node/… : The basic form of parameter expansion is ${parameter}. <...> If the first character of parameter is an exclamation point (!), a level of variable indirection is introduced. Bash uses the value of the variable formed from the rest of parameter as the name of the variable; this variable is then expanded and that value is used in the rest of the substitution, rather than the value of parameter itself.
    – Yorik.sar
    Commented Jan 16, 2015 at 13:46
  • 1
    @syntaxerror: you can assign values as much as you want with "declare" command above.
    – Yorik.sar
    Commented Jun 23, 2015 at 8:09
  • 2
    @openCivilisation Which shell are you sourcing it from? You can check with echo $SHELL. macOS has zsh as a default shell these days, and ${!varname} is specifiic for Bash.
    – Yorik.sar
    Commented Jul 5, 2020 at 13:03
219

Use an associative array, with command names as keys.

# Requires bash 4, though
declare -A magic_variable=()

function grep_search() {
    magic_variable[$1]=$( ls | tail -1 )
    echo ${magic_variable[$1]}
}

If you can't use associative arrays (e.g., you must support bash 3), you can use declare to create dynamic variable names:

declare "magic_variable_$1=$(ls | tail -1)"

and use indirect parameter expansion to access the value.

var="magic_variable_$1"
echo "${!var}"

See BashFAQ: Indirection - Evaluating indirect/reference variables.

16
  • 5
    @DeaDEnD -a declares an indexed array, not an associative array. Unless the argument to grep_search is a number, it will be treated as a parameter with a numeric value (which defaults to 0 if the parameter isn't set).
    – chepner
    Commented Dec 2, 2013 at 12:24
  • 1
    Hmm. I'm using bash 4.2.45(2) and declare doesn't list it as an option declare: usage: declare [-afFirtx] [-p] [name[=value] ...]. It seems to be working correctly however.
    – fent
    Commented Dec 2, 2013 at 15:56
  • 6
    Why not just declare $varname="foo"?
    – Ben Davis
    Commented May 19, 2014 at 17:05
  • 1
    Does anyone know of a pure POSIX way of doing this, that would work with sh/dash? Commented Aug 18, 2016 at 11:00
  • 8
    ${!varname} is much simpler and widely compatible
    – Brad Hein
    Commented Apr 9, 2020 at 18:39
175

Beyond associative arrays, there are several ways of achieving dynamic variables in Bash. Note that all these techniques present risks, which are discussed at the end of this answer.

In the following examples I will assume that i=37 and that you want to alias the variable named var_37 whose initial value is lolilol.

Method 1. Using a “pointer” variable

You can simply store the name of the variable in an indirection variable, not unlike a C pointer. Bash then has a syntax for reading the aliased variable: ${!name} expands to the value of the variable whose name is the value of the variable name. You can think of it as a two-stage expansion: ${!name} expands to $var_37, which expands to lolilol.

name="var_$i"
echo "$name"         # outputs “var_37”
echo "${!name}"      # outputs “lolilol”
echo "${!name%lol}"  # outputs “loli”
# etc.

Unfortunately, there is no counterpart syntax for modifying the aliased variable. Instead, you can achieve assignment with one of the following tricks.

1a. Assigning with eval

eval is evil, but is also the simplest and most portable way of achieving our goal. You have to carefully escape the right-hand side of the assignment, as it will be evaluated twice. An easy and systematic way of doing this is to evaluate the right-hand side beforehand (or to use printf %q).

And you should check manually that the left-hand side is a valid variable name, or a name with index (what if it was evil_code # ?). By contrast, all other methods below enforce it automatically.

# check that name is a valid variable name:
# note: this code does not support variable_name[index]
shopt -s globasciiranges
[[ "$name" == [a-zA-Z_]*([a-zA-Z_0-9]) ]] || exit

value='babibab'
eval "$name"='$value'  # carefully escape the right-hand side!
echo "$var_37"  # outputs “babibab”

Downsides:

  • does not check the validity of the variable name.
  • eval is evil.
  • eval is evil.
  • eval is evil.

1b. Assigning with read

The read builtin lets you assign values to a variable of which you give the name, a fact which can be exploited in conjunction with here-strings:

IFS= read -r -d '' "$name" <<< 'babibab'
echo "$var_37"  # outputs “babibab\n”

The IFS part and the option -r make sure that the value is assigned as-is, while the option -d '' allows to assign multi-line values. Because of this last option, the command returns with an non-zero exit code.

Note that, since we are using a here-string, a newline character is appended to the value.

Downsides:

  • somewhat obscure;
  • returns with a non-zero exit code;
  • appends a newline to the value.

1c. Assigning with printf

Since Bash 3.1 (released 2005), the printf builtin can also assign its result to a variable whose name is given. By contrast with the previous solutions, it just works, no extra effort is needed to escape things, to prevent splitting and so on.

printf -v "$name" '%s' 'babibab'
echo "$var_37"  # outputs “babibab”

Downsides:

  • Less portable (but, well).

Method 2. Using a “reference” variable

Since Bash 4.3 (released 2014), the declare builtin has an option -n for creating a variable which is a “name reference” to another variable, much like C++ references. Just as in Method 1, the reference stores the name of the aliased variable, but each time the reference is accessed (either for reading or assigning), Bash automatically resolves the indirection.

In addition, Bash has a special and very confusing syntax for getting the value of the reference itself, judge by yourself: ${!ref}.

declare -n ref="var_$i"
echo "${!ref}"  # outputs “var_37”
echo "$ref"     # outputs “lolilol”
ref='babibab'
echo "$var_37"  # outputs “babibab”

This does not avoid the pitfalls explained below, but at least it makes the syntax straightforward.

Downsides:

  • Not portable.

Risks

All these aliasing techniques present several risks. The first one is executing arbitrary code each time you resolve the indirection (either for reading or for assigning). Indeed, instead of a scalar variable name, like var_37, you may as well alias an array subscript, like arr[42]. But Bash evaluates the contents of the square brackets each time it is needed, so aliasing arr[$(do_evil)] will have unexpected effects… As a consequence, only use these techniques when you control the provenance of the alias.

function guillemots {
  declare -n var="$1"
  var="«${var}»"
}

arr=( aaa bbb ccc )
guillemots 'arr[1]'  # modifies the second cell of the array, as expected
guillemots 'arr[$(date>>date.out)1]'  # writes twice into date.out
            # (once when expanding var, once when assigning to it)

The second risk is creating a cyclic alias. As Bash variables are identified by their name and not by their scope, you may inadvertently create an alias to itself (while thinking it would alias a variable from an enclosing scope). This may happen in particular when using common variable names (like var). As a consequence, only use these techniques when you control the name of the aliased variable.

function guillemots {
  # var is intended to be local to the function,
  # aliasing a variable which comes from outside
  declare -n var="$1"
  var="«${var}»"
}

var='lolilol'
guillemots var  # Bash warnings: “var: circular name reference”
echo "$var"     # outputs anything!

Source:

9
  • 6
    This is the best answer, particularly since the ${!varname} technique requires an intermediate var for varname.
    – RichVel
    Commented Nov 20, 2019 at 17:27
  • 3
    Hard to understand that this answer has not been upvoted higher
    – Marcos
    Commented Jan 10, 2020 at 5:46
  • The only qualm I have with this answer is its use of the gratuitously incompatible function funcname() { syntax; it's spot-on on everything that's actually pertinent to the question. :) Commented Mar 16, 2022 at 0:21
  • @Maëlan - You say: "All these aliasing techniques present several risks." What risks does printf -v present? (Other than not being portable to versions of bash that are over 17 years old.)
    – mpb
    Commented Apr 5, 2022 at 0:05
  • @mpb the risk shown in the sentence right after that one. :-) if name='x[$(evil)]' then each printf -v "$name" '%s' '...' evaluates evil.
    – Maëlan
    Commented Apr 5, 2022 at 16:55
26

Example below returns value of $name_of_var

var=name_of_var
echo $(eval echo "\$$var")
1
  • 10
    Nesting two echos with a command substitution (which misses quotes) is unnecessary. Plus, option -n should be given to echo. And, as always, eval is unsafe. But all of this is unnecessary since Bash has a safer, clearer and shorter syntax for this very purpose: ${!var}.
    – Maëlan
    Commented Mar 30, 2019 at 21:12
17

Use declare

There is no need on using prefixes like on other answers, neither arrays. Use just declare, double quotes, and parameter expansion.

I often use the following trick to parse argument lists contanining one to n arguments formatted as key=value otherkey=othervalue etc=etc, Like:

# brace expansion just to exemplify
for variable in {one=foo,two=bar,ninja=tip}
do
  declare "${variable%=*}=${variable#*=}"
done
echo $one $two $ninja 
# foo bar tip

But expanding the argv list like

for v in "$@"; do declare "${v%=*}=${v#*=}"; done

Extra tips

# parse argv's leading key=value parameters
for v in "$@"; do
  case "$v" in ?*=?*) declare "${v%=*}=${v#*=}";; *) break;; esac
done
# consume argv's leading key=value parameters
while test $# -gt 0; do
  case "$1" in ?*=?*) declare "${1%=*}=${1#*=}";; *) break;; esac
  shift
done
4
  • 5
    This looks like a very clean solution. No evil bibs and bobs and you use tools which are related to variables, not obscure seemingly unrelated or even dangerous functions such as printf or eval
    – kvantour
    Commented Jul 10, 2020 at 7:12
  • 1
    To prevent squirrely behavior on nutty input (e.g. key=oops=val), you should really be using the "longest matching pattern" form of these string-trimming expansions: "${v%%=*}=${v##*=}". Applies to every occurrence in your answer.
    – ardnew
    Commented Dec 13, 2023 at 16:25
  • 1
    Or if you can tolerate = symbols in values, perhaps only use the "longest matching suffix" expansion and always add quotes around your values: "${v%%=*}='${v#*=}'". This would handle key=oops=val as key='oops=val', that is, declare key with value oops=val.
    – ardnew
    Commented Dec 13, 2023 at 16:33
  • You are both right, but may think if having = within keys or values makes sense for such a simple argv parsing strategy
    – laconbass
    Commented Dec 15, 2023 at 12:01
14

Combining two highly rated answers here into a complete example that is hopefully useful and self-explanatory:

#!/bin/bash

intro="You know what,"
pet1="cat"
pet2="chicken"
pet3="cow"
pet4="dog"
pet5="pig"

# Setting and reading dynamic variables
for i in {1..5}; do
        pet="pet$i"
        declare "sentence$i=$intro I have a pet ${!pet} at home"
done

# Just reading dynamic variables
for i in {1..5}; do
        sentence="sentence$i"
        echo "${!sentence}"
done

echo
echo "Again, but reading regular variables:"
echo $sentence1
echo $sentence2
echo $sentence3
echo $sentence4
echo $sentence5

Output:

You know what, I have a pet cat at home
You know what, I have a pet chicken at home
You know what, I have a pet cow at home
You know what, I have a pet dog at home
You know what, I have a pet pig at home

Again, but reading regular variables:
You know what, I have a pet cat at home
You know what, I have a pet chicken at home
You know what, I have a pet cow at home
You know what, I have a pet dog at home
You know what, I have a pet pig at home

7

This will work too

my_country_code="green"
x="country"

eval z='$'my_"$x"_code
echo $z                 ## o/p: green

In your case

eval final_val='$'magic_way_to_define_magic_variable_"$1"
echo $final_val
6

For zsh (newers mac os versions), you should use

real_var="holaaaa"
aux_var="real_var"
echo ${(P)aux_var}
holaaaa

Instead of "!"

3
4

This should work:

function grep_search() {
    declare magic_variable_$1="$(ls | tail -1)"
    echo "$(tmpvar=magic_variable_$1 && echo ${!tmpvar})"
}
grep_search var  # calling grep_search with argument "var"
4

As per BashFAQ/006, you can use read with here string syntax for assigning indirect variables:

function grep_search() {
  read "$1" <<<$(ls | tail -1);
}

Usage:

$ grep_search open_box
$ echo $open_box
stack-overflow.txt
4

An extra method that doesn't rely on which shell/bash version you have is by using envsubst. For example:

newvar=$(echo '$magic_variable_'"${dynamic_part}" | envsubst)
1
  • 1
    thx for the one line version. The only condition, that the variable should be exported, otherwise envsubst will not see it.
    – Kostanos
    Commented Jun 8, 2022 at 19:07
3

Even though it's an old question, I still had some hard time with fetching dynamic variables names, while avoiding the eval (evil) command.

Solved it with declare -n which creates a reference to a dynamic value, this is especially useful in CI/CD processes, where the required secret names of the CI/CD service are not known until runtime. Here's how:

# Bash v4.3+
# -----------------------------------------------------------
# Secerts in CI/CD service, injected as environment variables
# AWS_ACCESS_KEY_ID_DEV, AWS_SECRET_ACCESS_KEY_DEV
# AWS_ACCESS_KEY_ID_STG, AWS_SECRET_ACCESS_KEY_STG
# -----------------------------------------------------------
# Environment variables injected by CI/CD service
# BRANCH_NAME="DEV"
# -----------------------------------------------------------
declare -n _AWS_ACCESS_KEY_ID_REF=AWS_ACCESS_KEY_ID_${BRANCH_NAME}
declare -n _AWS_SECRET_ACCESS_KEY_REF=AWS_SECRET_ACCESS_KEY_${BRANCH_NAME}

export AWS_ACCESS_KEY_ID=${_AWS_ACCESS_KEY_ID_REF}
export AWS_SECRET_ACCESS_KEY=${_AWS_SECRET_ACCESS_KEY_REF}

echo $AWS_ACCESS_KEY_ID $AWS_SECRET_ACCESS_KEY
aws s3 ls
2

Wow, most of the syntax is horrible! Here is one solution with some simpler syntax if you need to indirectly reference arrays:

#!/bin/bash

foo_1=(fff ddd) ;
foo_2=(ggg ccc) ;

for i in 1 2 ;
do
    eval mine=( \${foo_$i[@]} ) ;
    echo ${mine[@]}" " ;
done ;

For simpler use cases I recommend the syntax described in the Advanced Bash-Scripting Guide.

5
  • 5
    The ABS is someone notorious for showcasing bad practices in its examples. Please consider leaning on the bash-hackers wiki or the Wooledge wiki -- which has the directly on-topic entry BashFAQ #6 -- instead. Commented Feb 9, 2017 at 17:22
  • 3
    This works only if the entries in foo_1 and foo_2 are free of whitespace and special symbols. Examples for problematic entries: 'a b' will create two entries inside mine. '' won't create an entry inside mine. '*' will expand to the content of the working directory. You can prevent these problems by quoting: eval 'mine=( "${foo_'"$i"'[@]}" )'
    – Socowi
    Commented Mar 1, 2019 at 10:17
  • @Socowi That's a general problem with looping through any array in BASH. This could also be solved by temporarily changing the IFS (and then of course changing it back). It's good to see the quoting worked out.
    – ingyhere
    Commented May 17, 2019 at 21:54
  • 1
    @ingyhere I beg to differ. It is not a general problem. There is a standard solution: Always quote [@] constructs. "${array[@]}" will always expand to the correct list of entries without problems like word splitting or expansion of *. Also, the word splitting problem can only be circumvented with IFS if you know any non-null character that does never appear inside the array. Furthermore literal treatment of * cannot be achieved by setting IFS. Either you set IFS='*' and split at the stars or you set IFS=somethingOther and the * expands.
    – Socowi
    Commented May 18, 2019 at 10:15
  • @Socowi The general problem in loops is that tokenization occurs by default so that quoting is the special solution to allow extended strings that contain tokens. I updated the answer to remove the quoted array values which confused readers. The point of this answer was to create a simpler syntax, not a specific answer for a use case where quotes are needed to detail extended variables. Assignment quoting for specific use cases can be left to other developers' imagination.
    – ingyhere
    Commented Jul 29, 2020 at 15:25
2

KISS approach:

a=1
c="bam"
let "$c$a"=4
echo $bam1

results in 4

5
  • "echo bam1" will output "bam1", not "4" Commented Jan 7, 2022 at 3:04
  • How is this related to my response? You're echoing a string, because you're missing the $. Commented Oct 14, 2022 at 14:07
  • 1
    You were missing the $ in your answer. I commented. Later, someone edit/corrected your answer. Commented Oct 17, 2022 at 0:01
  • 3
    ahh, OK.... now all 4 comments make no sense anymore. Commented Oct 17, 2022 at 11:08
  • 2
    let only handles arithmetic, does not solve OP's problem Commented Mar 16, 2023 at 20:28
1

I want to be able to create a variable name containing the first argument of the command

script.sh file:

#!/usr/bin/env bash
function grep_search() {
  eval $1=$(ls | tail -1)
}

Test:

$ source script.sh
$ grep_search open_box
$ echo $open_box
script.sh

As per help eval:

Execute arguments as a shell command.


You may also use Bash ${!var} indirect expansion, as already mentioned, however it doesn't support retrieving of array indices.


For further read or examples, check BashFAQ/006 about Indirection.

We are not aware of any trick that can duplicate that functionality in POSIX or Bourne shells without eval, which can be difficult to do securely. So, consider this a use at your own risk hack.

However, you should re-consider using indirection as per the following notes.

Normally, in bash scripting, you won't need indirect references at all. Generally, people look at this for a solution when they don't understand or know about Bash Arrays or haven't fully considered other Bash features such as functions.

Putting variable names or any other bash syntax inside parameters is frequently done incorrectly and in inappropriate situations to solve problems that have better solutions. It violates the separation between code and data, and as such puts you on a slippery slope toward bugs and security issues. Indirection can make your code less transparent and harder to follow.

1

While I think declare -n is still the best way to do it there is another way nobody mentioned it, very useful in CI/CD

function dynamic(){
  export a_$1="bla"
}

dynamic 2
echo $a_2

This function will not support spaces so dynamic "2 3" will return an error.

1
  • You can make this particular example safe with spaces by removing them: export a_${1//[^[:word:]]}="bla" with "2 3" will export a_23="bla". But since [:word:] includes numerals, which are illegal as the first symbol in a var identifier, you have to either include a legal prefix (as in your example), or be more aggressive in what you remove: export ${1//[^[:alpha:]_]}="bla" will strip everything except letters and underscores ("2 3" will export ="bla" – a syntax error :)).
    – ardnew
    Commented Dec 13, 2023 at 17:01
0

For indexed arrays, you can reference them like so:

foo=(a b c)
bar=(d e f)

for arr_var in 'foo' 'bar'; do
    declare -a 'arr=("${'"$arr_var"'[@]}")'
    # do something with $arr
    echo "\$$arr_var contains:"
    for char in "${arr[@]}"; do
        echo "$char"
    done
done

Associative arrays can be referenced similarly but need the -A switch on declare instead of -a.

0

POSIX compliant answer

For this solution you'll need to have r/w permissions to the /tmp folder.
We create a temporary file holding our variables and leverage the -a flag of the set built-in:

$ man set
...
-a Each variable or function that is created or modified is given the export attribute and marked for export to the environment of subsequent commands.

Therefore, if we create a file holding our dynamic variables, we can use set to bring them to life inside our script.

The implementation

#!/bin/sh
# Give the temp file a unique name so you don't mess with any other files in there
ENV_FILE="/tmp/$(date +%s)"

MY_KEY=foo
MY_VALUE=bar

echo "$MY_KEY=$MY_VALUE" >> "$ENV_FILE"

# Now that our env file is created and populated, we can use "set"
set -a; . "$ENV_FILE"; set +a
rm "$ENV_FILE"
echo "$foo"

# Output is "bar" (without quotes)

Explaining the steps above:

# Enables the -a behavior
set -a

# Sources the env file
. "$ENV_FILE"

# Disables the -a behavior
set +a
0

Careful: I just found this works very differently - doesn't work - in zsh. So make sure you're in the shell you mean to be in; or will be in for your script's eventual execution context.

1
  • 2
    This is tagged as bash so if you use one of the answers here which is not mentioned for zsh and use it on zsh then it's on you.
    – Jetchisel
    Commented May 17, 2023 at 20:23
-3

for varname=$prefix_suffix format, just use:

varname=${prefix}_suffix
0

Your Answer

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

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