Locate

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