BYTES_SUBSTRING
Retorna uma substring do valor de entrada, usando os deslocamentos em bytes da representação de byte codificada em UTF-8. Caracteres parciais e pontos de código UTF-8 inválidos são removidos do resultado.
Sintaxe
Use a seguinte sintaxe para incluir a função BYTES_SUBSTRING em sua consulta:
BYTES_SUBSTRING(value, startIndex, endIndex)
Argumentos
A função BYTES_SUBSTRING requer os seguintes argumentos:
- A entrada
valueé a string sobre a qual você deseja executar a função de substring. startIndexcomeça em1e inclui o primeiro caractere em sua string.endIndexconta a partir do primeiro caractere na string, não a partir da posiçãostartIndex.
| Nome | Tipo | Descrição | Valor padrão |
|---|---|---|---|
| valor | caractere | O valor de entrada para executar a função de substring | |
| startIndex | int | O índice inicial inclusivo em bytes | |
| endIndex | int | O índice final exclusivo em bytes |
Retorna
Retorna um valor string.
Exemplos
O exemplo a seguir mostra como os argumentos startIndex e endIndex afetam o valor Output. Aqui, o valor endIndex demonstra que, independentemente do valor startIndex, o endIndex funciona a partir da posição 1 na string para incluir 10 caracteres.
| valor | startIndex | endIndex | Saída |
|---|---|---|---|
| 'Hello World' | 1 | 10 | `Hello Worl` |
| 'Hello World' | 2 | 10 | `ello Worl` |
| '⻤Hello Wor⻤' | 2 | 10 | `Hello W` |
| '⻤Hello Wor⻤' | 1 | 10 | `⻤Hello W` |
| 'Hello' | 1 | 10 | `Hello` |