使用正則表達式模式對字符串執行查找，并將包含查找的結果作為數組返回。

stringObj.match(rgEXP)

參數

stringObj

必選項。對其進行查找的 String 對象或字符串文字。

rgExp

必選項。為包含正則表達式模式和可用標志的正則表達式對象。也可以是包含正則表達式模式和可用標志的變量名或字符串文字。

說明

假如 match 方法沒有找到匹配，返回 null。假如找到匹配返回一個數組并且更新全局 RegExp 對象的屬性以反映匹配結果。

match 方法返回的數組有三個屬性：input、index和lastIndex。Input 屬性包含整個的被查找字符串。Index 屬性包含了在整個被查找字符串中匹配的子字符串的位置。LastIndex 屬性包含了最后一次匹配中最后一個字符的下一個位置。

假如沒有設置全局標志 (g)，數組的0元素包含整個匹配，而第 1 到 n 元素包含了匹配中曾出現過的任一個子匹配。這相當于沒有設置全局標志的 exec 方法。假如設置了全局標志，元素0到n中包含所有匹配。

示例

下面的示例演示了match 方法的用法：

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" 的地方。}

本示例說明帶 g 標志設置的 match 方法的用法。

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 方法的用法。

var r, re = "Spain";r = "The rain in Spain".replace(re, "Canada");