# STRPOS

傳回字串中指定子字串第一個執行個體的起始位置。

## 語法

```
STRPOS(STRING, SUBSTRING)
```

## 引數

#### STRING

類型：`string`

要搜尋的字元序列。

#### SUBSTRING

類型： `string`

要搜尋的子字串。

## 傳回

類型： `bigint`

傳回 `STRING` 中 `SUBSTRING` 的第一個執行個體的起始位置。

位置從 `1` 開始。如果找不到執行個體，則會傳回 `0`。

***

## 範例

| 字串 | SUBSTRING | 輸出 |
| --- | --- | --- |
| 所有幸福的家庭都相似 | 全部 | 0 |
| 所有幸福的家庭都相似 | 全部 | 1 |
| 所有幸福的家庭都相似 | 是 | 20 |
| 所有幸福的家庭都相似 | `''` | 1 |
| `''` | `''` | 1 |
| `''` | 單字 | 0 |
| `null` | 單字 | `null` |