shell 编程 帮助功能的实现

本文介绍了在Shell脚本中实现帮助文档的两种方法:一种是通过参数个数来触发帮助信息;另一种是遵循标准实践,使用-h参数来激活帮助说明。文章还详细解释了如何利用heredoc语法编写整洁、易读的帮助文档,并提供了具体的代码示例。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

一个程序,往往需要帮助说明.
激活帮助说明的方法介绍两种
1. 最简单的办法是通过参数个数判别.例如不带任何参数就显示帮助说明.
2. 正规做法是命令行后跟 -h 参数.
shell 帮助的写法可以用一堆echo 指令向控制台输出, 更好的做法是用
here doc 语法, 说明文档排版整齐,跟输出一致. 没有一堆echo 及 双引号等.
下面给出实例:

1. 简单方法
#!/bin/bash -
set -o nounset                              # Treat unset variables as an error
help()
{
    cat <<- EOF
    Desc: 该程序用来....
    Usage: ./1.sh <filename>
    Author: hjjdebug
    License: ...
EOF
    exit 0
}
if [ $# -lt 1 ] # 这里是数值比较,不能用 <, <是字符串比较,跟c语言有点差别.
then
    help
fi

2. 正规方法
#!/bin/bash -
#set -o nounset                              # 这个选项关闭吧,否则$1无定义它报语法错.影响视觉.
help()
{
    cat <<- EOF
    Desc: 该程序用来....
    Usage: ./1.sh <filename>
    Author: hjjdebug
    License: ...
EOF
    exit 0
}

#这里通过判断$1是否存在判别,也可以通过$#判别,shift会改变两者的值,
while [ -n "$1" ]; do
    case $1 in
        -h) help;; # function help is called
        --) shift;break;; # end of options
        -*) echo "error: no such option $1."; exit 1;;
        *) break;;
esac
done

here doc 另外的两点说明:

# here doc
function CreateZeroTxt
{
    cat <<-EOF > zero.txt
    0,0,0,270,
EOF
}

1. 用here doc 创建zero.txt 文件, 在cat后面加上>重定向即可.如上例生成zero.txt

2. 对于文档内容,如果你想忽略前导空白符,即字符靠左排列,加上-即可,如上例。

    注意: 实验发现,只是忽略tab 前导,空格是不忽略的.

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值