Description

In a one-dimensional array, sets the elements in a specified index range to a value. Useful for initializing an array after a call to ArrayNew.

Returns

Returns the updated array.

Category

Array functions

Function syntax

ArraySet(array, start_pos, end_pos, value)

See also

ArrayNewPopulating arrays with data in the Developing ColdFusion Applications

History

ColdFusion (2018 release): Returns the updated array.

ColdFusion MX: Changed behavior: This function can be used on XML objects.

Parameters

Parameter

Description

array

Name of an array.

start_pos

Starting index position of range to set.

end_pos

Ending index position of range to set. If this value is greater than array length, ColdFusion adds elements to array.

value

Value to which to set each element in the range.

Example

<cfscript>
    myArray=ArrayNew(1)
    temp = ArraySet(myArray, 1,6, "Initial Value")
    writeDump(myArray)
   // Set some values
    myArray[1] = "Sample Value"
    myArray[3] = "43" 
    myArray[6] = "Another Value"
    writeOutput("Updated array")
    writeDump(myArray)
</cfscript>

Output

ArraySet

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy