ArraySet |
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
True, on successful completion.
Category
Array functions
Function syntax
    ArraySet(array, start_pos, end_pos, value)
See also
ArrayNew
History
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
    <h3>ArraySet Example</h3>

    <!--- Make an array --->
    <cfset MyNewArray = ArrayNew(1)>
    <!--- ArrayToList does not function properly if the Array has not been
    initialized
    with ArraySet --->
    <cfset temp = ArraySet(MyNewArray, 1,6, "Initial Value")>

    <!--- set some elements --->
    <cfset MyNewArray[1] = "Sample Value">
    <cfset MyNewArray[3] = "43">
    <cfset MyNewArray[6] = "Another Value">
    ...

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.