

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Locate
<a name="locate-function"></a>

`locate` localise une sous-chaîne que vous spécifiez dans une autre chaîne et renvoie le nombre de caractères jusqu’au premier caractère de la sous-chaîne. La fonction renvoie 0 si elle ne trouve pas la sous-chaîne. La fonction est basée sur 1.

## Syntaxe
<a name="locate-function-syntax"></a>

```
locate(expression, substring, start)
```

## Arguments
<a name="locate-function-arguments"></a>

 *expression*   
L’expression doit être une chaîne. Il peut s’agir du nom d’un champ qui utilise le type de données de chaîne, d’une valeur littérale comme **'12 Main Street'** ou d’un appel à une autre fonction qui renvoie une chaîne.

 *substring*   
Jeu de caractères dans l’*expression* que vous souhaitez rechercher. La sous-chaîne peut être contenue une ou plusieurs fois dans l’*expression*.

 *début*   
(Facultatif) Si *substring* se produit plus d’une fois, utilisez *start* pour identifier dans la chaîne l’emplacement où la fonction doit commencer à chercher la sous-chaîne. Par exemple, imaginons que vous voulez trouver le deuxième exemple d’une sous-chaîne et que vous pensez qu’il se produit généralement après les 10 premiers caractères. Vous devez spécifier une valeur *start* de 10. Elle doit commencer à 1.

## Type de retour
<a name="locate-function-return-type"></a>

Entier

## Exemples
<a name="locate-function-example"></a>

L’exemple suivant renvoie des informations sur l’emplacement où la première occurrence de la sous-chaîne « and » apparaît dans une chaîne.

```
locate('1 and 2 and 3 and 4', 'and')
```

La valeur suivante est renvoyée.

```
3
```

L’exemple suivant renvoie des informations sur l’emplacement de la première occurrence de la sous-chaîne « and » dans une chaîne après le quatrième caractère.

```
locate('1 and 2 and 3 and 4', 'and', 4)
```

La valeur suivante est renvoyée.

```
9
```