Write With Abort Endpoint

Requires: Base Development System

Writes an element to a Lossy Stream channel or signals the channel to abort. The endpoint waits if the channel is full. This endpoint is the same as the Write endpoint except that it has an abort input and an aborted? output. You can use the abort capability of the Lossy Stream channel to close a channel abruptly, ignoring any data left in the channel buffer. You must use this endpoint together with the Read With Abort endpoint.

You can drop this endpoint on the block diagram by right-clicking a terminal or a wire and selecting Create»Channel Writer»Lossy Stream»Write With Abort.

Details  

lossy behavior specifies how this endpoint writes data to a Lossy Stream channel when an element comes in. The default is drop oldest element.

0drop oldest element
1skip this write
element valid? specifies whether the element is valid. If TRUE, the endpoint records the element valid? flag. If FALSE, the endpoint ignores the value of element. The endpoint does nothing if both element valid? and last element? are FALSE. The default is TRUE.
element specifies the data to write to the channel.
last element? specifies whether this is the last element that the endpoint writes to the channel. The default is FALSE. If TRUE, the endpoint marks the channel as closed and ignores further calls to write. The reader endpoint can continue reading data until the last element? output of the reader endpoint returns TRUE.
abort specifies whether to abort this channel. If abort is TRUE, this endpoint marks the channel as closed and ignores further calls to write. Meanwhile, the aborted? output returns TRUE on the next call of this endpoint.
size specifies the number of elements that the endpoint will write to the channel. The default is 1.
data lost? returns TRUE if the channel was full when the endpoint performed this write operation.
count returns the number of elements in the channel after this endpoint updates the channel. Use this output to monitor the relative writing and reading speed of the channel endpoints and make adjustments, if necessary.
channel is the channel wire that connects this endpoint to a reader endpoint.
aborted? returns TRUE if abort occurred on this endpoint or the reader endpoints connected to the channel. If aborted? is TRUE, further calls to this endpoint will do nothing except returning aborted? TRUE again.

Write With Abort Details

Related Information

Read With Abort