Class COM_STATUS

-- Create an uninitialized com status structure.

-- Create this structure from an extant, open communications device.
-- Throws an exception if call to get_comm_stat fails.

-- Number of bytes received by the serial provider but not yet read.

-- Last error reported from get_comm_stat.

-- Number of bytes remaining to be transmitted for all write operations.

-- Is transmission waiting for the CTS (clear-to-send) signal to be sent?

-- Is transmission waiting for the DSR (data-set-ready) signal to be sent?

-- Has the EOF (end-of-file) character been received?

-- Is transmission waiting for the RLSD (receive-line-signal-detect)
-- signal to be sent?

-- Is there a character queued for transmission that has come to the
-- communications device by way of the transmit_comm_char function?
-- The communications device transmits such a character ahead of other
-- characters in the device's output buffer.

-- Is transmission waiting because the XOFF character was received?

-- Is transmission waiting because the XOFF character was transmitted?

-- Retrieve the current information about the comm device.
-- This function has the unavoidable side effect of clearing any
-- comm error. Throws an exception if call fails.