Parameter
Last updated on
Apr 27, 2021
Description
This method adds one or more elements to the beginning of an array and returns the new length of the array.
Returns
The new size of the array.
Syntax
ArrayUnshift(array,object)
Member function
array.unshift(item)
History
ColdFusion (2021 release): Added this function.
Parameters
|
|
Required/Optional |
Description |
|---|---|---|
|
array |
Required |
The array where an object is to be added. |
|
object |
Required |
The object to add at the beginning of the array. |
Example
Example 1
<cfscript>
arr=["Mar","Apr","May","Jun","Jul"]
unshifted=ArrayUnshift(arr,"Jan")
WriteOutput(unshifted) // Returns 6
</cfscript>
Example 2
<cfscript>
arr=["Mar","Apr","May","Jun","Jul"]
// List as first element
unshifted=ArrayUnshift(arr,"Jan,Feb") // Returns 6
WriteOutput(unshifted)
</cfscript>
Example 3
<cfscript>
arr=["Mar","Apr","May","Jun","Jul"]
// Array as first element
unshifted=ArrayUnshift(arr,["Jan,Feb"])
WriteOutput(unshifted) // Returns 6
</cfscript>
Example 4
<cfscript>
arr=["Mar","Apr","May","Jun","Jul"]
// Struct as first element
elem={"id":101,"name":"John"}
unshifted=ArrayUnshift(arr,elem)
WriteOutput(unshifted) // Returns 6
</cfscript>
Adobe MAX
The Creativity Conference
Oct 14–16 Miami Beach and online
Adobe MAX
The Creativity Conference
Oct 14–16 Miami Beach and online