Skip to the content
Documentation

merge

No ratings yet

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

Comments (2 historical)

Written by readers of the earlier documentation sites, kept as they were.

  1. 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

    $c['a'] = 'b'
    $c['c'] = 'd'

    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

    foreach

    didn't work. :-)

  2. foreach containing a merge

    Massimiliano Bariola ·

    .. of course my foreach contained a merge.

Comments

Add a comment

Comments are read by a moderator before they appear.