CONCAT(...)
All functions > STRING > CONCAT(...)
Joins an array of VARCHAR values into one string with no delimiter (array form of CONCAT).
Signatures
Returns: Concatenated string
CONCAT_FN(strings: ARRAY(VARCHAR)) → VARCHAR sql
| Parameter | Type | Required | Description |
|---|---|---|---|
strings | ARRAY(VARCHAR) | Yes | Strings to concatenate in order |
Notes
- Equivalent to variadic
CONCAT(...)after the parser bundles arguments into an array - Each element must be
VARCHAR; for nullable pieces useNULL(VARCHAR)orCOALESCE NULLlist elements are omitted (seeCONCAToperator notes)
Related operators
Examples
CONCAT_FN(...)
FeatureQL
SELECT
-- Array of pieces
f1 := CONCAT_FN(ARRAY('A', 'B', 'C')),
-- Spaces as separate elements
f2 := CONCAT_FN(ARRAY('Hello', ' ', 'World'))
;Result
| f1 VARCHAR | f2 VARCHAR |
|---|---|
| ABC | Hello World |
.CONCAT(...) — chained
FeatureQL
SELECT
-- Chained variadic call on a VARCHAR base
f1 := 'A'.CONCAT('B', 'C')
;Result
| f1 VARCHAR |
|---|
| ABC |
Edge cases
FeatureQL
SELECT
-- Single element
f1 := CONCAT_FN(ARRAY('One')),
-- NULL propagates
f2 := CONCAT_FN(ARRAY('A', NULL(VARCHAR), 'B'))
;Result
| f1 VARCHAR | f2 VARCHAR |
|---|---|
| One | NULL |