readonly

標記shell變量或函數為只讀

語法

readonly [-aAf] [name[=value] ...]
readonly -p

主要用途

定義一到多個變量并設置只讀屬性。
為已定義的一到多個變量設置只讀屬性。
顯示全部包含只讀屬性的變量。
為已定義的一到多個函數設置只讀屬性。
顯示全部包含只讀屬性的函數。

選項

-a：指向數組。
-A：指向關聯數組。
-f：指向函數。
-p：顯示全部只讀變量。
--：在它之后的選項無效。

參數

name（可選）：變量名或函數名
value（可選）：變量的值

返回值

readonly返回true除非你提供了非法選項或非法名稱。

例子

# 定義變量并增加只讀屬性
readonly var1=13 var2
readonly -a arr1=(1 2 3 4 5) arr2=('z' 'x' 'c')
# 必須有 '-A' 選項
readonly -A dict1=(['key1']='value1')

# 先定義變量、函數，然后再為它們添加只讀屬性
max=3
readonly max

# 數組定義時可以不加 `declare -a`
seasons=('spring' 'summer' 'autumn' 'winter')
# 為數組添加只讀屬性時可以不加 `-a` 選項
readonly seasons

declare -A man=(['age']=23 ['height']='190cm')
# 為關聯數組添加只讀屬性時可以不加 `-A` 選項
readonly man

function foo(){ echo 'bar'; }
# 為函數添加只讀屬性時必須加 `-f` 選項
readonly -f foo

# 顯示全部只讀變量，以下兩個命令的顯示結果一樣
readonly
readonly -p
# 顯示全部擁有只讀屬性的數組
readonly -a
# 顯示全部擁有只讀屬性的關聯數組
readonly -A
# 顯示全部擁有只讀屬性的函數
readonly -f

常見錯誤

對于只讀變量而言，若用戶對其值進行修改，則會立即報錯。例如，使用該指令定義一個只讀變量"test"，并且將其值初始化為"ok"，輸入如下命令：

[root@localhost ~]# readonly test='ok'        #定義只讀變量并初始化

那么當用戶直接修改該只讀變量時就會報錯，如下所示：

[root@localhost ~]# test='my'                 #試圖修改只讀變量的值
-bash: test: readonly variable

當用戶試圖修改只讀變量的值時，會被提示該變量為只讀變量。

注意

該命令是bash內建命令，相關的幫助信息請查看help命令。
declare +r不能去除只讀屬性， unset不能刪除只讀變量。