543

I know that shell scripts just run commands as if they were executed in at the command prompt. I'd like to be able to run shell scripts as if they were functions... That is, taking an input value or string into the script. How do I approach doing this?

Paul
  • 9,423

8 Answers8

395

The shell command and any arguments to that command appear as numbered shell variables: $0 has the string value of the command itself, something like script, ./script, /home/user/bin/script or whatever. Any arguments appear as "$1", "$2", "$3" and so on. The count of arguments is in the shell variable "$#".

Common ways of dealing with this involve shell commands getopts and shift. getopts is a lot like the C getopt() library function. shift moves the value of $2 to $1, $3 to $2, and so on; $# gets decremented. Code ends up looking at the value of "$1", doing things using a caseesac to decide on an action, and then doing a shift to move $1 to the next argument. It only ever has to examine $1, and maybe $#.

  • 10
    the C getopt() is an extremely established standard, but the getopt executable is not the same across distro/platform. I'm a now fully converted getopts user, as it is a POSIX standard. It works great with dash also, which is my preferred script shell – J. M. Becker Feb 10 '12 at 23:40
  • 5
    Note also that $@ holds all arguments, as explained in this answer. – not2savvy Jul 01 '22 at 10:24
354

You can access passed arguments with $n where n is the argument number - 1, 2, 3, .... You pass the arguments just like you would with any other command.

$ cat myscript
#!/bin/bash
echo "First arg: $1"
echo "Second arg: $2"
$ ./myscript hello world
First arg: hello
Second arg: world
Kevin
  • 40,767
145

On a bash script, I personally like to use the following script to set parameters:

#!/bin/bash

helpFunction()
{
   echo ""
   echo "Usage: $0 -a parameterA -b parameterB -c parameterC"
   echo -e "\t-a Description of what is parameterA"
   echo -e "\t-b Description of what is parameterB"
   echo -e "\t-c Description of what is parameterC"
   exit 1 # Exit script after printing help
}

while getopts "a:b:c:" opt
do
   case "$opt" in
      a ) parameterA="$OPTARG" ;;
      b ) parameterB="$OPTARG" ;;
      c ) parameterC="$OPTARG" ;;
      ? ) helpFunction ;; # Print helpFunction in case parameter is non-existent
   esac
done

# Print helpFunction in case parameters are empty
if [ -z "$parameterA" ] || [ -z "$parameterB" ] || [ -z "$parameterC" ]
then
   echo "Some or all of the parameters are empty";
   helpFunction
fi

# Begin script in case all parameters are correct
echo "$parameterA"
echo "$parameterB"
echo "$parameterC"

With this structure, we don't rely on the order of the parameters, as we're defining a key letter to each one of them. Also, the help function will be printed all the times that the parameters are defined wrongly. It's very useful when we have a lot of scripts with different parameters to handle. It works as the following:

$ bash myscript -a "String A" -b "String B" -c "String C"
String A
String B
String C

$ bash myscript -a "String A" -c "String C" -b "String B"
String A
String B
String C

$ bash myscript -a "String A" -c "String C" -f "Non-existent parameter"
myscript: illegal option -- f

Usage: myscript -a parameterA -b parameterB -c parameterC
    -a Description of what is parameterA
    -b Description of what is parameterB
    -c Description of what is parameterC

$ bash myscript -a "String A" -c "String C"
Some or all of the parameters are empty

Usage: myscript -a parameterA -b parameterB -c parameterC
    -a Description of what is parameterA
    -b Description of what is parameterB
    -c Description of what is parameterC
  • Does this work on centos? – Sai Nikhil Mar 25 '20 at 09:43
  • @saint1729 Sure, it works on any operating system (even on Windows) that you have with bash installed, you just need to execute it. – Rafael Muynarsk Mar 26 '20 at 15:22
  • 12
    Cool. It worked for me. But, the key needs to be only one character. I wasted almost an hour figuring this out. – Sai Nikhil Mar 26 '20 at 15:40
  • Great example, wasn't clear to me what the single characters referred to at first. Another example for those stuck: while getopts "f:b:k:a:s:" opt do case "$opt" in f ) parameterFilepath="$OPTARG" ;; b ) parameterBucket="$OPTARG" ;; k ) parameterKey="$OPTARG" ;; a ) parameterAccessKey="$OPTARG" ;; s ) parameterSecretKey="$OPTARG" ;; ? ) helpFunction ;; # Print helpFunction in case parameter is non-existent

    esac done

    – chris Jun 10 '21 at 10:00
43

The form

$ ./script.sh "$@" 

is the most convenient for argv. The arg delimiter is whitespace, but can be changed. Don't remember how off-hand. Then use

 $1, $2, shift, if [ $# -ne 3 ] 

to control flow. I don't usually embrace getopts if a case ... esac will suffice.

user400344
  • 581
  • 4
  • 5
39
$/shellscriptname.sh argument1 argument2 argument3 

You can also pass output of one shell script as an argument to another shell script.

$/shellscriptname.sh "$(secondshellscriptname.sh)"

Within shell script you can access arguments with numbers like $1 for first argument and $2 for second argument and so on so forth.

More on shell arguments

26
./myscript myargument

myargument becomes $1 inside myscript.

Kevin
  • 40,767
vimdude
  • 435
11

In the shell script ; it becomes the variable name $1 . The second word becomes the variable name $2 and so on .

cat << 'EOF' > test
echo "First arg: $1"
echo "Second arg: $2"
echo "List of all arg: $@"
EOF
sh test hello world

More maybe found in the shell (sh) manual at http://heirloom.sourceforge.net/sh/sh.1.html

abc
  • 208
4

The following is mine:

#!/bin/bash 
echo 'First arg:' $1 
echo 'Second arg:' $2 

The shell name is para_script.sh

Then execute it: ./para_script.sh hello world

Newt
  • 419