Function
Frees space allocated in an Array beyond that required for the number of items in the Array.
Syntax
#include <dx/dx.h>
Array DXTrim(Array a)
Functional Details
Under some circumstances, more space than is necessary to hold the items added to a may have been allocated. This can happen if you have called DXAllocateArray. It can also happen when you call DXAddArrayData. This extra space can be freed by calling DXTrim. The DXEndField routine automatically calls DXTrim on all components of a Field.
Return Value
Returns a or returns NULL and sets an error code.
See Also
DXAddArrayData, DXAllocateArray, DXEndField