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 對 字 符 串 string1string2 進 行 逐 個 字 符 的 比 較 。 依 賴 於 string1 在 詞 典 順 序 上 (lexicographically)小 於 、 等 於 、 大 於 string2, 返 回 -1、 0、 或 1。 如 果 指 定 了 -length , 則 在 比 較 中 只 使 用 前 length 個 字 符 。 如 果 -length 是 負 數 , 則 被 忽 略 。 如 果 指 定 了 -nocase , 則 使 用 大 小 寫 不 敏 感 方 式 比 較 字 符 串 。
string equal
?-nocase? ?-length int? string1 string2 對 字 符 串 string1string2 進 行 逐 個 字 符 的 比 較 。 如 果 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]). booleantruefalse 的 情 況 下 , 如 果 函 數 將 返 回 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, 則 進 行 匹 配 時 不 區 別 大 小 寫 。 keyvalue 二 者 都 可 以 是 多 字 節 的 。 以 一 種 有 次 序 的 方 式 進 行 替 代 , 所 以 在 列 表 中 出 現 在 最 前 面 的 鍵 將 被 首 先 檢 查 , 以 此 類 推 。 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 中 可 以 出 現 的 下 列 特 殊 序 列 之 外 它 們 的 內 容 必 須 相 同 :

* 匹 配

string 中 任 何 字 符 的 一 個 序 列 , 包 括 一 個 空 字 符 。

? 匹 配

string 中 的 一 個 單 一 字 符 。

[chars] 匹 配 在

chars 給 出 的 集 合 中 的 任 何 字 符 。 如 果 在 chars 中 出 現 一 個 形 式 是 x-y 的 一 個 序 列 , 則 匹 配 在 xy,之 間 的 任 何 字 符 , 包 括 二 者 。 當 與 -nocase 一 起 使 用 的 時 候 , 範 圍 的 端 點 首 先 被 轉 換 爲 小 寫 。 所 以 在 大 小 寫 敏 感 匹 配 時 {[A-z]} 匹 配 ’_’(’_’位 於 ’Z’和 ’a’之 間 ), 加 上 -nocase 則 將 被 象 {[A-Za-z]} 那 樣 對 待 (並 可 能 是 前 者 的 真 實 意 圖 )。

\x

匹 配 單 一 字 符 x。 這 提 供 了 一 種 方 式 避 免 在 pattern 中 對 字 符 *?[]\ 做 特 殊 解 釋 。

