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

NAME

       array - 操縱數組變量

` SYNOPSIS
       array option arrayName ?arg arg ...?
_________________________________________________________________

yz DESCRIPTION
        這茤R令在由   arrayName  給出的變量上進行多種操作中的某一項。除了在後-
       惇偃瞈W的命令(專門)指定之外,arrayName                        必須是一-
       茞{存的數組變量的名字。option
       選項決定命令完成何種動作。合法的選項(可以用縮寫)有:

       array anymore arrayName searchId
              如果在一次數組查找中還有元素等待處理則返回
              1,如果所有元素都被返回過了則返回  0。SearchId  指示在 arrayName
              上檢查茯d找,它必須是從以前的  array  startsearch   調用返回的-
              C如果一蚍晡漪Y茪葛嬰釭臟W字時這蚇龠粟S別有用,因為從   array
              nextelement 返回的ㄞ鄎示出查找是否完成。

       array donesearch arrayName searchId
              這茤R令終止一蚍晙d找並銷毀與這茯d找有關的所有狀態。SearchId
              指示在    arrayName    上nn銷毀茯d找,必須時在以前調用    array
              startsearch 返回的C返回一茠臟瞗C

       array exists arrayName
              如果      arrayName      是一蚍桲僆q返回      1,如果沒有叫這-
              茼W字的變量或是一蚍迠q變量則返回 0。

       array get arrayName ?pattern?
              返回包含成對的元素的一茼C表。每對的第一茪葛嶼O在       arrayName
              中的元素名,每對的第二茪葛嶼O數組元素的-
              C沒定義成對元素的次序。如果沒指定
              pattern,則數組的所有元素被包括在結果中,如果指定了
              pattern,則結果中只包括那些名字匹配  patternn 的元素(使用 string
              match        的匹配規則)。如果         arrayName         不是一-
              蚍桲僆q的名字,或者數組不包含元素,則返回一茠臟C表。

       array names arrayName ?pattern?
              返回在一茼C表,它包含數組中匹配   pattern  的所有元素的名字(使用
              string      match      匹配規則)。      如果省略了       pattern
              則命令返回在數組中所有元素的名字。如果在數組中沒有(匹配的)元素,或者
              arrayNamee 不是一蚍桲僆q的名字,則返回一茠臟瞗C

       array nextelement arrayName searchId
              返回在     arrayName      中下一茪葛尷漲W字,如果在這茯d找中所有
              arrayName           的元素都被已經被返回過了則返回空串。searchId
              參數標識一茯d找,並且必須是  array   startsearch   命令的返回C
              警告:                                                  如果從這-
              蚍掑仆K加或刪除元素,那麼自動的終止所有的查找,有如調用了
              array    donesearch,這將導P對這些查找的    array    nextelement
              操作失敗。

       array set arrayName list
              設置在 arrayName  中的一茤峖h茪葛尷瘓。list  的形式必須與  array
              get 返回的相同,由偶數茪葛徽捰赤滿C在 list 中每茤_數元素被作為在
              arrayName         中被作為一茪葛嬰W對待,後掘聸H的          list
              中的元素被作為這蚍掑葛尷熒s洏峞C如果變量           arrayName
              不存在並且 list 是空, 建立是空 arrayNamearray size arrayName
              返回一茧馴X在一蚍掑云漱葛歜數的一茪Q進制數的字符串。如果
              arrayName 不是一蚍晡漲W字則返回 0。

       array startsearch arrayName
              這茤R令在用  arrayName  給出的數組上初始化一茬v茪葛尷漪d找,調用
              array                                                nextelement
              命令將返回在數組中單獨元素的名字。在查找完成的時唌An調用   array
              donesearch  命令。返回O一茼b  array   nextelementarray
              donesearch          命令中必須n用的查找標識符;對同一蚍掑像多-
              茯d找同時進行。

       array unset arrayName                                                   |
       ?pattern?                                         |                     |
              在一蚍掑之R除匹配   pattern   的所有元素(使用   string   match |
              的匹配規則)。如果               arrayName                不是一- |
              蚍桲僆q的名字或在數組中沒有匹配的元素,則返回一-               |
              茠髒捸C如果是一蚍桲僆q的名字並且省略了               pattern |
              ,則命令刪除整蚍捸C                                            |

r KEYWORDS
       array, element names, search

[]
      Hhh

[]
       2001/06/22

m Linux manUpn:
       http://cmpp.linuxforum.net