# unset

删除指定的shell变量或函数。

## 概要

    unset [-f] [-v] [-n] [name ...]

## 主要用途

- 删除一到多个shell变量（不包括只读变量）。
- 删除一到多个shell函数。
- 删除一到多个具有引用属性的变量（如果-n选项存在）。

## 选项

    -f：仅删除函数。
    -v：仅删除变量（不包括只读变量）。
    -n：删除具有引用属性的变量名（如果该选项存在）。

## 参数

name（可选）：要删除的变量或函数。

## 返回值

返回成功除非选项错误或要删除的变量或函数有只读属性。

## 例子

    # 删除变量。
    declare paper_size='B5'
    unset -v paper_size

    # 删除函数。
    function show_result(){ echo 'Last Command Return: $?'; }
    unset -f show_result

    # 当不指定选项时，优先删除变量，如果失败则删除函数。
    declare -i aa=100
    function aa(){ echo 'aa'; }
    unset aa
    # 变量'aa'已被删除。
    declare -p aa
    # 函数'aa'存在。
    declare -F|grep aa

    # 演示unset使用-n选项，name指定了引用变量时的情况。
    declare a=3
    # 定义引用变量
    declare -n b=a
    # 查看属性，显示declare -n b="a"
    declare -p b
    # 显示3
    echo ${b}
    # 显示a
    echo ${!b}
    # 指定-n选项时
    unset -n b
    # 引用变量b已被删除
    declare -p b
    # 被引用的变量a未被删除
    declare -p a

    # 演示unset不使用-n选项，name指定了引用变量时的情况。
    declare a=3
    # 定义引用变量
    declare -n b=a
    # 查看属性，显示declare -n b="a"
    declare -p b
    # 显示3
    echo ${b}
    # 显示a
    echo ${!b}
    # 不指定-n选项时
    unset b
    # 引用变量b未被删除，显示declare -n b="a"
    declare -p b
    # 被引用的变量a被删除
    declare -p a

### 注意

1. 该命令是bash内建命令，相关的帮助信息请查看`help`命令。