# SUBSTRING

Extrai uma substring iniciando de um ponto especificado dentro da string fornecida.

Este é um alias para a função [`SUBSTR`](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/TransformationFunctions/string/substr.htm).

## Sintaxe

```
SUBSTRING(STRING, START [, LENGTH])
```

## Argumentos

#### STRING

Tipo: `string`

A string da qual extrair uma substring.

#### START

Tipo: `integer`

O índice inicial da substring.

As posições começam com `1`. Uma posição inicial negativa é interpretada como sendo relativa ao final da cadeia de caracteres.

#### LENGTH

Tipo: `integer`

(Opcional) O comprimento da substring.

Se omitido, o restante da cadeia de caracteres após a posição inicial `START` será retornado.

## Retorna

Tipo: `string`

Retorna uma substring de `STRING` de comprimento `LENGTH` a partir da posição inicial `START`.

***

## Exemplos

| STRING | START | LENGTH | Saída |
| --- | --- | --- | --- |
| Hello World | 1 | 5 | Hello |
| Hello World | 0 | 4 | `''` |
| Hello World | -5 | 5 | Mundo |
| Hello World | 12 | 4 | `''` |
| Hello World | -12 | 4 | `''` |
| Hello World | 2 | 3 | ell |
| Hello World | 3 | -2 | `''` |
| Hello World | 2 | 14 | ello World |
| Hello World | 2 |  | ello World |
| Hello World | -3 | 2 | rl |
| `null` | -3 | 2 | `null` |