setElement



Function: setElement()

Sets the value of an item at a specified index position within an array. 

Syntax

  1. setElement(array, item, value)
ArgumentTypeDescription
arrayArray or RecordsetThe array or recordset to evaluate
itemIntegerThe position of the item in array to be returned.
valueIntegerThe value the item in array will be set to.

If item is not a valid entry, this function will cause the script to generate and error and stop processing.

Examples

setElement(["Red", "Green", "Blue"], 2, "Red")

Sets the 2nd element of the array, "Green", to be "Red", i.e.

["Red", "Red", "Blue"]

Please note that setElement() cannot be used on recordsets, only arrays. 

See Also