Bash - (Argument|Positional Parameter)

> Procedural Languages > Bash Shell and (Unix|Linux) Utilities (XCU)

1 - About

An argument is a parameter given to a command or to the bash shell and referenced by position.

To parse positional parameters, you use Bash - getopts - Argument Parser (Builtin command)

A positional parameter is a parameter denoted:

  • by one or more digits,
  • other than the single digit 0.

Positional parameters are assigned from the shell’s arguments when it is invoked, and may be reassigned using the set builtin command. Positional parameters may not be assigned to with assignment statements. The positional parameters are temporarily replaced when a shell function is executed. When a positional parameter consisting of more than a single digit is expanded, it must be enclosed in braces.

Advertising

3 - Special Parameters

There is some special parameter that gives extra function around positional parameters.

3.1 - $0

The script name.

echo $0
/bin/bash

3.2 - Star (*) - Single Word

* 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.

$*: All of the positional parameters, seen as a single word “$*” must be quoted.

3.3 - $1, $2, etc.

Positional parameters, passed:

Advertising

3.4 - At (@)

@ expands to the positional parameters, starting from one.

  • When the expansion occurs within double quotes, each parameter expands to a separate word. That is, "[email protected]" 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,"[email protected]" and [email protected] expand to nothing (i.e., they are removed).

3.5 - Number of positional parameters (# Hashtag)

$#:

echo $#
0

4 - Management

4.1 - Shift method

4.2 - Test if set

Because an argument is a parameter, we can use the parameter expansion to test if it's set.

if [ -z ${1+x} ]; then echo "1 is unset"; else echo "1 is set to '$1'"; fi
# or
if !([ -z ${1+x} ]); then echo "1 is set to '$1'"; else echo "1 is unset "; fi
Advertising

5 - Documentation / Reference