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
`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
```