439

In many SO questions and bash tutorials I see that I can access command line args in bash scripts in two ways:

$ ~ >cat testargs.sh 
#!/bin/bash

echo "you passed me" $*
echo "you passed me" $@

Which results in:

$ ~> bash testargs.sh arg1 arg2
you passed me arg1 arg2
you passed me arg1 arg2

What is the difference between $* and $@?
When should one use the former and when shall one use the latter?

2

5 Answers 5

542

The difference appears when the special parameters are quoted. Let me illustrate the differences:

$ set -- "arg  1" "arg  2" "arg  3"

$ for word in $*; do echo "$word"; done
arg
1
arg
2
arg
3

$ for word in $@; do echo "$word"; done
arg
1
arg
2
arg
3

$ for word in "$*"; do echo "$word"; done
arg  1 arg  2 arg  3

$ for word in "$@"; do echo "$word"; done
arg  1
arg  2
arg  3

one further example on the importance of quoting: note there are 2 spaces between "arg" and the number, but if I fail to quote $word:

$ for word in "$@"; do echo $word; done
arg 1
arg 2
arg 3

and in bash, "$@" is the "default" list to iterate over:

$ for word; do echo "$word"; done
arg  1
arg  2
arg  3
8
  • 7
    Is there a possible use case, when $* or "$*"may be required, & the purpose cannot be served by $@ or "$@"?
    – anishsane
    Aug 3, 2013 at 11:17
  • 9
    Which version is more suitable for a "wrapper" script, where the scripts parameters need to become parameters to a new command?
    – Segfault
    Mar 30, 2015 at 15:53
  • 14
    @Segfault, in this case, always choose "$@" with the quotes. Mar 30, 2015 at 16:09
  • 5
    This answer contains useful examples but in would be better if it also explained the mechanism behind them. Why does it work like this?
    – Lii
    Jul 28, 2016 at 17:45
  • 2
    bash is a strange language. In many ways I think it is constrained by compatibility with the 40+ year old Bourne shell Jan 20, 2021 at 15:15
358

A nice handy overview table from the Bash Hackers Wiki:

Syntax Effective result
$* $1 $2 $3 … ${N}
$@ $1 $2 $3 … ${N}
"$*" "$1c$2c$3c…c${N}"
"$@" "$1" "$2" "$3" … "${N}"

where c in the third row is the first character of $IFS, the Input Field Separator, a shell variable.

If the arguments are to be stored, load them in an array variable.

4
  • 1
    Here is an example, which includes quoted input. The input also matters! Oct 17, 2017 at 20:57
  • 2
    Let's say I want to create a wrapper script that does nothing but mimic the functionality of the wrapped command. Which syntax should I use to pass the args from the wrapper script to inner command?
    – Marinos An
    Apr 8, 2020 at 6:21
  • 4
    @MarinosAn use "$@" (with quotes). None of the other variants work Jul 8, 2021 at 7:04
  • 1
    Thanks very much for such a clear explanation—for an obtuse explanation, see gnu.org/software/bash/manual/html_node/Special-Parameters.html Bash documentation.
    – mbigras
    Nov 20, 2022 at 2:32
53

$*

Expands to the positional parameters, starting from one. When the expansion occurs within double quotes, it expands to a single word with the value of each parameter separated by the first character of the IFS special variable. That is, "$*" is equivalent to "$1c$2c...", where c is the first character of the value of the IFS variable. If IFS is unset, the parameters are separated by spaces. If IFS is null, the parameters are joined without intervening separators.

$@

Expands to the positional parameters, starting from one. When the expansion occurs within double quotes, each parameter expands to a separate word. That is, "$@" is equivalent to "$1" "$2" ... If the double-quoted expansion occurs within a word, the expansion of the first parameter is joined with the beginning part of the original word, and the expansion of the last parameter is joined with the last part of the original word. When there are no positional parameters, "$@" and $@ expand to nothing (i.e., they are removed).

Source: Bash man

24

$@ is same as $*, but each parameter is a quoted string, that is, the parameters are passed on intact, without interpretation or expansion. This means, among other things, that each parameter in the argument list is seen as a separate word.

Of course, "$@" should be quoted.

http://tldp.org/LDP/abs/html/internalvariables.html#ARGLIST

0
3

This example let may highlight the differ between "at" and "asterix" while we using them. I declared two arrays "fruits" and "vegetables"

fruits=(apple pear plumm peach melon)            
vegetables=(carrot tomato cucumber potatoe onion)

printf "Fruits:\t%s\n" "${fruits[*]}"            
printf "Fruits:\t%s\n" "${fruits[@]}"            
echo + --------------------------------------------- +      
printf "Vegetables:\t%s\n" "${vegetables[*]}"    
printf "Vegetables:\t%s\n" "${vegetables[@]}"    

See the following result the code above:

Fruits: apple pear plumm peach melon
Fruits: apple
Fruits: pear
Fruits: plumm
Fruits: peach
Fruits: melon
+ --------------------------------------------- +
Vegetables: carrot tomato cucumber potatoe onion
Vegetables: carrot
Vegetables: tomato
Vegetables: cucumber
Vegetables: potatoe
Vegetables: onion
4
  • 12
    Scientifically speaking, tomatoes are fruits.
    – Randy
    Mar 18, 2019 at 19:17
  • 1
    You have right! "In botany, a fruit is the seed-bearing structure in flowering plants (also known as angiosperms) formed from the ovary after flowering." en.wikipedia.org/wiki/Fruit
    – stefansson
    Mar 26, 2019 at 21:01
  • @Randy: scientifically speaking, all fruits are vegetables (it's a synonym for "plant"). Jan 6, 2020 at 21:21
  • @CrisLuengo heresy! :)
    – Randy
    Jan 7, 2020 at 5:39

Your Answer

Reminder: Answers generated by Artificial Intelligence tools are not allowed on Stack Overflow. Learn more

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.