JavaScript中String的match方法详解

清疚 2022-03-12 09:26 471阅读 0赞

# String.prototype.match() #

\*\* String.prototype.match()方法返回通过一个正则表达式匹配到的字符串结果。\*\*

var paragraph = 'The quick brown fox jumps over the lazy dog. It barked.';
    var regex = /[A-Z]/g;
    var found = paragraph.match(regex);
    
    console.log(found);
    // 输出: Array ["T", "I"]

## 语法 ##

str.match(regexp)

### 参数 ###

**regexp**  
一个正则表达式对象。如果传递了一个非正则表达式对象，函数会执行new RegExp(obj)将他转换成一个字符串对象。如果没有传递任何参数，函数将返回空字符串数组：\[“”\]。

### 返回值 ###

如果有匹配值，String.prototype.match()返回一个数组，这个数组的内容取决于正则表达式参数中是否有g修饰符。如果没有匹配值，返回null。  
（1）如果正则表达式中有g修饰符。所有匹配到的值会按照数组格式被返回，不会返回捕获组。  
（2）如果没有g修饰符。只有第一个匹配到的值会被返回，同时还会返回第一个匹配到的值内部的所有捕获组。在这种情况下，返回值会多包含以下几个属性：

*  groups：如果匹配值中包含捕获组，返回值中将包含捕获组信息的各项值。否则为undefined。
 *  index：匹配值在整个字符串中的索引。
 *  input：整个字符串。

## 描述 ##

如果String.prototype.match()参数的正则表达式中没有包含g修饰符，str.match()将会和RegExp.prototype.exec()方法返回一样的结果。

*  如果只想知道一个字符串是否匹配一个正则表达式，使用RegExp.prototype.test()。
 *  如果想使用一个包含g修饰符的正则表达式匹配中获得捕获组，使用RegExp. prototype.exec()。

## 示例 ##

### 直接使用String.prototype.match() ###

下面的例子中，String.prototype.match()将会查找一个以”Chapter”开头的，其后跟随一个或多个数字字符，数字字符后跟随另个或多个’.+数字字符’。在下面代码中正则表达式中有i修饰符，所以整个正则表达式忽略大小写。

var str = 'For more information, see Chapter 3.4.5.1';
    var re = /see (chapter \d+(\.\d)*)/i;
    var found = str.match(re);
    
    console.log(found);
    // 输出 [ 'see Chapter 3.4.5.1', 'Chapter 3.4.5.1', '.1',
    //        index: 22,
    //        input: 'For more information, see Chapter 3.4.5.1' ]
    
    // 'see Chapter 3.4.5.1'是整个匹配项值.
    // 'Chapter 3.4.5.1' 被捕获组'(chapter \d+(\.\d)*)'捕获.
    // '.1' 被最后一个捕获组'(\.\d)捕获'.
    // 'index'属性(值22)是第一个匹配字符在整个字符串中的索引位置.
    // 'input'是整个字符串.

### 在String.prototype.match()中使用g修饰符 ###

下面的例子中，参数正则表达式中包含g修饰符，结果将会返回所有被匹配的值。

var str = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz';
    var regexp = /[A-E]/gi;
    var matches_array = str.match(regexp);
    
    console.log(matches_array);
    // ['A', 'B', 'C', 'D', 'E', 'a', 'b', 'c', 'd', 'e']

### 在String.prototype.match()中不传入参数 ###

var str = "Nothing will come of nothing.";
    
    str.match();   // 返回 [""]

### 一个非正则表达式作为参数 ###

当一个参数是一个字符串或一个数字，函数内部将会用new RegExp(obj)将他转换成正则表达式对象。如果参数是一个包含“+”符号的正数，则RegExp()函数将会忽略这个“+”符号。

var str1 = "NaN means not a number. Infinity contains -Infinity and +Infinity in JavaScript.",
        str2 = "My grandfather is 65 years old and My grandmother is 63 years old.",
        str3 = "The contract was declared null and void.";
    str1.match("number");    // "number" 是个字符串，返回["number"]
    str1.match(NaN);         // NaN 的数据类型是数字，返回 ["NaN"]
    str1.match(Infinity);    // Infinity 的数据类型是数字，返回 ["Infinity"]
    str1.match(+Infinity);   // 返回 ["Infinity"]
    str1.match(-Infinity);   // 返回 ["-Infinity"]
    str2.match(65);          // 返回 ["65"]
    str2.match(+65);         // “+”符号将会被忽略，返回 ["65"]
    str3.match(null);        // 返回 ["null"]