Click above to get retro games delivered to your door ever month!

 C_AGET()

 DESCRIPTION

 C_AGET() reads a specified element in the array and returns the
 numeric value stored there.  (Refer to Chapter 3 for a complete
 discussion about ClipOn arrays.)

 NOTES

 The numeric reference for the ClipOn array is a pointer to the
 array in memory.  Be careful not to change the value of this
 pointer, or the array will be unaccessible.

 SYNTAX

 C_AGET(array, element)

 PARAMETERS

 array (N) is the numeric reference variable for the ClipOn array.

 element (N) is the array element to retrieve and return the value.

 RETURNS

 C_AGET() returns the numeric value for the specified array element.

 EXAMPLES

 a1 = c_adeclare(10000)  && Declare array for 10,000 elements

 for i = 1 to 100        && Fill first 100 elements of array with
   c_aput(a1,i,i)        && numbers 1 through 100.
 next

 ? c_aget(a1,1)   --> 1       && Get values from array
 ? c_aget(a1,51)  --> 51
 ? c_aget(a1,100) --> 100
 ...
 c_arelease(a1)          && Release array