# TEXTBEFORE

## Content

이 함수는 주어진 문자나 문자열 앞에 나오는 텍스트를 반환합니다.

## 구문

`=TEXTBEFORE(text,delimiter,[instance_num], [match_mode], [match_end], [if_not_found])`

## 인수

이 함수는 다음 인수를 가집니다:

| 인수               | 설명                                                                                                                                                          |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *text*           | 검색 대상이 되는 텍스트입니다. 와일드카드 문자는 허용되지 않습니다. 텍스트가 빈 문자열인 경우 빈 텍스트를 반환합니다.                                                                                         |
| *delimiter*      | 텍스트 추출 기준이 되는 구분 문자입니다.                                                                                                                                     |
| *instance\_num*  | \[선택 사항] 텍스트를 추출할 구분 문자의 발생 위치입니다. 기본값은 1입니다. 음수일 경우 뒤에서부터 검색합니다.                                                                                           |
| *match\_mode*    | \[선택 사항] 텍스트 검색 시 대소문자 구분 여부를 결정합니다. 기본값은 대소문자 구분입니다. 다음 중 하나를 입력할 수 있습니다:<ul><li>**0**      대소문자 구분</li><li>**1**      대소문자 무시</li></ul>                   |
| *match\_end*     | \[선택 사항] 텍스트 끝을 구분 문자로 처리할지 여부입니다. 기본값은 정확히 일치입니다. 다음 중 하나를 입력할 수 있습니다:<ul><li>**0**      텍스트 끝과 구분 문자 일치하지 않음</li><li>**1**      텍스트 끝과 구분 문자 일치</li></ul> |
| *if\_not\_found* | \[선택 사항] 일치하는 항목이 없을 경우 반환할 값입니다. 기본값은 #N/A입니다.                                                                                                             |

## 데이터 형식

문자열 데이터를 반환합니다.

## 참고

TEXTBEFORE 함수는 빈 구분 문자 값을 사용해 검색할 때 즉시 일치합니다. 앞에서부터 검색할 경우(instance\_num이 양수) 빈 텍스트를 반환하며, 뒤에서부터 검색할 경우(instance\_num이 음수) 전체 텍스트를 반환합니다.

## 예제

```JavaScript
=TEXTBEFORE("Little red Riding Hood's red hood","red") // 결과는 "Little"
=TEXTBEFORE("Little red Riding Hood's red hood","red", 2) // 결과는 "Little red Riding Hood's"
=TEXTBEFORE("Little red Riding Hood's red hood","Red") // 결과는 #N/A
=TEXTBEFORE("Little red Riding Hood's red hood","Red", ,1) // 결과는 "Little"
```