# STRPOS

Retorna a posição inicial da primeira instância de uma determinada substring dentro de uma string.

## Sintaxe

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

## Argumentos

#### STRING

Tipo: `string`

Uma sequência de caracteres a serem pesquisados.

#### SUBSTRING

Tipo: `string`

A substring a ser pesquisada.

## Retorna

Tipo: `bigint`

Retorna a posição inicial da primeira instância de `SUBSTRING` em `STRING`.

As posições começam a partir de `1`. Se nenhuma instância for encontrada, `0` será retornado.

***

## Exemplos

| STRING | SUBSTRING | Saída |
| --- | --- | --- |
| All happy families are alike | tudo | 0 |
| All happy families are alike | Tudo | 1 |
| All happy families are alike | are | 20 |
| All happy families are alike | `''` | 1 |
| `''` | `''` | 1 |
| `''` | word | 0 |
| `null` | word | `null` |