Syntax

Point.GetRawArray array [, startElement [, endElement [, fromElement]]]

Description

To retrieve an array points value directly into a Basic array bypassing Engineering Units Conversion.

Comments

There are several rules to keep in mind.

If the array is undimensioned, the array will be re-dimensioned to the same size as the point.

If the array is dimensioned smaller than the point, only that many elements will be copied into the array.

If the array is larger than the point, all elements of the point are copied, and the rest of the array is left as is.

If the startElement is specified, the function will start copying data into the array at this element and will continue until the end of the point is reached or the array is full whichever occurs first.

If the endElement is specified, the function will stop copying data into the array after populating this element or when the end of the point is reached.

If the fromElement is specified, the values copied into the array start at this element in the point array and continue as described above.

Parameter

Description

array

Array. A dimensioned or un-dimensioned Basic Array to which the point data will be copied.

startElement

Integer. (optional) The first array element to which data will be copied.

endElement

Integer. (optional) The last array element to which data will be copied.

fromElement

Integer. (optional) The first point element from which data is to be copied.

Example

sub main()

   Dim rawValues() as integer

   Dim p as new Point          ' Declare the point object

   p.Id ="ARRAY_POINT"        ' Set the Id

   p.Get                      ' Get value from CIMPLICITY

   p.GetRawArray rawValues     ' Copy the object into values

end sub

See Also

Point.GetArray (method); Point.SetRawArray (method); Point.HasEuConv (property/read); Point.Value (property, read/write); Point.RawValue (property, read/write).

CIMPLICITY Extensions to Basic