SPORT_PEEK_LINE

Run-Time Function: Returns information about the availability of input records.

Module: USE DFLIB

Syntax

iresult = SPORT_PEEK_LINE (port [, present] [, count])

port
(Input) Integer. The port number.


present
(Optional; output) Integer. 1 if data is present, 0 if no data has been read.


count
(Optional; output) Integer. The count of characters that will be returned by SPORT_READ_DATA.

Results:

The result is of type INTEGER(4). The result is zero if successful; otherwise, a Win32 error value.

This routine will only return when a line terminator has been seen - as defined by the mode specified in the SPORT_CONNECT( ) call.


Note: CR and LF characters may not be returned depending on the mode specified in the SPORT_CONNECT( ) call.

Compatibility

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

See Also: SPORT_CONNECT, SPORT_READ_DATA, SPORT_PEEK_DATA, Using the Serial I/O Port Routines, and Communications, and Communications Functions in the Win32 SDK

Example

USE DFLIB
INTEGER(4) iresult
INTEGER    present
INTEGER    count

iresult =  SPORT_PEEK_LINE( 2, present, count )
END