ValuesReceived

Total number of values read from instrument

Description

ValuesReceived indicates the total number of values read from the instrument. The value is updated after each successful read operation, and is set to 0 after the fopen function is issued. If the terminator is read from the instrument, then this value is reflected by ValuesReceived.

If you are reading data asynchronously, use the BytesAvailable property to return the number of bytes currently available in the input buffer.

When performing a read operation, the received data is represented by values rather than bytes. A value consists of one or more bytes. For example, one uint32 value consists of four bytes. Refer to Output Buffer and Data Flow for more information about bytes and values.

Characteristics

Usage	Any instrument object
Read only	Always
Data type	Double

Values

The default value is 0.

Examples

Suppose you create a serial port object on a Windows^® machine associated with the serial port COM1.

s = serial('COM1');
fopen(s)

If you write the RS232? command, and then read back the response using fscanf, ValuesReceived is 17 because the instrument is configured to send the LF terminator.

fprintf(s,'RS232?')
out = fscanf(s)
out =
9600;0;0;NONE;LF
s.ValuesReceived
ans =
    17