定義和用法
replace() 方法用於在字符串中用一些字符替換另一些字符,或替換一個與正則表達式匹配的子串。
語法
stringObject.replace(regexp/substr, replacement)
參數說明:
regexp/substr 必需。規定子字符串或要替換的模式的 RegExp 對象。請注意,如果該值是一個字符串,則將它作為要檢索的直接量文本模式,而不是首先被轉換為 RegExp 對象。
replacement 必需。一個字符串值,規定了替換文本或生成替換文本的函數。
返回值
一個新的字符串,是用 replacement 替換了 regexp 的第一次匹配或所有匹配之後得到的。
說明
字符串 stringObject 的 replace() 方法執行的是查找並替換的操作。它將在 stringObject 中查找與 regexp 相匹配的子字符串,然後用 replacement 來替換這些子串。如果 regexp 具有全局標志 g,那麼 replace() 方法將替換所有匹配的子串;否則,它只替換第一個匹配子串。
replacement 可以是字符串,也可以是函數。如果它是字符串,那麼每個匹配都將由字符串替換;但此時 replacement 中的 $ 字符具有特定的含義:
字符 替換文本
$1、$2、...、$99 與 regexp 中的第 1 到第 99 個子表達式相匹配的文本。
$& 與 regexp 相匹配的子串。
$` 位於匹配子串左側的文本。
$' 位於匹配子串右側的文本。
$$ 直接量符號(一個字面意義的 $)。
注意:ECMAScript v3 規定,replace() 方法的參數 replacement 可以是函數而不是字符串。在這種情況下,每個匹配都調用該函數,它返回的字符串將作為替換文本使用。該函數的第一個參數是匹配模式的字符串;接下來的參數是與模式中的子表達式匹配的字符串,可以有 0 個或多個這樣的參數;再接下來是一個整數,聲明了匹配在 stringObject 中出現的位置;最後一個參數是 stringObject 本身。
例子 1 將字符串中的 "Microsoft" 替換為 "jb51.net":
<script type="text/javascript"> var str = "Visit Microsoft!" document.write(str.replace(/Microsoft/, "jb51.net")) </script>
輸出:
Visit jb51.net!
例子 2 執行一次全局替換,每當 "Microsoft" 被找到就替換為 "jb51.net":
<script type="text/javascript"> var str = "Welcome to Microsoft! " str = str + "We are proud to announce that Microsoft has " str = str + "one of the largest Web Developers sites in the world." document.write(str.replace(/Microsoft/g, "jb51.net")) </script>
輸出:
Welcome to jb51.net! We are proud to announce that jb51.net has one of the largest Web Developers sites in the world.
注意那個 g——沒有它,只會替換第一處。
例子 3 忽略大小寫匹配:
text = "javascript Tutorial"; text.replace(/javascript/i, "JavaScript");
例子 4 把 "Doe, John" 轉換為 "John Doe",這裡用到了 $1、$2:
name = "Doe, John"; name.replace(/(\w+)\s*, \s*(\w+)/, "$2 $1");
例子 5 把所有花引號替換為直引號:
name = '"a", "b"'; name.replace(/"([^"]*)"/g, "'$1'");
例子 6 把字符串中所有單詞的首字母轉換為大寫,這裡 replacement 是一個函數:
name = 'aaa bbb ccc';
uw = name.replace(/\b\w+\b/g, function(word){
return word.substring(0,1).toUpperCase() + word.substring(1);
});
var strings = string.replace(regexp, replacement)
regexp:要執行替換操作的正則表達式。如果傳入的是一個字符串,那就會當作普通字符來處理,並且只會執行一次替換操作;如果是正則表達式,並且帶有 global (g) 修飾符,則會替換所有出現的目標字符,否則只執行一次替換操作。
replacement:要替換成的字符(或返回替換文本的函數)。
返回值:執行替換操作後的新字符串。原字符串不被修改——這點很重要,replace() 不是原地操作。
簡單替換(忽略大小寫)
var text = "javascript 非常強大 !"; text.replace(/javascript/i, "JavaScript"); // 返回:JavaScript 非常強大 !
替換所有出現的目標字符
var text = "javascript 非常強大 !JAVASCRIPT 是我最喜歡的一門語言 !"; text.replace(/javascript/ig, "JavaScript"); // 返回:JavaScript 非常強大 !JavaScript 是我最喜歡的一門語言 !
調換位置
var name = "Doe, John"; name.replace(/(\w+)\s*,\s*(\w+)/, "$2 $1"); // 返回:John Doe
把雙引號包含的字符替換成中括號包含的字符
var text = '"JavaScript" 非常強大!'; text.replace(/"([^"]*)"/g, "[$1]"); // 返回:[JavaScript] 非常強大!
所有單詞首字母大寫
var text = 'a journey of a thousand miles begins with single step.';
text.replace(/\b\w+\b/g, function(word) {
return word.substring(0,1).toUpperCase() + word.substring(1);
});
// 返回:A Journey Of A Thousand Miles Begins With Single Step.
最後提醒一個實務細節:因為 replace() 返回新串而不改原串,寫 text.replace(...) 卻忘記接收返回值,是最常見的低級錯誤之一。鏈式處理時記得寫成 str = str.replace(...)。