NAME

C SPECIFICATION

#include <cx/PortAccess.h>

void cxOutputDataRelease(int port)

FORTRAN SPECIFICATION

subroutine cxOutputDataRelease(port)
integer port

PARAMETERS

port

The descriptor of the output port to affect.

DESCRIPTION

This operation is used to release data on an output port. Note that setting a zero value on the output port with cxOutputDataSet will not have this effect, rather it will inform the control wrapper to use the previous data on that port.

The act of releasing data from the output port decrements its reference count, which will destroy the object if no other modules hold a reference to it. If the user function needs to retain a copy until subsequent firings, it must increment the reference count of that object by calling cxDataRefInc.

Note that it is not a valid operation to try to remove data from a "Firing Done" or "Loop Ended" port.

SEE ALSO