array.insertAt()
Inserts a value at the specified position in the array. If the element is inserted before the end of the array, Lucee shifts the positions of all elements with a higher index to make room.
array.insertAt( position=number, value=any )
Returns: Array
| Argument | Description |
|---|---|
|
position
number,
required
|
edit
The numerical index in the array where the new element will be inserted. Must be less than or equal to the length of the array. Remember CFML arrays start at 1 not 0. |
|
value
any,
required
|
edit
value to insert |
Examples
editmyarray = ["one","two","three","four","five"];
res = myarray.insertat("3",3);
writeDump(res);
res = myarray.insertat("1","start");
writeDump(res);