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
f1 := CONCAT_FN(ARRAY['A', 'B', 'C']), -- Array of pieces
f2 := CONCAT_FN(ARRAY['Hello', ' ', 'World']) -- Spaces as separate elements
;Result
| f1 VARCHAR | f2 VARCHAR |
|---|---|
| ABC | Hello World |
.CONCAT(...) — chained
FeatureQL
SELECT
f1 := 'A'.CONCAT('B', 'C') -- Chained variadic call on a VARCHAR base
;Result
| f1 VARCHAR |
|---|
| ABC |
Edge cases
FeatureQL
SELECT
f1 := CONCAT_FN(ARRAY['One']), -- Single element
f2 := CONCAT_FN(ARRAY['A', NULL(VARCHAR), 'B']) -- NULL propagates
;Result
| f1 VARCHAR | f2 VARCHAR |
|---|---|
| One | NULL |