---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - en/function-ref/ARR_STR
  - ru/function-ref/ARR_STR
  - href: en/function-ref/ARR_STR.md
    type: text/markdown
    title: Markdown version
csp:
  - script-src:
      - https://mc.yandex.ru
    img-src:
      - https://mc.yandex.ru
    connect-src:
      - https://mc.yandex.ru
      - wss://mc.yandex.ru
    child-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-src:
      - 'blob:'
      - https://mc.yandex.ru
    frame-ancestors:
      - 'blob:'
      - https://mc.yandex.ru
canonical: en/function-ref/ARR_STR.html
editable: false
vcsPath: en/function-ref/ARR_STR.md
---

# ARR_STR



#### Syntax {#syntax}


```
ARR_STR( array [ , delimiter [ , null_str ] ] )
```

#### Description {#description}
Concatenates elements of the array `array` using `delimiter` as a delimiter (comma by default) and `null_str` as a `NULL` string (`NULL` items are skipped by default).

See also [STR](STR.md)

**Argument types:**
- `array` — `Array of fractional numbers | Array of integers | Array of strings`
- `delimiter` — `String`
- `null_str` — `String`


**Return type**: `String`

{% note info %}

Only constant values are accepted for the arguments (`delimiter`, `null_str`).

{% endnote %}


#### Examples {#examples}

```
ARR_STR(ARRAY(1, 2, NULL, 4)) = 1,2,4
```

```
ARR_STR(ARRAY(1, 2, NULL, 4), ';') = 1;2;4
```

```
ARR_STR(ARRAY(1, 2, NULL, 4), ';', '*') = 1;2;*;4
```

```
ARR_STR(ARRAY('a', 'b', '', NULL), ';', '*') = a;b;;*
```


#### Data source support {#data-source-support}

`ClickHouse 21.8`, `Files`, `Google Sheets`, `PostgreSQL 9.3`, `Trino`, `Yandex Documents`.