modeling-app/docs/kcl/push.md

title, excerpt, layout

title	excerpt	layout
push	Append an element to the end of an array.	manual

Append an element to the end of an array.

Returns a new array with the element appended.

push(
  array: [KclValue],
  elem: KclValue,
): KclValue

Arguments

Name	Type	Description	Required
array	[KclValue]		Yes
elem	KclValue	Any KCL value.	Yes

Returns

KclValue - Any KCL value.

Examples

arr = [1, 2, 3]
new_arr = push(arr, 4)
assert(
  new_arr[3],
  isEqualTo = 4,
  tolerance = 0.1,
  error = "4 was added to the end of the array",
)