Provided by: manpages-zh_1.5.2-1_all bug

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 是空, 建立是空值的 arrayNamearray size arrayName
              返回一個給出在一個數組中的元素個數的一個十進制數的字符串。如果
              arrayName 不是一個數組的名字則返回 0。

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

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

關鍵字 KEYWORDS
       array, element names, search

[中文版維護人]
       寒蟬退士

[中文版最新更新]
       2001/06/22

《中國 Linux 論壇 man 手冊頁翻譯計劃》:
       http://cmpp.linuxforum.net