string range string first laststring 返 回 一 個 範 圍 的 連 續 字 符 , 從 索 引 是 first 的 字 符 開 始 並 結 束 於 索 引 是 last 的 字 符 。 索 引 0 參 照 字 符 串 的 第 一 個 字 符 。 可 以 按 index 方 法 的 方 式 指 定 firstlast 。 如 果 first 小 於 零 , 則 把 它 作 爲 零 對 待 , 而 如 果 last 大 於 等 於 字 符 串 的 長 度 , 則 把 它 作 爲 end 對 待 。 如 果 first 大 於 last 則 返 回 空 串 。
string repeat
string count string 重 複 count 次 後 返 回 。
string replace
string first last ?newstring? string 刪 除 一 個 範 圍 的 連 續 字 符 , 範 圍 從 索 引 是 first 的 字 符 開 始 並 結 束 於 索 引 是 last 的 字 符 。 索 引 0 參 照 字 符 串 的 第 一 個 字 符 。 可 以 按 index 方 法 的 方 式 指 定 firstlast 。 如 果 指 定 了 newstring , 則 把 它 放 置 在 刪 除 的 字 符 範 圍 中 。 如 果 first 於 零 , 則 把 它 作 爲 零 對 待 , 而 如 果 last 大 於 等 於 字 符 串 的 長 度 , 則 把 它 作 爲 end 對 待 。 如 果 first 大 於 last 或 最 初 的 字 符 串 的 長 度 , 或 者 last 小 於 0, 則 不 做 變 動 的 返 回 最 初 的 字 符 串 。
string tolower
string ?first? ?last? 返 回 一 個 等 同 於 string 的 值 , 但 所 有 大 寫 (或 標 題 )字 母 都 被 轉 換 爲 小 寫 。 如 果 指 定 了 first, 則 它 參 照 字 符 串 中 開 始 修 改 的 第 一 個 字 符 的 索 引 。 如 果 指 定 了 last, 則 它 參 照 字 符 串 中 修 改 停 止 到 (包 括 它 )的 那 個 字 符 的 索 引 。 按 index 方 法 的 方 式 指 定 firstlast
string totitle
string ?first? ?last? 返 回 等 同 於 string 的 一 個 值 , 但 把 string 的 第 一 個 字 符 轉 換 成 它 的 Unicode 標 題 大 寫 變 體 (如 果 沒 有 標 題 大 寫 變 體 則 爲 大 寫 )而 把 字 符 串 的 其 餘 部 分 轉 換 成 小 寫 。 如 果 指 定 了 first, 則 它 參 照 字 符 串 中 開 始 修 改 的 第 一 個 字 符 的 索 引 。 如 果 指 定 了 last, 則 它 參 照 字 符 串 中 修 改 停 止 到 (包 括 它 )的 那 個 字 符 的 索 引 。 按 index 方 法 的 方 式 指 定 firstlast
string toupper
string ?first? ?last? 返 回 一 個 等 同 於 string 的 值 , 但 所 有 小 寫 (或 標 題 )字 母 都 被 轉 換 爲 大 寫 。 如 果 指 定 了 first, 則 它 參 照 字 符 串 中 開 始 修 改 的 第 一 個 字 符 的 索 引 。 如 果 指 定 了 last, 則 它 參 照 字 符 串 中 修 改 停 止 到 (包 括 它 )的 那 個 字 符 的 索 引 。 按 index 方 法 的 方 式 指 定 firstlast
string trim
string ?chars? 返 回 一 個 等 同 於 string 的 值 , 但 刪 除 了 任 何 前 導 或 尾 隨 的 用 chars 給 出 的 字 符 集 合 中 字 符 。 如 果 未 指 定 chars 則 刪 除 白 空 格 (空 格 、 tab、 換 行 、 回 車 )。
string trimleft
string ?chars? 返 回 一 個 等 同 於 string 的 值 , 但 刪 除 了 任 何 前 導 的 用 chars 給 出 的 字 符 集 合 中 字 符 。 如 果 未 指 定 chars 則 刪 除 白 空 格 (空 格 、 tab、 換 行 、 回 車 )。
string trimright
string ?chars? 返 回 一 個 等 同 於 string 的 值 , 但 刪 除 了 任 何 尾 隨 的 用 chars 給 出 的 字 符 集 合 中 字 符 。 如 果 未 指 定 chars 則 刪 除 白 空 格 (空 格 、 tab、 換 行 、 回 車 )。
string wordend
string charIndex 返 回 包 含 string 的 第 charIndex 個 字 符 的 那 個 字 最 後 的 字 符 後 面 的 那 個 字 符 的 索 引 。 按 index 方 法 的 方 式 指 定 charIndex 。 一 個 字 被 認 爲 是 任 何 連 續 範 圍 的 alphanumeric (Unicode 字 母 或 十 進 制 數 字 )或 下 劃 線 (Unicode 連 接 符 標 點 )字 符 , 或 除 了 這 些 之 外 的 任 何 單 一 字 符 。
string wordstart
string charIndex 返 回 包 含 string 的 第 charIndex 個 字 符 的 那 個 字 的 第 一 個 字 符 的 索 引 。 按 index 方 法 的 方 式 指 定 charIndex 。 一 個 字 被 認 爲 是 任 何 連 續 範 圍 的 alphanumeric (Unicode 字 母 或 十 進 制 數 字 )或 下 劃 線 (Unicode 連 接 符 標 點 )字 符 , 或 除 了 這 些 之 外 的 任 何 單 一 字 符 。

參 見 SEE ALSO

expr(n), list(n)

關 鍵 字 KEYWORDS

case conversion, compare, index, match, pattern, string, word, equal, ctype

[中 文 版 維 護 人 ]

寒 蟬 退 士

[中 文 版 最 新 更 新 ]

2001/11/15

《 中 國 Linux 論 壇 man 手 冊 頁 翻 譯 計 劃 》 :

http://cmpp.linuxforum.net

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh

COMMENTS