Scroll to navigation

array(3tcl) Tcl Built-In Commands array(3tcl) 





NAME


array - 操纵数组变量






总览 SYNOPSIS


array option arrayName ?arg arg ...?










描述 DESCRIPTION




 这个命令在由 arrayName
    给出的变量上进行多种操作中的某一项。除了在后面为单独的命令(专门)指定之外，arrayName
    必须是一个现存的数组变量的名字。option
    选项决定命令完成何种动作。合法的选项(可以用缩写)有:



  

  
如果在一次数组查找中还有元素等待处理则返回
      1，如果所有元素都被返回过了则返回
      0。SearchId 指示在 arrayName
      上检查哪个查找，它必须是从以前的
      array startsearch
      调用返回的值。如果一个数组的某个元素有空名字时这个选项特别有用，因为从
      array nextelement
      返回的值不能指示出查找是否完成。

  

  
这个命令终止一个数组查找并销毁与这个查找有关的所有状态。SearchId
      指示在 arrayName
      上要要销毁哪个查找，必须时在以前调用
      array startsearch
      返回的值。返回一个空串。

  

  
如果 arrayName
      是一个数组变量返回
      1，如果没有叫这个名字的变量或是一个标量变量则返回
      0。

  

  
返回包含成对的元素的一个列表。每对的第一个元素是在
      arrayName
      中的元素名，每对的第二个元素是数组元素的值。没定义成对元素的次序。如果没指定
      pattern，则数组的所有元素被包括在结果中，如果指定了
      pattern，则结果中只包括那些名字匹配
      patternn 的元素(使用 string
      match
      的匹配规则)。如果
      arrayName
      不是一个数组变量的名字，或者数组不包含元素，则返回一个空列表。

  

  
返回在一个列表，它包含数组中匹配
      pattern
      的所有元素的名字(使用
      string match 匹配规则)。
      如果省略了 pattern
      则命令返回在数组中所有元素的名字。如果在数组中没有(匹配的)元素，或者
      arrayNamee
      不是一个数组变量的名字，则返回一个空串。

  

  
返回在 arrayName
      中下一个元素的名字，如果在这个查找中所有
      arrayName
      的元素都被已经被返回过了则返回空串。searchId
      参数标识一个查找，并且必须是
      array startsearch
      命令的返回值。 警告:
      如果从这个数组中添加或删除元素，那么自动的终止所有的查找，有如调用了
      array
      donesearch，这将导致对这些查找的
      array nextelement 操作失败。

  

  
设置在 arrayName
      中的一个或多个元素的值。list
      的形式必须与 array get
      返回的相同，由偶数个元素组成的。在
      list
      中每个奇数元素被作为在
      arrayName
      中被作为一个元素名对待，后面跟随的
      list
      中的元素被作为这个数组元素的新值使用。如果变量
      arrayName 不存在并且 list
      是空, 建立是空值的
      arrayName。

  

  
返回一个给出在一个数组中的元素个数的一个十进制数的字符串。如果
      arrayName
      不是一个数组的名字则返回
      0。

  

  
这个命令在用 arrayName
      给出的数组上初始化一个逐个元素的查找，调用
      array nextelement
      命令将返回在数组中单独元素的名字。在查找完成的时候，要调用
      array donesearch
      命令。返回值是一个在
      array nextelement 和 array donesearch
      命令中必须要用的查找标识符；对同一个数组允许多个查找同时进行。
    

    

  

  

  
在一个数组中删除匹配
      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







  

    8.3
    Tcl