Total number of values read from instrument
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.
Usage | Any instrument object |
Read only | Always |
Data type | Double |
The default value is 0
.
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