# STRPOS

返回给定子字符串在字符串中首次出现的起始位置。

## 语法

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

## 参数

#### STRING

类型： `string`

要搜索的字符序列。

#### SUBSTRING

类型：`string`

要搜索的子字符串。

## 返回

类型：`bigint`

返回 `STRING` 中 `SUBSTRING` 的第一个实例的起始位置。

位置从 `1` 开始。如果未找到实例，则返回 `0`。

***

## 示例

| STRING | SUBSTRING | 输出 |
| --- | --- | --- |
| 所有幸福的家庭都相似 | 全部 | 0 |
| 所有幸福的家庭都相似 | 全部 | 1 |
| 所有幸福的家庭都相似 | 是 | 20 |
| 所有幸福的家庭都相似 | `''` | 1 |
| `''` | `''` | 1 |
| `''` | 单词 | 0 |
| `null` | 单词 | `null` |