NAME

cxInputDataRelease, cxInputDataReleaseV - remove data from an input port

C SPECIFICATION

#include <cx/PortAccess.h>

void cxInputDataRelease( int port )

void cxInputDataReleaseV( int port, int count, int connIDs[] )

FORTRAN SPECIFICATION

integer function cxInputDataRelease(port)
integer port

subroutine cxInputDataReleaseV(port, count, connIDs) integer port integer count integer connIDs(1)

PARAMETERS

port
The integer descriptor of the port to release its data.
count
The number of connections in the connIDs array.
connIDs
A list of the connections which are to release data.

DESCRIPTION

cxInputDataRelease and cxInputDataReleaseV cause data on port to be removed. This can be used to reject bad data, or to remove a port's data when it is disconnected. cxInputDataRelease releases the data returned by cxInputDataGet, on the connection identified by cxInputDataConnIDGet. See cxInputDataGet for a description of which connection this will be.

cxInputDataReleaseV releases data on more than one connection. The data is released from each of the connections identified in the array connIDs. The connection identifiers in connIDs may be in any order. The routine cxInputDataConnIDGetV returns an array containing the connection identifiers on a port.

It is not valid to call these routines for a "Fire" port.

SEE ALSO

cxInputDataGet(3E), cxInputDataGetV(3E), cxInputDataConnIDGet(3E), cxInputDataConnIDGetV(3E).
Last modified: May 27 11:35 1999
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1999