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