Matrix1 Utility Plug-ins

SOCKET POLL

Syntax

Status = SOCKET POLL( Handle )
Status = SOCKET POLL( Handle, Timeout )
Status = SOCKET POLL( Handle, Timeout, Mask)

Description

This function determines the status of your socket, waiting if necessary, to perform I/O.

You will usually use this function to detect when data is available to read, or when the other server has signalled an EOF by closing the write-side of the socket

If used without a timeout value, the function will return immediately.
If used without a mask value, the function will use a mask that checks for reading, EOF and errors.

When used with a UDP socket, the EOF parameter is invalid and will be ignored.

The mask bit values are as follows:
1 - Ready to read
2 - Ready to write
4 - Socket Error
8 - Remote has closed their send socket (equivalent to end-of-file)

Simply add or 'OR' the value together to produce the required Mask value.

Returns a value corresponding to the masked values selected (ie if the read bit was set in the mask, and data is ready for reading, the return value will have the read bit set also)
No end-of-file will be flagged until all outstanding data for the socket has been read.

Go back to ...

Matrix1Util_28 Commands Menu

Matrix1 Utils Main Index

Matrix1 Utils Command List

Commands Menu

Main Menu