HELP
An object that allows you to change an
element of an array container.

USE
Use Set Values to modify elements of an array
of any type and size.  The new array is
generated only when the XEQ pin is activated.

You can connect several containers to the
inputs on the Set Values object:  the array
to be changed, the scalar data to be added,
and the indices into the array where in the
array to put the scalar data.

Input new values for the array and the
index of the element you wish to replace.
When all changes are done, activate the XEQ
pin.

LOCATION
Data ==> Access Array ==> Set Values

OPEN VIEW PARAMETERS
Num Dimensions - The number of dimensions in
the input array.  Num Dimensions must be an
integer (not an expression).  Minimum is 1.
Maximum is 10.  Default is 1.

NOTES
All arrays are zero-based; all indices for
arrays are zero based.

To initially create an array use the
Allocate Array ==> objects.

The open view of the Set Values object has
a field on it for the number of dimensions of
the array coming in.  This allows the object
to add or delete input pins to give you the
correct number of inputs for the indices
needed.  For example, if you change the
number of dimensions field to 2, the object
automatically adds an input for the second
index into the array.

The Set Values object begins with its
internal buffer cleared.  When the first
three data pins are activated, it starts to
operate.  It copies the array container on
the first input pin into its internal buffer,
making sure the number of dimensions match
the field on the open view.  It then takes
the second data input and makes sure it can
be converted to the same type as the input
array.  Then, HP VEE takes the value(s) on
the index input(s) and makes sure they are
within range of the array sizes.  Finally,
HP VEE places the data value in the array 
at the appropriate indices.  When the XEQ 
pin is activated, the Set Values box sends 
the modified array out the output pin.  The 
Set Values object clears its internal buffer.

The Set Values object always clears its
internal buffer at PreRun and at Activate
time.

SEE ALSO
Alloc Array, Build Data, Collector, Get
Values, ramp(numElem, from, thru), Set
Mappings, and Sliding Collector.
