ARRset_trace

Synopsis

int      ARRset_trace (void *array_pointer, int flag)

Description

If the flag argument is non-zero, the array specified by array_pointer will be marked for tracing. When an array is traced, AVS/Express will print out a message every time the array has its reference count incremented, its reference count decremented, the array is resize, or the array is freed.

If the flag argument is zero, turns off tracing for the array. Returns -1 and prints out a error message if the array is not being managed by the ARR package, returns 1 otherwise.

arguments

array_pointer

The address of the array.

flag

Determines whether to turn tracing on or off.