arrayShift

Removes the first element from an array and returns the removed element. This method changes the length of the array. If used on an empty array, an exception will be thrown.

arrayShift(array) → returns any

Member Function Syntax

array.shift()

Argument Reference

array array
Required

An array of elements from which the first will be removed and returned.

Compatibility

Lucee:

Version 5.3.8+ Lucee allows an additional parameter, defaultValue of type any, that is returned if the array is empty.

Examples
Sample code invoking the arrayShift function

Example with simple values

Take an array of numbers and shift the first one off.

arr = [ 1, 2, 3 ];
el = arrayShift(arr);
writeOutput( el );

Expected Result: 1

Using a member function

This is the same example as above, but using a member function on the array instead of a standalone function.

arr = [ 1, 2, 3 ];
el = arr.shift();
writeOutput( el );