arrayUnshift

This function adds one or more elements to the beginning of the original array and returns the length of the modified array.

arrayUnshift(array,object) → returns numeric

array.unshift(object)

Argument Reference

The original array to be added to.

The new object to be added.

Version 2021+ The full function was added in ACF 2021, but the member function appears to work in ACF 2018 (likely using Java).

ArrayPop(), ArrayShift(), And ArraySliceSafe() In Lucee CFML 5.3.6.61 - Blog post from Ben Nadel detailing new Array functions in Lucee.
LDEV-3137 - ACF2021 - add function ArrayUnShift - Lucee Bug Report to add ACF function to Lucee.

Add a new element to an array.

arr=[1,2,3];
newArrLen=arrayUnshift(arr,0);
writeOutput(newArrLen);

Expected Result: 4

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

arr=[1,2,3];
newArrLen=arr.unshift(0);
writeOutput(newArrLen);

Expected Result: 4

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.