string map {abc 1 ab 2 a 3 1 0} 1abcaababcabababc+
From dfbde800afdabc83efc9ebe087b1aed6a90136d8 Mon Sep 17 00:00:00 2001
From: Steve Bennett
+ Like string range except works on bytes rather than characters. + These commands are identical if UTF-8 support is not enabled. +
++ Replaces substrings in string based on the key-value pairs in + mapping, which is a list of key value key value ... as in the form + returned by array get. Each instance of a key in the string will be + replaced with its corresponding value. If -nocase is specified, then + matching is done without regard to case differences. Both key and value may + be multiple characters. Replacement is done in an ordered manner, so the + key appearing first in the list will be checked first, and so on. string is + only iterated over once, so earlier key replacements will have no affect for + later key matches. For example, +
+string map {abc 1 ab 2 a 3 1 0} 1abcaababcabababc+
+ will return the string 01321221. +
++ Note that if an earlier key is a prefix of a later one, it will completely mask the later + one. So if the previous example is reordered like this, +
+string map {1 0 ab 2 a 3 abc 1} 1abcaababcabababc+
+ it will return the string 02c322c222c. +
+Matches any character in the set given by chars. - If a sequence of the form x-y appears in chars, + If a sequence of the form x-y appears in chars, then any character between x and y, inclusive, will match.
@@ -5965,8 +6023,8 @@ Any hexadecimal digit character ([0-9A-Fa-f]).Matches the single character x. This provides a way of - avoiding the special interpretation of the characters \*?[]\ - in '+pattern'+. + avoiding the special interpretation of the characters \*?[] + in pattern.
- Like string range except works on bytes rather than characters. These commands - are identical if UTF-8 support is not enabled -
-