位置参数

    shell 提供了一个称为位置参数的变量集合,这个集合包含了命令行中所有独立的单词。这些变量按照从0到9给予命名。可以以这种方式讲明白:

    一个非常简单的脚本,显示从 $0 到 $9 所有变量的值。当不带命令行参数执行该脚本时,输出结果如下:

    1. $0 = /home/me/bin/posit-param
    2. $1 =
    3. $2 =
    4. $3 =
    5. $4 =
    6. $5 =
    7. $6 =
    8. $7 =
    9. $8 =
    10. $9 =

    即使不带命令行参数,位置参数 $0 总会包含命令行中出现的第一个单词,也就是已执行程序的路径名。当带参数执行脚本时,我们看看输出结果:

    1. [me@linuxbox ~]$ posit-param a b c d
    2. $0 = /home/me/bin/posit-param
    3. $1 = a
    4. $2 = b
    5. $3 = c
    6. $4 = d
    7. $5 =
    8. $6 =
    9. $7 =
    10. $8 =
    11. $9 =

    注意: 实际上通过参数展开方式你可以访问的参数个数多于9个。只要指定一个大于9的数字,用花括号把该数字括起来就可以。例如 ${10}、 ${55}、 ${211}等等。

    33.1.1 确定参数个数

    另外 shell 还提供了一个名为 $#,可以得到命令行参数个数的变量:

    1. #!/bin/bash
    2. # posit-param: script to view command line parameters
    3. echo "
    4. Number of arguments: $#
    5. \$0 = $0
    6. \$1 = $1
    7. \$2 = $2
    8. \$3 = $3
    9. \$4 = $4
    10. \$5 = $5
    11. \$6 = $6
    12. \$7 = $7
    13. \$8 = $8
    14. \$9 = $9
    15. "

    结果是:

    1. [me@linuxbox ~]$ posit-param a b c d
    2. Number of arguments: 4
    3. $0 = /home/me/bin/posit-param
    4. $1 = a
    5. $2 = b
    6. $3 = c
    7. $4 = d
    8. $5 =
    9. $6 =
    10. $7 =
    11. $8 =
    12. $9 =

    33.1.2 shift - 访问多个参数的利器

    但是如果我们给一个程序添加大量的命令行参数,会怎么样呢? 正如下面的例子:

    在这个例子运行的环境下,通配符 * 展开成82个参数。我们如何处理那么多的参数?为此,shell 提供了一种方法,尽管笨拙,但可以解决这个问题。执行一次 shift 命令,就会导致所有的位置参数 “向下移动一个位置”。事实上,用 shift 命令也可以处理只有一个参数的情况(除了其值永远不会改变的变量 $0):

    1. #!/bin/bash
    2. # posit-param2: script to display all arguments
    3. count=1
    4. while [[ $# -gt 0 ]]; do
    5. echo "Argument $count = $1"
    6. count=$((count + 1))
    7. shift
    8. done

    每次 shift 命令执行的时候,变量 $2 的值会移动到变量 $1 中,变量 $3 的值会移动到变量 $2 中,依次类推。变量 $# 的值也会相应的减1。

    在该 posit-param2 程序中,我们编写了一个计算剩余参数数量,只要参数个数不为零就会继续执行的 while 循环。我们显示当前的位置参数,每次循环迭代变量 count 的值都会加1,用来计数处理的参数数量,最后,执行 shift 命令加载 $1,其值为下一个位置参数的值。这里是程序运行后的输出结果:

    1. [me@linuxbox ~]$ posit-param2 a b c d
    2. Argument 1 = a
    3. Argument 2 = b
    4. Argument 3 = c
    5. Argument 4 = d

    33.1.3 简单应用程序

    即使没有 shift 命令,也可以用位置参数编写一个有用的应用。举例说明,这里是一个简单的输出文件信息的程序:

    1. #!/bin/bash
    2. # file_info: simple file information program
    3. PROGNAME=$(basename $0)
    4. if [[ -e $1 ]]; then
    5. echo -e "\nFile Type:"
    6. file $1
    7. echo -e "\nFile Status:"
    8. stat $1
    9. else
    10. echo "$PROGNAME: usage: $PROGNAME file" >&2
    11. exit 1
    12. fi

    这个程序显示一个具体文件的文件类型(由 file 命令确定)和文件状态(来自 stat 命令)。该程序一个有意思的特点是 PROGNAME 变量。它的值就是 basename $0 命令的执行结果。这个 basename 命令清除一个路径名的开头部分,只留下一个文件的基本名称。在我们的程序中,basename 命令清除了包含在 $0 位置参数中的路径名的开头部分,$0 中包含着我们示例程序的完整路径名。当构建提示信息正如程序结尾的使用信息的时候,basename $0 的执行结果就很有用处。按照这种方式编码,可以重命名该脚本,且程序信息会自动调整为包含相应的程序名称。

    33.1.4 Shell 函数中使用位置参数

    正如位置参数被用来给 shell 脚本传递参数一样,它们也能够被用来给 shell 函数传递参数。为了说明这一点,我们将把 file_info 脚本转变成一个 shell 函数:

    1. file_info () {
    2. # file_info: function to display file information
    3. if [[ -e $1 ]]; then
    4. echo -e "\nFile Type:"
    5. file $1
    6. echo -e "\nFile Status:"
    7. stat $1
    8. else
    9. return 1
    10. fi
    11. }

    通过此功能,我们可以写出许多有用的 shell 函数,这些函数不仅能在脚本中使用,也可以用在 .bashrc 文件中。

    注意那个 PROGNAME 变量已经改成 shell 变量 FUNCNAME 了。shell 会自动更新 FUNCNAME 变量,以便跟踪当前执行的 shell 函数。注意位置参数 $0 总是包含命令行中第一项的完整路径名(例如,该程序的名字),但不会包含这个我们可能期望的 shell 函数的名字。

    有时候把所有的位置参数作为一个集体来管理是很有用的。例如,我们可能想为另一个程序编写一个 “包裹程序”。这意味着我们会创建一个脚本或 shell 函数,来简化另一个程序的执行。包裹程序提供了一个神秘的命令行选项列表,然后把这个参数列表传递给下一级的程序。

    为此 shell 提供了两种特殊的参数。他们二者都能扩展成完整的位置参数列表,但以相当微妙的方式略有不同。它们是:

    下面这个脚本用程序中展示了这些特殊参数:

    在这个相当复杂的程序中,我们创建了两个参数: “word” 和 “words with spaces”,然后把它们传递给 pass_params 函数。这个函数,依次,再把两个参数传递给 print_params 函数,使用了特殊参数 $* 和 $@ 提供的四种可用方法。脚本运行后,揭示了这两个特殊参数存在的差异:

    1. $* :
    2. $1 = word
    3. $2 = words
    4. $3 = with
    5. $4 = spaces
    6. "$*" :
    7. $1 = word words with spaces
    8. $2 =
    9. $3 =
    10. $4 =
    11. $@ :
    12. $1 = word
    13. $2 = words
    14. $3 = with
    15. $4 = spaces
    16. "$@" :
    17. $1 = word
    18. $2 = words with spaces
    19. $3 =
    20. $4 =

    通过我们的参数,$* 和 $@ 两个都产生了一个有四个词的结果:

    1. word words with spaces
    2. "$*" produces a one word result:
    3. "word words with spaces"
    4. "$@" produces a two word result:
    5. "word" "words with spaces"

    这个结果符合我们实际的期望。我们从中得到的教训是尽管 shell 提供了四种不同的得到位置参数列表的方法,但到目前为止, “$@” 在大多数情况下是最有用的方法,因为它保留了每一个位置参数的完整性。

    经过长时间的间断,我们将恢复程序 sys_info_page 的工作。我们下一步要给程序添加如下几个命令行选项:

    • 输出文件。 我们将添加一个选项,以便指定一个文件名,来包含程序的输出结果。选项格式要么是 -f file,要么是 --file file

    • 交互模式。这个选项将提示用户输入一个输出文件名,然后判断指定的文件是否已经存在了。如果文件存在,在覆盖这个存在的文件之前会提示用户。这个选项可以通过 -i 或者 --interactive 来指定。

    • 帮助。指定 -h 选项 或者是 --help 选项,可导致程序输出提示性的使用信息。

    这里是处理命令行选项所需的代码:

    1. usage () {
    2. echo "$PROGNAME: usage: $PROGNAME [-f file | -i]"
    3. return
    4. }
    5. # process command line options
    6. interactive=
    7. filename=
    8. while [[ -n $1 ]]; do
    9. case $1 in
    10. -f | --file) shift
    11. filename=$1
    12. ;;
    13. -i | --interactive) interactive=1
    14. ;;
    15. -h | --help) usage
    16. exit
    17. ;;
    18. *) usage >&2
    19. exit 1
    20. ;;
    21. esac
    22. shift
    23. done

    下一步,我们开始处理循环。当位置参数 $1 不为空的时候,这个循环会持续运行。在循环的底部,有一个 shift 命令,用来提升位置参数,以便确保该循环最终会终止。在循环体内,我们使用了一个 case 语句来检查当前位置参数的值,看看它是否匹配某个支持的选项。若找到了匹配项,就会执行与之对应的代码。若没有,就会打印出程序使用信息,该脚本终止且执行错误。

    处理 -f 参数的方式很有意思。当监测到 -f 参数的时候,会执行一次 shift 命令,从而提升位置参数 $1 为伴随着 -f 选项的 filename 参数。

    我们下一步添加代码来实现交互模式:

    1. # interactive mode
    2. if [[ -n $interactive ]]; then
    3. while true; do
    4. read -p "Enter name of output file: " filename
    5. if [[ -e $filename ]]; then
    6. read -p "'$filename' exists. Overwrite? [y/n/q] > "
    7. case $REPLY in
    8. Y|y) break
    9. ;;
    10. Q|q) echo "Program terminated."
    11. exit
    12. ;;
    13. *) continue
    14. ;;
    15. esac
    16. elif [[ -z $filename ]]; then
    17. continue
    18. else
    19. break
    20. fi
    21. done
    22. fi

    若 interactive 变量不为空,就会启动一个无休止的循环,该循环包含文件名提示和随后存在的文件处理代码。如果所需要的输出文件已经存在,则提示用户覆盖,选择另一个文件名,或者退出程序。如果用户选择覆盖一个已经存在的文件,则会执行 break 命令终止循环。注意 case 语句是怎样只检测用户选择了覆盖还是退出选项。其它任何选择都会导致循环继续并提示用户再次选择。

    为了实现这个输出文件名的功能,首先我们必须把现有的这个写页面(page-writing)的代码转变成一个 shell 函数,一会儿就会明白这样做的原因:

    解决 -f 选项逻辑的代码出现在以上程序片段的末尾。在这段代码中,我们测试一个文件名是否存在,若文件名存在,则执行另一个测试看看该文件是不是可写文件。为此,会运行 touch 命令,紧随其后执行一个测试,来决定 touch 命令创建的文件是否是个普通文件。这两个测试考虑到了输入是无效路径名(touch 命令执行失败),和一个普通文件已经存在的情况。

    正如我们所看到的,程序调用 write_html_page 函数来生成实际的网页。函数输出要么直接定向到标准输出(若 filename 变量为空的话)要么重定向到具体的文件中。

    伴随着位置参数的加入,现在我们能编写相当具有功能性的脚本。例如,重复性的任务,位置参数使得我们可以编写非常有用的,可以放置在一个用户的 .bashrc 文件中的 shell 函数。

    我们的 sys_info_page 程序日渐精进。这里是一个完整的程序清单,最新的更改用高亮显示:

    1. #!/bin/bash
    2. # sys_info_page: program to output a system information page
    3. PROGNAME=$(basename $0)
    4. TITLE="System Information Report For $HOSTNAME"
    5. CURRENT_TIME=$(date +"%x %r %Z")
    6. TIMESTAMP="Generated $CURRENT_TIME, by $USER"
    7. report_uptime () {
    8. cat <<- _EOF_
    9. <H2>System Uptime</H2>
    10. <PRE>$(uptime)</PRE>
    11. _EOF_
    12. return
    13. }
    14. report_disk_space () {
    15. <PRE>$(df -h)</PRE>
    16. _EOF_
    17. return
    18. }
    19. report_home_space () {
    20. if [[ $(id -u) -eq 0 ]]; then
    21. cat <<- _EOF_
    22. <H2>Home Space Utilization (All Users)</H2>
    23. <PRE>$(du -sh /home/*)</PRE>
    24. _EOF_
    25. else
    26. cat <<- _EOF_
    27. <H2>Home Space Utilization ($USER)</H2>
    28. <PRE>$(du -sh $HOME)</PRE>
    29. _EOF_
    30. fi
    31. return
    32. }
    33. usage () {
    34. echo "$PROGNAME: usage: $PROGNAME [-f file | -i]"
    35. return
    36. }
    37. write_html_page () {
    38. cat <<- _EOF_
    39. <HTML>
    40. <HEAD>
    41. <TITLE>$TITLE</TITLE>
    42. </HEAD>
    43. <BODY>
    44. <H1>$TITLE</H1>
    45. <P>$TIMESTAMP</P>
    46. $(report_uptime)
    47. $(report_disk_space)
    48. $(report_home_space)
    49. </BODY>
    50. </HTML>
    51. _EOF_
    52. return
    53. }
    54. # process command line options
    55. interactive=
    56. filename=
    57. while [[ -n $1 ]]; do
    58. case $1 in
    59. -f | --file) shift
    60. filename=$1
    61. ;;
    62. -i | --interactive) interactive=1
    63. ;;
    64. -h | --help) usage
    65. exit
    66. ;;
    67. *) usage >&2
    68. exit 1
    69. ;;
    70. esac
    71. shift
    72. done
    73. # interactive mode
    74. if [[ -n $interactive ]]; then
    75. while true; do
    76. read -p "Enter name of output file: " filename
    77. if [[ -e $filename ]]; then
    78. read -p "'$filename' exists. Overwrite? [y/n/q] > "
    79. case $REPLY in
    80. Y|y) break
    81. ;;
    82. Q|q) echo "Program terminated."
    83. exit
    84. ;;
    85. *) continue
    86. ;;
    87. esac
    88. fi
    89. done
    90. fi
    91. # output html page
    92. if [[ -n $filename ]]; then
    93. if touch $filename && [[ -f $filename ]]; then
    94. write_html_page > $filename
    95. else
    96. echo "$PROGNAME: Cannot write file '$filename'" >&2
    97. exit 1
    98. fi
    99. else
    100. fi

    我们还没有完成。仍然还有许多事情我们可以做,可以改进。

    • 除了本章讨论的技术之外,bash 还包含一个叫做 getopts 的内部命令,此命令也可以用来处理命令行参数。bash 参考页面的 SHELL BUILTIN COMMANDS 一节介绍了这个命令,Bash Hackers Wiki 上也有对它的描述: