Manpages

______________________________________________________________________________

NAME

string - 操 縱 字 符 串

總 覽 SYNOPSIS

string option arg ?arg ...? _________________________________________________________________

描 述 DESCRIPTION

依 賴 於 option (選 項 )進 行 某 種 字 符 串 操 作 。 合 法 的 option (可 以 是 縮 寫 )有 : │

string bytelength string │ 返 回 一 個 十 進 制 字 符 串 ， 給 出 在 內 存 中 表 示 string 用 的 字 節 數 。 因 爲 │ UTF-8 使 用 一 到 三 字 節 來 表 示 Unicode 字 符 ， 字 節 長 度 可 能 與 通 常 的 字 │ 符 長 度 不 同 。 一 個 腳 本 關 心 字 節 長 度 的 情 況 較 少 見 。 多 數 情 況 下 ， 你 應 該 │ 使 用 string length 操 作 。 關 於 UTF-8 表 示 的 詳 情 請 參 考 │ Tcl_NumUtfChars 手 冊 頁 。 │
string compare ?-nocase? ?-length int? string1 string2 │ 對 字 符 串 string1 和 string2 進 行 逐 個 字 符 的 比 較 。 依 賴 於 string1 在 詞 典 順 序 上 (lexicographically)小 於 、 等 於 、 大 於 string2， 返 回 -1、 0、 或 1。 如 果 指 定 了 -length ， 則 在 比 較 中 │ 只 使 用 前 length 個 字 符 。 如 果 -length 是 負 數 ， 則 被 忽 略 。 如 果 │ 指 定 了 -nocase ， 則 使 用 大 小 寫 不 敏 感 方 式 比 較 字 符 串 。 │
string equal ?-nocase? ?-length int? string1 string2 │ 對 字 符 串 string1 和 string2 進 行 逐 個 字 符 的 比 較 。 如 果 string1 │ 和 string2 等 同 則 返 回 1， 否 則 返 回 0。 如 果 指 定 了 -length ， 則 │ 在 比 較 中 只 使 用 前 length 個 字 符 。 如 果 -length 是 負 數 ， 則 被 忽 │ 略 。 如 果 指 定 了 -nocase ， 則 使 用 大 小 寫 不 敏 感 方 式 比 較 字 符 串 。 │
string first string1 string2 ?startIndex? │ 在 string2 中 查 找 精 確 的 匹 配 string1 中 的 字 符 的 一 個 字 符 序 列 。 如 果 找 到 ， 返 回 string2 中 的 第 一 個 這 樣 的 匹 配 的 第 一 個 字 符 的 索 引 。 如 果 未 找 到 ， 返 回 -1。 如 果 指 定 了 startIndex (以 可 被 │ index 方 法 接 受 的 任 何 形 式 )， 則 約 束 查 找 爲 在 string2 中 從 用 │ 索 引 指 定 的 字 符 開 始 。 例 如 ， │

string first a 0a23456789abcdef 5 │ 將 返 回10, but │
string first a 0123456789abcdef 11 │ 將 返 回-1. │

string index string charIndex 返 回 string 參 數 的 第 charIndex 個 字 符 。 charIndex 中 0 對 應 着 字 符 串 的 第 一 個 字 符 。 │

charIndex 可 以 被 指 定 如 下 : │
integer │ 用 整 數 索 引 指 定 字 符 。 │
end │ 字 符 串 的 最 後 一 個 字 符 。 │
end-integer │ 字 符 串 最 後 一 個 字 符 減 去 指 定 整 數 偏 移 量 (例 如 ， end-1 將 參 │ 照 “abcd”中 的 “c”)。 │ 如 果 charIndex 小 於 0 或 大 於 等 於 字 符 串 的 長 度 則 返 回 一 個 空 串 。 │

string is class ?-strict? ?-failindex varname? string │ 如 果 string 是 指 定 字 符 類 的 一 個 有 效 成 員 則 返 回 1， 否 則 返 回 │ 0。 如 果 指 定 了 -strict， 則 對 一 個 空 串 返 回 0， 否 則 在 任 何 類 上 對 一 個 │ 空 串 返 回 1。 如 果 指 定 了 -failindex， 則 若 函 數 返 回 0， 把 字 符 串 │ 中 類 不 再 有 效 的 地 方 的 索 引 存 儲 到 叫 做 varname 的 變 量 中 。 如 果 函 │ 數 返 回 1則 不 設 置 varname 。 識 別 下 列 字 符 類 (類 的 名 字 可 以 被 縮 │ 寫 ): │

alnum │ 任 何 Unicode 字 母 或 數 字 字 符 。 │
alpha │ 任 何 Unicode 字 母 字 符 。 │
ascii │ 值 小 於 \u0080 的 任 何 字 符 (這 是 7-bit ascii 的 範 圍 )。 │
boolean │

Tcl_GetBoolean 所 允 許 的 任 何 形 式 。 │

control │ 任 何 Unicode 控 制 字 符 。 │
digit │ 任 何 Unicode 數 字 字 符 。 注 意 這 包 括 在 [0-9] 範 圍 外 的 字 │ 符 。 │
double │ 雙 精 度 數 在 Tcl 中 的 任 何 有 效 形 式 ， 可 以 有 可 選 的 圍 繞 白 空 │ 格 。 在 值 下 溢 /上 溢 的 情 況 下 ， 返 回 0 並 且 varname 將 包 含 │ -1。 │
false │

Tcl_GetBoolean 允 許 的 任 何 形 式 ， 這 裏 的 值 是 假 。 │

graph │ 除 了 空 格 之 外 的 任 何 Unicode 打 印 字 符 。 │
integer │ 整 數 在 Tcl 中 的 任 何 有 效 形 式 ， 可 以 有 可 選 的 圍 繞 白 空 │ 格 。 在 值 下 溢 /上 溢 的 情 況 下 ， 返 回 0 並 且 varname 將 包 含 │ -1。 │
lower │ 任 何 Unicode 小 寫 字 母 字 符 。 . │
print │ 包 括 空 格 在 內 的 任 何 Unicode 打 印 字 符 。 │
punct │ 任 何 Unicode 標 點 字 符 。 │
space │ 任 何 Unicode 空 格 字 符 。 │
true │

Tcl_GetBoolean 所 允 許 的 任 何 形 式 ， 這 裏 的 值 是 真 。 │

upper │ 在 Unicode 中 的 任 何 大 寫 字 符 。 │
wordchar │ 任 何 Unicode 單 字 字 符 。 它 是 任 何 字 母 字 符 和 Unicode 連 │ 接 符 標 點 字 符 (例 如 ， 下 劃 線 )。 │
xdigit │ 任 何 十 六 進 制 數 字 字 符 ([0-9A-Fa-f]). │ 在 boolean、 true 和 false 的 情 況 下 ， 如 果 函 數 將 返 回 0， 則 varname │ 總 是 被 設 置 爲 0， 原 因 是 一 個 有 效 boolean 值 有 多 種 本 地 (表 示 )。 │

string last string1 string2 ?startIndex? │ 在 string2 中 查 找 精 確 的 匹 配 在 string1 中 的 字 符 的 一 個 字 符 序 列 。 如 果 找 到 ， 返 回 在 string2 中 最 後 一 個 這 樣 的 匹 配 的 第 一 個 字 符 的 索 引 。 如 果 沒 有 匹 配 ， 則 返 回 -1。 如 果 指 定 了 startIndex(以 可 被 │ index 方 法 接 受 的 任 何 形 式 )， 則 查 找 只 針 對 string2 中 用 │ startIndex 指 定 的 和 此 前 的 字 符 。 例 如 ， │

string last a 0a23456789abcdef 15 │ 將 返 回10, 而 │
string last a 0a23456789abcdef 9 │ 將 返 回1. │

string length string 返 回 一 個 十 進 制 字 符 串 ， 給 出 在 string 中 字 符 的 數 目 。 注 意 這 不 是 必 須 與 用 於 存 儲 這 個 字 符 串 的 字 節 的 數 目 相 同 。 │
string map ?-nocase? charMap string │ 基 於 在 charMap 中 的 鍵 -值 對 替 代 string 中 的 字 符 。 charMap 是 形 │ 如 key value key value ... 的 一 個 列 表 ， 同 於 從 array get 返 回 的 │ 那 種 形 式 。 在 字 符 串 中 這 些 鍵 的 每 個 實 例 將 被 替 代 爲 相 應 的 值 。 如 果 指 定 │ 了 -nocase， 則 進 行 匹 配 時 不 區 別 大 小 寫 。 key 和 value 二 者 都 可 以 是 │ 多 字 節 的 。 以 一 種 有 次 序 的 方 式 進 行 替 代 ， 所 以 在 列 表 中 出 現 在 最 前 面 的 │ 鍵 將 被 首 先 檢 查 ， 以 此 類 推 。 string 只 被 重 複 操 作 (iterate)一 次 ， 所 以 │ 早 先 的 鍵 替 代 將 不 影 響 以 後 的 鍵 匹 配 。 例 如 ， │

string map {abc 1 ab 2 a 3 1 0} 1abcaababcabababc │ 將 返 回 字 符 串 01321221. │

string match ?-nocase? pattern string │ 查 看 pattern 是 否 匹 配 string； 如 果 是 則 返 回 1， 不 是 則 返 回 0。 如 │ 果 指 定 了 -nocase， 則 針 對 字 符 串 的 模 式 匹 配 採 用 大 小 寫 不 敏 感 的 方 式 。 對 於 要 進 行 匹 配 的 這 兩 個 字 符 串 ， 除 了 在 pattern 中 可 以 出 現 的 下 列 特 殊 序 列 之 外 它 們 的 內 容 必 須 相 同 :