4.12 The OLE-AUTOMATION module

<ole-array>

Sealed concrete primary class

Summary

This class allows you to use the Dylan array protocol on data that is actually allocated as a C SAFEARRAY structure.

Superclasses

<array>  <LPSAFEARRAY>

Description

This class allows you to use the Dylan array protocol on data that is actually allocated as a C SAFEARRAY structure.

Arrays received by Dylan from an OLE Automation call will appear as an <ole-vector> if they are one-dimensional, and otherwise as instances of <ole-array>.

Note: The Win32 OLE/COM libraries allocate memory on the C heap for these arrays. This means that the memory is not automatically reclaimed by the Functional Developer garbage collector. You must call the function destroy on an <ole-array> when you are finished with it.

Note: The dimensions in a SAFEARRAY specify both a lower and upper bound for the index, but since Dylan does not support alternate lower bounds, index 0 always corresponds to the first element when viewed as a Dylan array.