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],
  item: KclValue,
): KclValue

Arguments

Name	Type	Description	Required
array	[KclValue]	The array which you're adding a new item to.	Yes
item	KclValue	The new item to add to the array	Yes

Returns

KclValue - Any KCL value.

Examples

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