翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

`locate` は、指定された部分文字列を別の文字列内で探し、文字列内での、部分文字列の先頭文字までの文字数を返します。この関数は、サブ文字列が見つからない場合は 0 を返します。通常は 1 以上を返します。

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

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

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

 *expression*   
expression は文字列である必要があります。文字列データ型を使用しているフィールドの名前、**'12 Main Street'** のようなリテラル値、または文字列を出力する別の関数の呼び出しを使用できます。

 *substring*   
*expression* の中で見つける一連の文字。substring は *expression* の中で複数回出現することがあります。

 *start*   
(オプション) *substring* が複数回出現する場合は、*start* を使用して、この関数が部分文字列を探し始める、文字列内の位置を特定します。たとえば、部分文字列の 2 番目の出現を見つける際に、通常はそれが文字列の先頭の 10 文字以降に出現すると考えられるとします。この場合は、*start* の値に 10 を指定します。通常これは、1 から開始されます。

## 戻り型
<a name="locate-function-return-type"></a>

整数

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

次の例では、文字列の中での部分文字列 'and' の最初の出現位置に関する情報を返しています。

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

次の値が返されます。

```
3
```

次の例では、文字列の 4 文字目以降での部分文字列 'and' の最初の出現位置に関する情報を返しています。

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

次の値が返されます。

```
9
```