As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
locate
localiza uma substring que você especifica dentro de outra string e retorna o número de caracteres até o primeiro caractere na substring. A função retorna 0 se não encontrar a substring. A função é baseada em 1.
Sintaxe
locate(
expression
,substring
,start
)
Argumentos
- expressão
-
A expressão deve ser uma string. Isso pode ser o nome de um campo que usa o tipo de dados de string, um valor literal, como
'12 Main Street'
, ou uma chamada para outra função que gere uma string. - substring
-
O conjunto de caracteres na expressão que você deseja localizar. A substring pode ocorrer uma ou mais vezes na expressão.
- start
-
(Opcional) Se a substring ocorrer mais de uma vez, use start para identificar onde na string a função deve começar a procurar pela substring. Por exemplo, suponha que você deseja encontrar o segundo exemplo de uma sub-sequência de caracteres e acha que ele ocorre normalmente após os primeiros 10 caracteres. Especifique um valor inicial de 10. Deve começar a partir de 1.
Tipo de retorno
Inteiro
Exemplos
O exemplo a seguir retorna informações sobre onde a primeira ocorrência da substring 'and' aparece na string.
locate('1 and 2 and 3 and 4', 'and')
O valor a seguir é retornado.
3
O exemplo a seguir retorna informações sobre onde a primeira ocorrência da substring 'and' aparece na string após o quarto caractere.
locate('1 and 2 and 3 and 4', 'and', 4)
O valor a seguir é retornado.
9