qread(3G)							     qread(3G)

NAME    [Toc]    [Back]

     qread - reads the first entry in the event	queue

C SPECIFICATION    [Toc]    [Back]

     long qread(data)
     short *data;

PARAMETERS    [Toc]    [Back]

     data expects a pointer to the location that is to receive the data	the
	  event	queue.

FUNCTION RETURN	VALUE
     The returned function value is the	identifier for the device read.

DESCRIPTION    [Toc]    [Back]

     When there	is an entry in the queue, qread	returns	the device number of
     the queue entry, writes the data of the entry into	data, and removes the
     entry from	the queue.

     If	there is not an	entry in the queue, qread will block and return	when
     an	entry is made.

SEE ALSO    [Toc]    [Back]

     qreset, qtest

NOTE    [Toc]    [Back]

     This routine is available only in immediate mode.


									PPPPaaaaggggeeee 1111