match 메서드
업데이트: 2007년 11월
정규식 패턴을 사용하여 문자열을 검색하고 그 결과를 배열로 반환합니다.
function match(rgExp : RegExp) : Array
인수
- rgExp
필수적 요소. 정규식 패턴 및 적용 가능한 플래그를 포함하는 Regular Expression 개체의 인스턴스입니다. 정규식 패턴과 플래그가 포함된 변수 이름이나 문자열 리터럴일 수도 있습니다.
설명
match 메서드가 일치하는 부분을 찾지 못하면 null을 반환합니다. match 메서드가 일치하는 부분을 찾으면 배열을 반환하고, 검색 결과를 반영하도록 RegExp 개체가 업데이트됩니다.
match 메서드가 반환하는 배열에는 input, index 및 lastIndex의 세 속성이 있습니다. input 속성은 전체 검색 문자열을 포함합니다. index 속성은 전체 검색 문자열 내의 일치하는 부분 문자열의 위치를 포함합니다. lastIndex 속성에는 마지막 일치 대상의 마지막 문자 다음 위치가 포함됩니다.
전역 플래그 g가 설정되어 있지 않으면 배열의 0 요소에는 전체 일치 대상이 포함되고, 1 – n 요소에는 일치 대상 내의 모든 부분 일치가 포함됩니다. 이 동작은 전역 플래그가 설정되지 않은 exec 메서드의 동작과 같습니다. 전역 플래그가 설정되면 0 - n 요소에는 일치하는 모든 대상이 포함됩니다.
예제
다음 예제에서는 match 메서드의 사용 예를 보여 줍니다.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/i; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return first occurrence of "ain".
}
이 예제에서는 g 플래그가 설정된 일치 메서드를 사용하는 방법을 보여 줍니다.
function MatchDemo(){
var r, re; //Declare variables.
var s = "The rain in Spain falls mainly in the plain";
re = /ain/ig; //Create regular expression pattern.
r = s.match(re); //Attempt match on search string.
return(r); //Return array containing all four
// occurrences of "ain".
}
다음 코드 줄에서는 match 메서드로 문자열 리터럴을 사용하는 방법을 보여 줍니다.
var r, re = "Spain";
r = "The rain in Spain".replace(re, "Canada");