Combination functions
Reference documentation for Expressif functions in the array/combination scope.
| Name | Overview |
|---|---|
join | Emits a pair for every matching left and right value, omitting left values without a match. Array right-hand values are grouped by key before lookup. |
join-full | Emits every matching pair and preserves unmatched values from both sides with #null in the absent side. Array right-hand values are grouped by key before lookup. Null keys match null keys; composite keys use structural equality and duplicate values produce Cartesian combinations. Null or invalid collection inputs return null. |
join-left | Emits every matching pair and preserves unmatched left values with #null in the absent side. Array right-hand values are grouped by key before lookup. Null keys match null keys; composite keys use structural equality and duplicate values produce Cartesian combinations. Null or invalid collection inputs return null. |
join-right | Emits every matching pair and preserves unmatched right values with #null in the absent side. Array right-hand values are grouped by key before lookup. Null keys match null keys; composite keys use structural equality and duplicate values produce Cartesian combinations. Null or invalid collection inputs return null. |
zip | Combines corresponding values from the input array and a second array into two-element tuples, stopping when either array is exhausted. Returns null when either value cannot be evaluated as an array. |
zip-cycle | Combines values from two arrays into two-element tuples until the longer array is exhausted, cycling each non-empty shorter array from its beginning. Returns an empty array when both inputs are empty and null when exactly one input is empty or either value cannot be evaluated as an array. |
zip-padded | Combines corresponding values from the input array and a second array into two-element tuples until both arrays are exhausted, using null for a missing value. Returns null when either value cannot be evaluated as an array. |
zip-strict | Combines corresponding values from equally sized input and parameter arrays into two-element tuples. Returns null when the arrays have different lengths or either value cannot be evaluated as an array. |