append

TABLE OF CONTENTS

• Definition
• Parameters
• Returns
• Examples

Add items to the end of an array

Definition

array[any] append(array[any] $array, any *$items)

Appends *$items to the end of $array and returns the resulting array.

Parameters

array $array

The array to be extended.

any *$items

Any amount of arguments of any type to be added to the end of the $array.

Returns

array

The array with $items appended to the end of $array.

Examples

{
  a: append(`[]`,`0`),
  b: append(`[0]`,`"abc"`),
  c: append(`[0, "abc"]`,`null`),
  d: append(`[0, "abc", null]`,`[true, false]`),
  e: append(`[0, "abc", null]`,`true`,`false`),
  f: append(`1`,`[]`)              // Error
}

{
  "a": [0],
  "b": [0, "abc"],
  "c": [0, "abc", null],
  "d": [0, "abc", null, [true, false]],
  "e": [0, "abc", null, true, false]
}