# SUBSTRING

Wyodrębnia podciąg zaczynając od określonego punktu w podanym ciągu znaków.

Jest to alias dla funkcji [`SUBSTR`](https://help.qlik.com/pl-PL/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Lakehouse/TransformationFunctions/string/substr.htm).

## Składnia

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

## Argumenty

#### STRING

Typ: `string`

Ciąg znaków, z którego ma zostać wyodrębniony podciąg.

#### START

Typ: `integer`

Indeks początkowy podciągu.

Pozycje zaczynają się od `1`. Ujemna pozycja początkowa jest interpretowana jako względna względem końca ciągu znaków.

#### LENGTH

Typ: `integer`

(Opcjonalnie) Długość podłańcucha.

Jeśli pominięto, zwracana jest pozostała część ciągu po pozycji początkowej `START`.

## Zwraca wartość

Typ: `string`

Zwraca podciąg z `STRING` o długości `LENGTH` od pozycji początkowej `START`.

***

## Przykłady

| STRING | Początek | Długość | Dane wyjściowe |
| --- | --- | --- | --- |
| Witaj świecie | 1 | 5 | Witaj |
| Witaj świecie | 0 | 4 | `''` |
| Witaj świecie | -5 | 5 | Świat |
| Witaj świecie | 12 | 4 | `''` |
| Witaj świecie | -12 | 4 | `''` |
| Witaj świecie | 2 | 3 | ell |
| Witaj świecie | 3 | -2 | `''` |
| Witaj świecie | 2 | 14 | Witaj świecie |
| Witaj świecie | 2 |  | ello World |
| Hello World | -3 | 2 | rl |
| `null` | -3 | 2 | `null` |