[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 COM_READ()
 Reads characters from the receiving buffer
------------------------------------------------------------------------------
 Syntax

     COM_READ(<nComPort>,[<nLength>],[<lNoDelete>])
        --> cCharacterstring

 Arguments

     <nComPort>  Designates the port (1 to 4) that is read.

     <nLength>  Designates the number of the characters in the buffer
     that are read.  The default value reads all characters.

     <lNoDelete>  Designates whether or not characters are removed from
     the buffer as they are read.  The default setting removes all characters
     from the buffer as they are read.  However, if the parameter is .T., the
     characters remain in the buffer as long as it is not full.

 Returns

     The returned string contains the corresponding characters from the
     receiving buffer.

 Description

     All characters arriving at the serial port are stored in the appropriate
     buffer under interrupt control.  It is possible to determine the number
     of characters in the buffer and to read one, several, or all of the
     characters.  If the <nLength> parameter is not specified, then all the
     characters in the buffer are read.

 Note

     .  Remember that you can receive additional characters between
        calling COM_COUNT() and COM_READ().

 Example

     Wait until at least 10 characters have been received:

     DO WHILE COM_COUNT(1) < 10             // Wait until 10
                                            // characters in buffer
        *...
     ENDDO

     cInput := COM_READ(1, 10)              // Read in 10 characters
     ? cInput                               // Display characters
                                            // that are read


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