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.

Return value

True, on successful completion.

Category

Array functions

Syntax

ArraySet(array, start_pos, end_pos, value) 

See also

ArrayNew

History

New in ColdFusion MX: 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">
...

Comments