InputBufferSize

Specify size of input buffer in bytes

Description

You configure InputBufferSize as the total number of bytes that can be stored in the software input buffer during a read operation.

A read operation is terminated if the amount of data stored in the input buffer equals the InputBufferSize value. You can read text data with the fgetl, fgets, or fscanf functions. You can read binary data with the fread function.

You can configure InputBufferSize only when the instrument object is disconnected from the instrument. You disconnect an object with the fclose function. A disconnected object has a Status property value of closed.

If you configure InputBufferSize while there is data in the input buffer, then that data is flushed.

Characteristics

Usage	Any instrument object
Read only	While open
Data type	Double

Values

The default value is 512 bytes.

Examples

This example shows how to set the input buffer size for a serial port object. The InputBufferSize property specifies the total number of bytes that can be stored in the software input buffer during a read operation. By default, InputBufferSize is 512 bytes. There could be a case when you would want to increase it to higher than the default size.

Create a serial port object associated with the COM1 port. Set the input buffer size to 768 bytes.

s = serial('COM1');
s.InputBufferSize = 768;