JavaScript 的 match() 是字串物件上最常被使用的正則比對方法之一。它會依傳入的正則表達式搜尋字串,並把比對結果以陣列形式回傳,在表單驗證、內容擷取、字串清洗等實務場景中非常實用。以下把它的語法、回傳值結構與常見陷阱一次整理清楚。
stringObj.match(rgExp)
其中 stringObj 為必填,代表要被搜尋的 String 物件或字串字面值;rgExp 同樣為必填,是包含正則表達式模式與修飾符(flags)的正則物件,也可以是承載這些資訊的變數或字串字面值。
若沒有找到任何比對結果,match() 會回傳 null;一旦比對成功,則回傳一個陣列,同時更新全域 RegExp 物件的相關屬性以反映比對狀態。
這個陣列本身還帶有三個屬性:
關鍵差異在於是否帶 g(全域)修飾符:
g 時,陣列第 0 項是整段比對結果,第 1 到 n 項依序是各個群組捕獲的子比對,行為等同於不帶 g 的 exec()。g 時,陣列第 0 到 n 項會列出「所有」比對到的完整結果,但不再提供群組捕獲資訊,也不帶 index 等屬性。function MatchDemo() {
var r, re;
var s = "The rain in Spain falls mainly in the plain";
re = /ain/i; // 建立正則模式
r = s.match(re); // 進行比對
return r; // 只回傳第一次出現的 "ain"
}
function MatchDemo() {
var r, re;
var s = "The rain in Spain falls mainly in the plain";
re = /ain/ig; // 全域且忽略大小寫
r = s.match(re);
return r; // 回傳陣列,內含全部四個 "ain"
}
match() 用來從字串中查找指定內容,作用有點像 indexOf() 與 lastIndexOf(),但最大的不同是:match() 回傳的是「符合的內容本身」,而 indexOf() 回傳的是「位置數字」,找不到時回傳 -1。另外務必留意,match() 預設區分大小寫。
<script type="text/javascript">
var str = "Hello world!";
document.write(str.match("world") + "<br/>"); // world
document.write(str.match("World") + "<br/>"); // null(大小寫不符)
document.write(str.match("worlld") + "<br/>"); // null(拼字錯誤)
document.write(str.match("world!")); // world!
</script>