# BYTES\_SUBSTRING

Restituisce una sottostringa del valore di input, utilizzando gli offset in byte della rappresentazione di byte codificata in UTF-8. I caratteri parziali e i punti di codice UTF-8 non validi vengono rimossi dal risultato.

## Sintassi

Utilizza la seguente sintassi per includere la `BYTES_SUBSTRING` funzione nella tua query:

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

## Argomenti

La funzione `BYTES_SUBSTRING` richiede i seguenti argomenti:

* L'input `value` è la stringa su cui si desidera eseguire la funzione di sottostringa.
* `startIndex` inizia da `1` e include il primo carattere della stringa.
* `endIndex` conta dal primo carattere della stringa, non dalla posizione `startIndex`.

| Nome | Tipo | Descrizione | Valore predefinito |
| --- | --- | --- | --- |
| valore | stringa | Il valore di input su cui eseguire la funzione di sottostringa |  |
| startIndex | int | L'indice di inizio inclusivo in byte |  |
| endIndex | int | L'indice di fine esclusivo in byte |  |

## Restituisce

Restituisce un valore `string`.

***

## Esempi

L'esempio seguente mostra come gli argomenti `startIndex` e `endIndex` influenzano il valore `Output`. Qui, il valore `endIndex` dimostra che, indipendentemente dal valore `startIndex`, `endIndex` funziona dalla posizione **1** nella stringa per includere **10** caratteri.

| valore | startIndex | endIndex | Output |
| --- | --- | --- | --- |
| 'Ciao mondo' | 1 | 10 | `Ciao mond` |
| 'Ciao mondo' | 2 | 10 | `ello Worl` |
| '⻤Hello Wor⻤' | 2 | 10 | `Hello W` |
| '⻤Hello Wor⻤' | 1 | 10 | `⻤Hello W` |
| 'Ciao' | 1 | 10 | `Ciao` |