stringObj.replace(rgExp, replaceText)
stringObj:必選項,要執行替換的 String 物件或字串字面值,該字串本身不會被 replace 方法修改。
rgExp:必選項,為包含正則運算式模式或可用標誌的正則運算式物件,也可以是 String 物件或字面值。如果 rgExp 不是正則運算式物件,它會被轉換為字串並進行精確查找。
replaceText:必選項,是一個 String 物件或字串字面值,對於 stringObj 中每個符合 rgExp 的位置,都用該物件所包含的文字加以替換。在 JScript 5.5 或更新版本中,replaceText 參數也可以是回傳替換文字的函式。
replace 方法的結果,是一個完成指定替換後的 stringObj 副本。下列匹配變數可用來識別最新的匹配並找出符合的字串,在需要動態決定替換字串的場景中相當有用:
$$ 代表 $ 符號;$& 代表與整個模式匹配的 stringObj 部分;$` 代表匹配之前的 stringObj 部分;$' 代表匹配之後的 stringObj 部分;$n 代表捕獲的第 n 個子匹配(n 為 1 到 9);$nn 代表捕獲的第 nn 個子匹配(nn 為 01 到 99)。
如果 replaceText 是函式,對於每一個匹配的子字串,呼叫該函式時會帶有 m+3 個參數(m 為 rgExp 中捕獲的括號數)。第一個參數是匹配的子字串,接下來 m 個參數是捕獲的結果,第 m+2 個參數是匹配出現的偏移量,第 m+3 個參數為 stringObj。
以下示範將第一次出現的單字 "The" 替換為 "A":
程式碼如下:
function ReplaceDemo(){
var r, re; // 聲明變量。
var ss = "The man hit the ball with the bat.n";
ss += "while the fielder caught the ball with the glove.";
re = /The/g; // 創建正則表達式模式。
r = ss.replace(re, "A"); // 用 "A" 替換 "The"。
return(r); // 返回替換後的字符串。
}
replace 方法也能替換模式中的子運算式,下面的範例示範交換字串中每一對單字:
程式碼如下:
function ReplaceDemo(){
var r, re; // 聲明變量。
var ss = "The rain in Spain falls mainly in the plain.";
re = /(S+)(s+)(S+)/g; // 創建正則表達式模式。
r = ss.replace(re, "$3$2$1"); // 交換每一對單詞。
return(r); // 返回結果字符串。
}
下面的範例執行華氏轉攝氏的換算,示範如何使用函式作為 replaceText:
程式碼如下:
function f2c(s) {
var test = /(d+(.d*)?)Fb/g; // 初始化模式。
return(s.replace
(test,
function($0,$1,$2) {
return((($1-32) * 5/9) + "C");
}
)
);
}
document.write(f2c("Water freezes at 32F and boils at 212F."));
由於 JavaScript 本身並未提供 replaceAll 方法,若用 for 迴圈硬做又有效能問題,這裡提供一個正則運算式的解決方案:
程式碼如下:
String.prototype.replaceAll = function(s1,s2){
return this.replace(new RegExp(s1,"gm"),s2);
}
方法:string.replace(new RegExp(oldString,"gm"),newString)。其中 g 代表 global(全域),m 代表 multiLine(多行),如此一來就能一次替換所有指定的字串。
另一個快速驗證的小技巧:在瀏覽器網址列輸入 javascript:alert("abcabcabc".replace(new RegExp("a","gm"),"ad")) 就能立即看到結果,相當省事。
如果不用正則運算式,orgStr.replace(findStr, replaceStr) 只能替換第一個符合的字串;若想替換全部,加上正則的 g 旗標即可。