Function Com_Event() Foundation

Waits for an event or a character to arrive at a COM port

Syntax
Com_Event( <nComPortNum> ;  // Type: N
         ) --> nCode
Return

The function returns a numeric code that is identified by #define constants from XBTCOM.CH, or 0 in case of a failure.

Possible return values of Com_Event()
Value Description
COM_EVENT_CHAR A character arrived at the COM port
COM_EVENT_CTSDSR CTS or DSR state changed
COM_EVENT_ERROR Line-status error occurred (overrun, parity or break)
COM_EVENT_RING Ring-indicator is detected (used to wait for an incoming call)

Description

The behaviour of Com_Event() differs from it's CA-Clipper pendant in that it waits until something arrived at a COM port.

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.