External Interfaces/API

ValuesSent

Indicate the total number of values written to the device

Description

ValuesSent indicates the total number of values written to the device. The value is updated after each successful write operation, and is set to 0 after the fopen function is issued. If you are writing the terminator, then ValuesSent reflects this value.

If you are writing data asynchronously, use the BytesToOutput property to return the number of bytes currently in the output buffer.

When performing a write operation, the transmitted 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

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 *IDN? command using the fprintf function, then ValuesSent is 6 because the default data format is %s\n, and the terminator was written.

• fprintf(s,'*IDN?')
  s.ValuesSent
  ans =
      6
  

See Also

Functions

fopen

Properties

BytesToOutput

ValuesReceived