NAME
cxDataRefInc
- increment reference count of IRIS Explorer data type
C SPECIFICATION
#include <cx/DataOps.h>
void cxDataRefInc(void *data)
FORTRAN SPECIFICATION
subroutine cxDataRefInc(data)
integer data
PARAMETERS
-
data
-
Pointer to any reference counted IRIS Explorer data type.
DESCRIPTION
cxDataRefInc increments the data's reference count.
A module does not normally need to call cxDataRefInc, unless it
wants to process a piece of data later, after the present execution.
Incrementing the reference count
ensures that the data will not be deleted when new input
arrives.
cxDataRefInc will also have to be called if a module inserts
cxData or cxCoord structures directly into a
cxLattice. Managing reference counts is discussed in more
detail in intro, but it is recommended that the routines such as
cxLatPtrSet be used instead for safety and upward compatibility.
See Appendix B of the IRIS Explorer Module Writer's Guide
for more information on reference counting.
SEE ALSO
cxDataRefDec(3E),
cxLatPtrSet(3E)
Last modified: Mon Nov 18 13:48:17 GMT 1996
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996