[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 COM_CLOSE()
 Clears the receiving buffer and closes the com port
------------------------------------------------------------------------------
 Syntax

     COM_CLOSE(<nComPort>) --> lClosed

 Argument

     <nComPort>  Designates which port is closed, COM1(1) to COM4(4).

 Returns

     A return of .T. indicates that the port is open and can be closed
     successfully.

 Description

     This function closes one of the ports (1 to 4).  This means that the
     buffer is cleared, and all signals in the modem control register (MCR)
     are deactivated.  Characters remaining in the buffer are lost.  The DTR
     and RTS signals become inactive, and any existing modem connection is
     broken.

 Note

     Warning!  All characters in the buffer are cleared, and the status
     register is set to 0.  Existing connections are always broken!

 Example

     nCharacter  :=  COM_COUNT(1)      // How many characters in
                                       // the buffer ?

     IF nCharacter > 0
        * Read everything from buffer!
        cContent  :=  COM_READ(1, nCharacter)
     ENDIF

     COM_CLOSE(1)


See Also: COM_OPEN() COM_INIT() COM_DTR() COM_RTS()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson