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