NAME

cxDataRefInc - increment reference count of IRIS Explorer data type
#include <cx/DataOps.h>

void cxDataRefInc(void *data)
subroutine cxDataRefInc(data)
integer data
data
Pointer to any reference counted IRIS Explorer data type.
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.

cxDataRefDec(3E), cxLatPtrSet(3E)
Last modified: Mon Nov 6 16:33:06 GMT 2000
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996

Website Feedback

If you would like a response from NAG please provide your e-mail address below.

(If you're a human, don't change the following field)
Your first name.
CAPTCHA
This question is for testing whether you are a human visitor and to prevent automated spam submissions.
Image CAPTCHA
Enter the characters shown in the image.