# REGEXREPLACE

## Content

## 요약

`REGEXREPLACE` 함수는 지정된 정규 표현식 패턴에 따라 문자열 내의 텍스트를 교체합니다.

## 구문

```javascript
=REGEXREPLACE(text, pattern, replacement, [occurrence], [case_sensitivity])
```

## 인수

| 인수                      | 설명                                                                                  |
| ----------------------- | ----------------------------------------------------------------------------------- |
| **text**<br>(필수)        | 교체할 텍스트가 포함된 입력 텍스트 또는 셀 참조입니다.                                                     |
| **pattern**<br>(필수)     | 일치시킬 정규 표현식 패턴입니다.                                                                  |
| **replacement**<br>(필수) | 일치한 패턴을 대체할 텍스트입니다.                                                                 |
| **occurrence**          | 교체할 일치 항목 지정:<br>`0`: 모두 교체 (기본값)<br>양수 N: N번째 일치 항목 교체<br>음수 N: 뒤에서부터 N번째 일치 항목 교체 |
| **case\_sensitivity**   | 대소문자 처리:<br>`0`: 대소문자 구분 (기본값)<br>`1`: 대소문자 구분 안 함                                  |

## 참고

* **반환값:** 교체 후 수정된 문자열

## 예제

```auto
=REGEXREPLACE("0000abcd","0","1", 2) // 0100abcd
=REGEXREPLACE("0000abcd","0","1", 0) // 1111abcd
=REGEXREPLACE("0000abcd","0","1", -1) // 0001abcd
=REGEXREPLACE("aaaAbcd","a","0", ,0)  // 000Abcd
=REGEXREPLACE("aaaAbcd","a","0", ,1)  // 0000bcd
=REGEXREPLACE("Sonia (378) 555-4195  Brown(878) 555-8622", "[0-9]+-", "***-")  // Sonia (378) ***-4195  Brown(878) ***-8622
=REGEXREPLACE("JamesHenry","([A-Z][a-z]+)([A-Z][a-z]+)","$2, $1")  // Henry, James
```

> REGEXREPLACE 함수는 Excel 구현과 호환성을 유지하며, 이전의 SJS.REGEXREPLACE 함수는 더 이상 권장되지 않지만 이전 버전과의 호환성을 유지합니다. 두 함수 간 주요 차이점은 다음과 같습니다:

| **특징**         | **REGEXREPLACE 함수**                                                                                                                                                                    | **SJS.REGEXREPLACE 함수**                                              |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **인수 유형**      | 대소문자 구분에 숫자 값(0/1) 사용:<br>`=REGEXREPLACE("aaaAbcd","a","0", ,1)`                                                                                                                       | 문자열 수정자 사용(예: "ig"):<br>`=SJS.REGEXREPLACE("aaaAbcd","a","0","ig")`  |
| **교체 대상 지정**   | 유연한 occurrence 제어:<ul><li>`0`: 모두 교체 (기본)</li><li>양수 N: N번째 교체</li><li>음수 N: 뒤에서부터 N번째 교체</li></ul>`=REGEXREPLACE("aaaAbcd","a","0", 2,1)`<br>`=REGEXREPLACE("aaaAbcd","a","0", -3,1)` | 제한적:<ul><li>첫 번째 항목(기본)</li><li>모든 항목 ("g" 수정자 사용 시)</li></ul>       |
| **멀티라인 처리**    | 표준 정규식 구문 필요:<br>`=REGEXREPLACE("abc`<br>`ABC","\n[A-Z]+","*")`                                                                                                                        | "m" 수정자 지원:<br>`=SJS.REGEXREPLACE("abc`<br>`ABC","^[A-Z]+","*","m")` |
| **비문자열 인수 처리** | 모든 데이터 타입 허용:<br>`=REGEXREPLACE(2024,24,25)`                                                                                                                                           | 비문자열 입력 시 `#VALUE!` 반환                                               |