declare

声明变量,设置或显示变量的值和属性。

语法

  1. declare [-aAfFgilnrtux] [-p] [name[=value] ...]

主要用途

  • 显示包含指定属性的全部变量和值
  • 显示包含指定属性的一到多个变量和值
  • 显示一到多个变量的属性和值
  • 显示所有变量的属性和值并显示函数的定义
  • 显示所有变量的属性和值
  • 显示所有全局变量的属性和值
  • 显示全部函数名和函数定义
  • 只显示全部函数名
  • 显示一到多个函数名和函数定义
  • 只显示一到多个函数名
  • 声明全局变量(可选:赋值)
  • 声明变量(可选:赋值、属性)
  • 增加、删除变量的属性(可选:赋值)

选项

  1. -f 将操作或显示限制为函数名及函数定义。
  2. -F 只显示函数名(调试时附加行号和源文件)。
  3. -g shell函数中使用时创建全局变量;其他情况下忽略。
  4. -p 显示每个名称的属性和值。
  5. *设置属性的选项:
  6. -a 创建数组(如果支持)。
  7. -A 创建关联数组(如果支持)。
  8. -i 增加整型属性。
  9. +i 删除整型属性。
  10. -l 增加小写属性,变量的值将转换为小写。
  11. +l 删除小写属性。
  12. -n 增加引用属性(如果该选项存在)。
  13. +n 删除引用属性(如果该选项存在)。
  14. -r 增加只读属性。
  15. -t 增加追踪属性。
  16. +t 删除追踪属性。
  17. -u 增加大写属性,变量的值将转换为大写。
  18. +u 删除大写属性。
  19. -x 增加导出属性。
  20. +x 删除导出属性。

参数

  1. name(可选):变量名或函数名。
  2. value(可选):变量的值。

返回值

declare 返回true除非你提供了非法选项或赋值错误。具体导致异常的情况请查看讨论章节的关于异常情况

例子

  1. # 声明变量,当然也欢迎您在这个网站(感谢本项目发起人 @jaywcjlove)查询linux命令。
  2. declare reference_website='https://wangchujiang.com/linux-command/'
  3. # 显示所有包含整型属性的变量和值。
  4. declare -i
  5. # 定义变量b并赋值为3,具有整型属性。
  6. declare -i b=5
  7. # 显示属性,返回 declare -i b="5"。
  8. declare -p b
  9. # 删除整型属性。
  10. declare +i b
  11. # 显示属性,返回 declare -- b="5"。
  12. declare -p b
  13. # 根据变量属性强制转换值的英文大小写。
  14. declare -u uc_var='abc'
  15. declare -l lc_var='ABC'
  16. # 显示'ABC abc';
  17. echo "${uc_var} ${lc_var}"
  1. # 定义函数内的全局变量
  2. function test(){
  3. declare -g a=3
  4. # 或者
  5. local -g b=3
  6. # 或者
  7. c=3
  8. # 让我们查看它们的属性。
  9. declare -p a b c
  10. }
  11. # 执行函数。
  12. test
  13. # 返回结果。
  14. # declare -- a="3"
  15. # declare -- b="3"
  16. # declare -- c="3"
  17. # 定义函数外的全局变量
  18. declare a=3
  19. b=3
  20. declare p a b
  21. # 返回结果如下。
  22. # declare -- a="3"
  23. # declare -- b="3"
  24. # 定义局部变量
  25. function test2(){
  26. local -i a=3
  27. declare -i b=3
  28. }
  29. test2
  30. # 没有该变量(已经被销毁了)
  31. echo "${a} ${b}"
  32. # 因此,我们日常脚本中最常见的类似于'a=3'实际上是声明并赋值了一个全局变量。
  33. # 在接下来的 **讨论** 环节会延伸讨论全局和局部变量问题。
  1. # 注意,不能使用 `+a` 或 `+A` 取消数组,也不能使用 `+r` 取消只读属性。
  2. # 定义只读数组,设置属性的同时定义赋值。
  3. declare -ar season=('Spring' 'Summer' 'Autumn' 'Winter')
  4. # 或者这样。
  5. season=('Spring' 'Summer' 'Autumn' 'Winter')
  6. declare -ar season
  7. # 显示所有数组。
  8. declare -a
  9. # 定义关联数组。
  10. declare -A fruits=(['apple']='red' ['banana']='yellow')
  11. # 显示所有关联数组。
  12. declare -A
  1. # 显示所有变量的属性和值并显示函数的定义,输出很长。
  2. declare
  3. # 显示所有变量的属性和值。
  4. declare -p
  5. # 显示所有全局变量的属性和值。
  6. declare -g
  1. # 显示全部函数名和函数定义。
  2. declare -f
  3. # 只显示全部函数名。
  4. declare -F
  5. # 定义两个函数。
  6. function func_a(){ echo $(date +"%F %T"); }
  7. function func_b(){ cd /; ls -lh --sort=time; }
  8. # 显示一到多个函数名和函数定义。
  9. declare -f func_a func_b
  10. # 只显示一到多个函数名,验证某个名称是否已经定义为函数时有用。
  11. declare -F func_a func_b
  12. # 最好不要让函数名和变量名相同。

讨论

  1. 全局和局部变量

    正如上面例子指出的情况,我们在日常编写程序的时候需要了解这些概念,在这里 做个简要地介绍,当然你也可以很方便的搜索到相关内容。

    • 全局变量:在整个脚本执行期间,只要没有被删除就一直存在
    • 局部变量:在函数内定义,函数执行后就被删除。

    建议函数内使用local命令,函数外使用declare命令。

    不要在脚本中定义过多的全局变量,那样可能会被其他函数调用造成意料之外的后果,并且也不方便检查出来。

    更不用说缺乏必要的注释了 —— ZhuangZhu-74

    相关资料:

  2. 关于declare typeset export local readonly命令

    为什么declare能做到的事,还需要定义其他这些命令呢?

    因为这样语句含义会更加明确,例如:

    • 设置导出属性的变量时,export vardeclare -x var
    • 在函数内声明变量时,使用local
    • 声明只读变量,使用readonly

    typesetdeclare命令一样。

  3. 关于异常情况

    有多种原因导致declare失败,关于这些情况可以参考bash在线文档declare部分(最新版),或执行 info bash 查看declare部分最后一大串an attempt is开头的句子。

注意

  1. 该命令是bash内建命令,相关的帮助信息请查看help命令。
  2. 导出属性的相关介绍请查看’export’命令。
  3. 只读属性的相关介绍请查看’readonly’命令。
  4. 引用属性的相关介绍请查看’unset’命令的例子部分。