kcl library reference → std → array → pop

popFunction in std::array

Remove the last element from an array.

pop(@array: [any]): any

Returns a new array with the last element removed.

Arguments

Name	Type	Description	Required
`array`	`[any]`	The array to pop from. Must not be empty.	Yes

Returns

any - Any KCL value.

Examples

arr = [1, 2, 3, 4]
new_arr = pop(arr)
assert(
  new_arr[0],
  isEqualTo = 1,
  tolerance = 0.00001,
  error = "1 is the first element of the array",
)
assert(
  new_arr[1],
  isEqualTo = 2,
  tolerance = 0.00001,
  error = "2 is the second element of the array",
)
assert(
  new_arr[2],
  isEqualTo = 3,
  tolerance = 0.00001,
  error = "3 is the third element of the array",
)

Rendered example of pop 0