Read Endpoint

Requires: Base Development System

Reads an element from a Stream channel. The endpoint waits if the channel is empty.

You can drop this endpoint on the block diagram by right-clicking a Stream channel terminal or wire and selecting Create»Channel Reader»Stream»Read.

Details  Examples

timeout in ms is the time, in milliseconds, that this endpoint has to read the elements from the channel. The default value is -1, which means there is no time limit.
channel is the channel wire that connects this endpoint to a writer endpoint.
timed out? returns TRUE if the amount of time specified by timeout in ms elapses before the endpoint reads the data specified in element from the channel. If timed out? is TRUE, element valid? and last element? will be FALSE.
element valid? returns TRUE if the element was read successfully. This output returns FALSE if a timeout occurs, if the channel closes without a valid last element, or if the channel aborts.
element returns the data that this endpoint reads from the channel. This output returns the default value of the transmission data type if a timeout occurs, if the channel closes without a valid last element, or if the channel aborts.
last element? returns whether this is the last element that the endpoint reads from the channel. last element? can be TRUE even if element valid? is FALSE, which means that the last element was already written to the channel during the previous iteration or the channel closes without a valid last element. This output returns FALSE if a timeout occurs or if the channel aborts.
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.

Read Details

Related Information

Write

Examples

Refer to the following VIs for examples of using the Read endpoint: