NAME

       array - 操縱數組變量

總覽 SYNOPSIS

       array option arrayName ?arg arg ...?
_________________________________________________________________

描述 DESCRIPTION

        這個命令在由 arrayName 給出的變量上進行多種操作中的某一項。除了在後面爲單獨的命令(專門)指
       定之外，arrayName 必須是一個現存的數組變量的名字。option  選項決定命令完成何種動作。合法的
       選項(可以用縮寫)有:

       array anymore arrayName searchId
              如果在一次數組查找中還有元素等待處理則返回        1，如果所有元素都被返回過了則返回
              0。SearchId 指示在 arrayName 上檢查哪個查找，它必須是從以前的 array startsearch  調
              用返回的值。如果一個數組的某個元素有空名字時這個選項特別有用，因爲從          array
              nextelement 返回的值不能指示出查找是否完成。

       array donesearch arrayName searchId
              這個命令終止一個數組查找並銷燬與這個查找有關的所有狀態。SearchId  指示在  arrayName
              上要要銷燬哪個查找，必須時在以前調用 array startsearch 返回的值。返回一個空串。

       array exists arrayName
              如果 arrayName 是一個數組變量返回 1，如果沒有叫這個名字的變量或是一個標量變量則返回
              0。

       array get arrayName ?pattern?
              返回包含成對的元素的一個列表。每對的第一個元素是在 arrayName 中的元素名，每對的第二
              個元素是數組元素的值。沒定義成對元素的次序。如果沒指定  pattern，則數組的所有元素被
              包括在結果中，如果指定了 pattern，則結果中只包括那些名字匹配  patternn  的元素(使用
              string  match  的匹配規則)。如果 arrayName 不是一個數組變量的名字，或者數組不包含元
              素，則返回一個空列表。

       array names arrayName ?pattern?
              返回在一個列表，它包含數組中匹配 pattern 的所有元素的名字(使用 string match  匹配規
              則)。  如果省略了  pattern  則命令返回在數組中所有元素的名字。如果在數組中沒有(匹配
              的)元素，或者 arrayNamee 不是一個數組變量的名字，則返回一個空串。

       array nextelement arrayName searchId
              返回在 arrayName 中下一個元素的名字，如果在這個查找中所有 arrayName  的元素都被已經
              被返回過了則返回空串。searchId  參數標識一個查找，並且必須是 array startsearch 命令
              的返回值。 警告: 如果從這個數組中添加或刪除元素，那麼自動的終止所有的查找，有如調用
              了 array donesearch，這將導致對這些查找的 array nextelement 操作失敗。

       array set arrayName list
              設置在 arrayName 中的一個或多個元素的值。list 的形式必須與 array get 返回的相同，由
              偶數個元素組成的。在  list  中每個奇數元素被作爲在  arrayName  中被作爲一個元素名對
              待，後面跟隨的 list 中的元素被作爲這個數組元素的新值使用。如果變量 arrayName 不存在
              並且 list 是空, 建立是空值的 arrayName。

       array size arrayName
              返回一個給出在一個數組中的元素個數的一個十進制數的字符串。如果 arrayName 不是一個數
              組的名字則返回 0。

       array startsearch arrayName
              這個命令在用 arrayName 給出的數組上初始化一個逐個元素的查找，調用 array nextelement
              命令將返回在數組中單獨元素的名字。在查找完成的時候，要調用  array   donesearch   命
              令。返回值是一個在  array  nextelement 和 array donesearch 命令中必須要用的查找標識
              符；對同一個數組允許多個查找同時進行。

       array unset arrayName ?pattern?                                                            │
              在一個數組中刪除匹配  pattern  的所有元素(使用   string   match   的匹配規則)。如果 │
              arrayName  不是一個數組變量的名字或在數組中沒有匹配的元素，則返回一個空數組。如果是 │
              一個數組變量的名字並且省略了 pattern ，則命令刪除整個數組。                         │

關鍵字 KEYWORDS

       array, element names, search

[中文版維護人]

       寒蟬退士

[中文版最新更新]

       2001/06/22

《中國 Linux 論壇 man 手冊頁翻譯計劃》:

       http://cmpp.linuxforum.net

跋

       本頁面中文版由中文 man 手冊頁計劃提供。
       中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh