ValuesReceived (External Interfaces/API)

Indicate the total number of values read from the device

Description

ValuesReceived indicates the total number of values read from the device. 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 device, 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 Bytes Versus Values for more information about bytes and values.

Characteristics

Read only
Always

Data type
Double

Read only	Always
Data type	Double

Values

The default value is 0.

Example

Suppose you create a serial port object 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

See Also

Functions

fopen

Properties

BytesAvailable

UserData ValuesSent