Platform

Win32

Purpose

To set the characters that may be used to terminate a call to READCOMMDEVICE@ .

Syntax

INTEGER (KIND=3) SETCOMMTERMINATECHAR@(PORTNUM,STRING,LEN)
INTEGER (KIND=3) PORTNUM,LEN
CHARACTER (LEN=*) STRING

Description

PORTNUM must be a valid serial port number in the range 1 to 4. STRING contains a string of length LEN. This string is used to provide a list of characters that may be used to terminate a call to READCOMMDEVICE@. The termination character is discarded when READCOMMDEVICE@ is called. For example char(0)//char(12)//char(15) provides for the data to be terminated by a null character, a line feed or a carriage return.

Return value

SETCOMMTERMINATECHAR@ returns a positive value if successful or -1 if an error has occurred.

Notes

To access this routine you need to provide a definition by, for example, including the file clearwin.ins or by using the MSWIN module.