# BYTES\_SUBSTRING

Возвращает подстроку входного значения, используя смещения в байтах представления байтов, закодированных в UTF-8. Частичные символы и недопустимые кодовые точки UTF-8 удаляются из результата.

## Синтаксис

Используйте следующий синтаксис, чтобы включить функцию `BYTES_SUBSTRING` в ваш запрос:

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

## Аргументы

Функция `BYTES_SUBSTRING` требует следующие аргументы:

* Входные данные `value` — это строка, над которой вы хотите выполнить функцию подстроки.
* `startIndex` начинается с `1` и включает первый символ в вашей строке.
* `endIndex` отсчитывает от первого символа в строке, а не от позиции `startIndex`.

| Имя | Тип | Описание | Значение по умолчанию |
| --- | --- | --- | --- |
| значение | string | Входное значение, над которым выполняется функция подстроки |  |
| startIndex | int | Включающий начальный индекс в байтах |  |
| endIndex | int | Исключительный конечный индекс в байтах |  |

## Возвращает

Возвращает значение `string`.

***

## Примеры

В следующем примере показано, как аргументы `startIndex` и `endIndex` влияют на значение `Output`. Здесь значение `endIndex` демонстрирует, что независимо от значения `startIndex`, `endIndex` работает с позиции **1** в строке, чтобы включить **10** символов.

| значение | начальный индекс | конечный индекс | Выходные данные |
| --- | --- | --- | --- |
| 'Привет, мир!' | 1 | 10 | `Привет, мир` |
| 'Привет, мир!' | 2 | 10 | `ello Worl` |
| '⻤Hello Wor⻤' | 2 | 10 | `Hello W` |
| '⻤Hello Wor⻤' | 1 | 10 | `⻤Hello W` |
| 'Привет' | 1 | 10 | `Привет` |