Manpages

______________________________________________________________________________

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