Ir para conteúdo principal Pular para conteúdo complementar

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.
  • startIndex começa em 1 e inclui o primeiro caractere em sua string.
  • endIndex conta a partir do primeiro caractere na string, não a partir da posição startIndex.
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`

Esta página ajudou?

Se você encontrar algum problema com esta página ou seu conteúdo – um erro de digitação, uma etapa ausente ou um erro técnico – avise-nos!