# BYTES\_SUBSTRING

UTF-8로 인코딩된 바이트 표현의 바이트 단위 오프셋을 사용하여 입력 값의 부분 문자열을 반환합니다. 부분 문자와 잘못된 UTF-8 코드 포인트는 결과에서 제거됩니다.

## 문법

쿼리에 `BYTES_SUBSTRING` 함수를 포함하려면 다음 구문을 사용합니다.

```
BYTES_SUBSTRING(value, startIndex, endIndex)
```

## 인수

`BYTES_SUBSTRING` 함수에는 다음 인수가 필요합니다.

* `value` input은 부분 문자열 함수를 수행하려는 문자열입니다.
* `startIndex`은(는) `1`에서 시작하며 문자열의 첫 번째 문자를 포함합니다.
* `endIndex`은(는) `startIndex` 위치가 아닌 문자열의 첫 번째 문자부터 계산합니다.

| 이름 | 유형 | 설명 | 기본값 |
| --- | --- | --- | --- |
| 값 | 문자열 | 부분 문자열 함수를 수행할 입력 값 |  |
| startIndex | int | 바이트 단위의 포함 시작 인덱스 |  |
| endIndex | int | 바이트 단위의 배타적 끝 인덱스 |  |

## 반환합니다.

`string` 값을 반환합니다.

***

## 예

다음 예에서는 `startIndex` 및 `endIndex` 인수가 `Output` 값에 어떤 영향을 미치는지 보여줍니다. 여기서 `endIndex` 값은 `startIndex` 값에 관계없이 `endIndex`가 문자열의 **1** 위치부터 작동하여 **10**개의 문자를 포함한다는 것을 보여줍니다.

| 값 | startIndex | endIndex | 출력 |
| --- | --- | --- | --- |
| '안녕하세요!' | 1 | 10 | `안녕하세요!` |
| '안녕하세요!' | 2 | 10 | `ello Worl` |
| '⻤Hello Wor⻤' | 2 | 10 | `Hello W` |
| '⻤Hello Wor⻤' | 1 | 10 | `⻤Hello W` |
| '안녕하세요' | 1 | 10 | `안녕하세요` |