table of contents
other sections
array(3tcl) | Tcl Built-In Commands | array(3tcl) |
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 手册页翻译计划》:¶
8.3 | Tcl |