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 手冊頁翻譯計劃》:
跋
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃:https://github.com/man-pages-zh/manpages-zh
8.3 | Tcl |