(Str) 方法 subst
subst 取的是單詞 substitution(替換)的前5個字符, 意為替換之意。
multi method subst(Str:D: $matcher, $replacement, *%opts)
返回被調(diào)用的那個字符串, 其中 $matcher 被 $replacement 給替換掉了(或者返回原來的字符串, 如果沒有找到匹配的話)。
subst 有一個「就地」替換的句法變體, 它被拼寫為 s/matcher/replacement/。
$matcher 可以是一個正則表達式, 或者一個字符串字面值。 Cool 類型的非字符串 matcher 會被強轉為字符串以用于字面上的匹配。
my $some-string = "Some foo";
my $another-string = $some-string.subst(/foo/, "string"); # gives 'Some string'
$some-string.=subst(/foo/, "string"); # in-place substitution. $some-string is now 'Some string'
replacement 可以是一個閉包:
my $i = 41;
my $str = "The answer is secret.";
my $real-answer = $str.subst(/secret/, {++$i}); # The answer to everything
下面是 subst 其它用法的例子:
my $str = "Hey foo foo foo";
$str.subst(/foo/, "bar", :g); # 全局替換 - 返回 Hey bar bar bar
$str.subst(/foo/, "no subst", :x(0)); # 有針對性的替換。要替換的次數(shù). 返回未修改過的字符串.
$str.subst(/foo/, "bar", :x(1)); # 只替換第一次出現(xiàn)。
$str.subst(/foo/, "bar", :nth(3)); # 單獨替換第 n 個匹配. 替換第三個 foo. 返回 Hey foo foo bar
第三個參數(shù)傳遞給散列, 例如 :g 被吞噬參數(shù) *%opts 接收, 意為 g => True。
其中的 :nth 副詞擁有可讀的長得像英語那樣的變體:
say 'ooooo'.subst: 'o', 'x', :1st; # xoooo
say 'ooooo'.subst: 'o', 'x', :2nd; # oxooo
say 'ooooo'.subst: 'o', 'x', :3rd; # ooxoo
say 'ooooo'.subst: 'o', 'x', :4th; # oooxo
subst 還支持下面的副詞:
| short | long | meaning |
|---|---|---|
| :g | :global | 盡可能多次地替換 |
| :nth(Int|Callable) | 只替換第n次匹配; 別名: :st, :nd, :rd, 和 :th | |
| :ss | :samespace | preserves whitespace on substitution |
| :ii | :samecase | 替換時保留大小寫 |
| :mm | :samemark | 保留字符標記(e.g. 'ü' replaced with 'o' 會導致 '?') |
| :x(Int|Callable) | substitute exactly $x matches |
注意, 只有在
s///形式中:ii暗指:i而:ss暗指:s. 在方法的形式中:s和:i修飾符必須添加到正則表達式中, 而非添加到 subst 方法調(diào)用中。
