#### JavaScript match()
#### 定义和用法
match() 方法可在字符串内检索指定的值,或找到一个或多个正则表达式的匹配。
该方法类似 indexOf() 和 lastIndexOf(),但是它返回指定的值,而不是字符串的位置。
#### 语法 - /字符串或数字匹配
~~~
stringObject.match(searchvalue)
~~~
|参数|描述|
| --- | --- |
|searchvalue|必需。规定要检索的字符串值或者数字。|
注释:当参数是一个字符串或一个数字,它会使用new RegExp(obj)来隐式转换成一个 RegExp。如果它是一个有正号的正数,RegExp() 方法将忽略正号。
例子 1.
~~~
<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>
~~~
例子 2.
~~~
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的类型是number。返回["NaN"]
str1.match(Infinity); // Infinity的类型是number。返回["Infinity"]
str1.match(+Infinity); // 返回["Infinity"]
str1.match(-Infinity); // 返回["-Infinity"]
str2.match(65); // 返回["65"]
str2.match(+65); // 有正号的number。返回["65"]
str3.match(null); // 返回["null"]
~~~
#### 返回值
匹配的字符串。没有找到匹配字符串时候返回null。
* * * * *
#### 语法 - /正则匹配
~~~
stringObject.match(regexp)
~~~
|参数|描述|
| --- | --- |
|regexp |必需。规定要匹配的模式的 RegExp 对象。如果该参数不是 RegExp 对象,则需要首先把它传递给 RegExp 构造函数,将其转换为 RegExp 对象。|
#### 返回值
存放匹配结果的数组。该数组的内容依赖于 regexp 是否具有全局标志 g。
#### 说明
match() 方法将检索字符串 stringObject,以找到一个或多个与 regexp 匹配的文本。这个方法的行为在很大程度上有赖于 regexp 是否具有标志 g。
如果 regexp 没有标志 g,那么 match() 方法就只能在 stringObject 中执行一次匹配。如果没有找到任何匹配的文本, match() 将返回 null。否则,它将返回一个数组,其中存放了与它找到的匹配文本有关的信息。该数组的第 0 个元素存放的是匹配文本,而其余的元素存放的是与正则表达式的子表达式匹配的文本。除了这些常规的数组元素之外,返回的数组还含有两个对象属性。index 属性声明的是匹配文本的起始字符在 stringObject 中的位置,input 属性声明的是对 stringObject 的引用。
~~~
<script type="text/javascript">
var str="That's hot!";
var patt1=/h.t/;
document.write(str.match(patt1)); //hat
/*
*str.match(patt1)匹配数组 :
* 0->hat
* index->1
* input->"That's hot!"
* length->1
*/
</script>
~~~
~~~
<script type="text/javascript">
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);
// logs [ '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' 属性是被解析的原始字符串。
</script>
~~~
如果 regexp 具有标志 g,则 match() 方法将执行全局检索,找到 stringObject 中的所有匹配子字符串。若没有找到任何匹配的子串,则返回 null。如果找到了一个或多个匹配子串,则返回一个数组。数组元素中存放的是 stringObject 中所有的匹配子串,但是没有 index 属性或 input 属性。
~~~
<script type="text/javascript">
var str="1 plus 2 equal 3";
document.write(str.match(/\d+/g));//数组打印:1,2,3
/*
*str.match(/\d+/g)匹配数组 :
* 0->"1"
* 1->"2"
* 2->"3"
*/
</script>
~~~
注意:在全局检索模式下,match() 即不提供与子表达式匹配的文本的信息,也不声明每个匹配子串的位置。如果您需要这些全局检索的信息,可以使用 RegExp.exec()。
例子:match 使用全局(global)和忽略大小写(ignore case)标志
下例展示了 match 使用 global 和 ignore case 标志。A-E、a-e 的所有字母将会作为一个数组的元素返回。
~~~
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']
~~~
[MDN-参考资料](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String/match)