NAME

C SPECIFICATION

#include <cx/DataOps.h>

void cxDataRefDec(void *data)

FORTRAN SPECIFICATION

subroutine cxDataRefDec(data)
integer data

PARAMETERS

data

Pointer to any reference counted IRIS Explorer data type.

DESCRIPTION

If, when data is deleted, it contains references to other IRIS Explorer data types (for instance, a cxLattice may contain pointers to a cxData or cxCoord), the reference counts of the data it contains are also decremented. The contained data is not deleted directly, this allows one cxData to be shared by multiple instances of cxLattice.

A module does not normally need to call cxDataRefDec. The reference counts of the data present on input or output ports are managed automatically when the module sends or receives data. If the module creates a temporary IRIS Explorer data type that is not output to another module, it must call cxDataRefDec to delete the data.

See Appendix B of the IRIS Explorer Module Writer's Guide for more information on reference counting.

SEE ALSO