정규식 또는 검색 문자열을 사용하여 문자열를 바꾼 문자열의 복사본을 반환한다.

stringObj.replace(regexp,function)

인수/파라메터

stringObj : (문자열 개체)

필수적인 요소이며, 바꾸려는 String 개체나 문자열 리터럴이다.
이 문자열은 replace 메서드로는 수정할 수 없다.

regexp : (정규식)

필수적인 요소이며, 정규식 패턴과 적용 가능한 플래그를 포함하는 Regular Expression 개체의 인스턴스이다.
정규식 패턴과 플래그를 포함하는 String 개체나 리터럴도 가능하다.
regexp 가 Regular Expression 개체의 인스턴스가 아닐 경우 문자열로 변환되고 정확한 검색을 수행하지만, 문자열을 다시 정규식으로 바꾸지는 않는다.

replaceText : (대체 문자열)

필수적인 요소이며, stringObj에서 regexp와 일치하는 것으로 바꿀 문자열를 포함하는 String 개체나 문자열 리터럴이다. JScript 5.5 이후에서는 변환 문자열를 반환하는 기능함수도 replaceText 인수가 될 수 있다.

function : (기능함수)

두번째 인수는 일치, 대체가 수행된 후에 새로 생성된 문자열을 이용하여 추가적으로 수행할 기능함수가 될 수 있다.

설명

replace 메서드의 결과는 지정된 변환이 이루어진 후의 stringObj 복사본이다.

아래 일치 변수를 사용해서 최근 일치와 그 문자열을 확인할 수 있다.
일치 변수는 변환 문자열이 동적으로 결정되어야 하는 문자열 변환에 사용할 수 있다.

문자	의미 (JScript 5.5 이상)
$$	$
$&	stringObj 중 전체 패턴이 일치하는 부분을 설정한다. lastMatch 속성
$`	stringObj 중 $&로 설명되는 일치 부분의 앞부분을 설정한다. leftContext 속성
$'	stringObj 중 $&로 설명되는 일치 부분의 뒷부분을 설정한다. rightContext 속성
$n	n번째 부분적으로 일치하는 부분이다. 여기서 n은 1부터 9 사이의 한 자리 숫자이다. 일치 $n 속성
$nn	nn번째 부분적으로 일치하는 부분이다. 여기서 nn은 1부터 99 사이의 두 자리 숫자이다.

문자열 전체에서 대체하려면 정규식에 전역플래그 g을, 영문에서 대소문자 구별 없이 대체하려면 i를 포함하여야 한다.

특기

replace 메서드는 전역 RegExp 개체의 속성을 업데이트한다.

간단한 replace 메서드 예제

<SCRIPT>
var br='<BR>'; // 줄바꿈
var str=''; // 출력 문자열 변수 선언
var regexp=/문자열/g; // 정규식 패턴 대신 리터럴로
var stringVar='정규식 또는 검색 문자열을 사용하여 문자열를 바꾼 문자열의 복사본을 반환한다.';
str+='stringVar='+stringVar+br; // 문자열 출력
str+='regexp='+regexp+br; // 정규식 패턴 출력
str+='stringVar.replace(regexp,"<FONT color=red>string</FONT>")=<BR>';
str+=stringVar.replace(regexp,'<FONT color=red>string</FONT>')+br; // index(대소문자 구별)를 인덱스로 대체
document.write(str); // 결과 문자열 출력
</SCRIPT>

replace 메서드로 연결 대체 예제

<SCRIPT>
orgString=new String("trio.co.kr 을 방문해 보라.");
regexp=/trio.co.kr/gi; // 정규식 패턴 지정
newString=new String('http://koxo.com/lang/js/method/replace.html#sampleJump'); // 대체할 새 문자열 지정
str='orgString='+orgString+'<BR>';
str+=orgString.replace(regexp,newString.link(newString))+'<BR>';
str+='newString='+newString+'<BR>';
document.write(str); // 결과 문자열 출력
</SCRIPT>