void cxDataRefDec(void *data)
subroutine cxDataRefDec(data) integer data
- Pointer to any reference counted IRIS Explorer data type.
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.cxDataRefInc(3E)
Last modified: Mon Nov 6 16:33:06 GMT 2000
[ Documentation Home ] © The Numerical Algorithms Group Ltd, Oxford UK. 1996