cxFireDataChanged, cxFireDataChangedV - check if the data on the "Fire" port is new
#include <cx/PortAccess.h>

int cxFireDataChanged ()
int cxFireDataChangedV (int *changeVec[] )
integer function cxFireDataChanged ()

integer function cxFireDataChangedV(pChangedVec) pointer (pChangedVec, changedVec) integer changedVec(1)
Set to the address of an array of integers indicating whether there is new data from each connection on the "Fire" port.
cxFireDataChanged returns a non-zero value if the "Fire" port has new data.

cxFireDataChangedV returns the number of values in the changeVec array.

cxFireDataChanged returns a non-zero value if the "Fire" port has new data. The status of input port data does not change during the firing of a module. Hence, this routine is most useful if used at the beginning of a firing cycle to determine whether the module has fired due to new data on the "Fire" port, when used in conjunction with cxInputDataChanged to check other ports.

cxFireDataChangedV sets changeVec to the address of an array which contains a non-zero (or zero) value for each connection that has new data, and returns the number of connections in the array. The changeVec array is static and must not be deallocated. The changed flags correspond to the array of connection identifiers returned by cxInputDataConnIDGetV. cxFireDataChangedV will not return the current number of connections if connections were made and then disconnected. See cxInputDataGet for a discussion of what data value and changed flag are used in this case.

The port is considered new if any of the connections have new data. The port will be old the next time the module fires if no new data has arrived. It is not necessary to call cxInputDataGet or cxInputDataGetV for the "Fire" port.

cxInputDataChanged(3E), cxInputDataChangedV(3E), cxInputDataGet(3E), cxInputDataGetV(3E), cxInputDataConnIDGetV(3E).
Last modified: Mon Nov 6 16:33:10 GMT 2000
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1996