merge
Summary
Merges input and passed arrays into one array.
Usage
input|merge( array1 [, array2 [, ... ] ] )
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
| array1 | array | Array to be merged with the input array. | Yes. |
| array2 | array | Another array to be merge with the input array. | No. |
Returns
New array containing all arrays merged.
Description
This operator will merge the input array with all arrays passed as parameters. The resulting array will be returned.
Examples
Example 1
{array( 1, 2 )|merge( array( 3, 4 ), array( 5, 6, 7 ) )}The following array will be returned: ( 1, 2, 3, 4, 5, 6, 7 ).
Contributors
- Balazs Halasy Updated
- Massimiliano Bariola Commenter
Comments (2 historical)
Written by readers of the earlier documentation sites, kept as they were.
Hash merging
Massimiliano Bariola ·
This function also works for hashes.
def $a = hash('a', 'b') def $b = hash('c', 'd') def $c = $a|merge($b)will make
Very useful for growing hashes iteratively. However, bear in bind that hashes cannot have numbers as keys! I lost an hour trying to figure out why my
didn't work. :-)
foreach containing a merge
Massimiliano Bariola ·
.. of course my foreach contained a merge.