insert

Summary

Inserts an element/sequence at specified position in an array.

Usage

input|insert( offset, element1 [, element2 [, ... ] ] )

Parameters

Name	Type	Description	Required
offset	integer	The offset where the element(s) should be inserted at.	Yes.
element1	any	An element that should be inserted into the existing array.	Yes.
element2	any	Another element that should be inserted into the existing array.	No.

Returns

An array containing a combination of the original array and the inserted elements.

Description

This operator inserts an element or a sequence of elements at a specified position within the input. The resulting array will be returned (original array with the inserted values).

Examples

Example 1

{array( 1, 2, 5 )|insert( 2, 3, 4 )}

The following array will be returned: ( 1, 2, 3, 4, 5 ).