Functions and Directives Functions and Directives

Function Com_Read() Foundation

Reads characters from the specified COM port.

Syntax
Com_Read( <nComPortNum>   , ;
          [<nBytesToRead>], ;
          <ignored>         ;
        ) --> cString
Return

Returns a string of bytes from receive buffer. If there are no bytes or in case of an error a null string ("") will be returned.

Description

The parameter <nBytesToRead> specifies how many bytes should be read from the COM port. If <nBytesToRead> is not specified, all bytes currently in the receive buffer will be returned.

For timeout considerations see Com_ReadMode().

NOTE: The CA-Tools function allows a third parameter that specifies whether or not the bytes are to be deleted from the receive buffer. This feature cannot be provided and the third parameter is ignored.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.