ev_read(3event)

ev_read -- read the next event in the queue

Synopsis

cc . . . -levent

#include  <sys/types.h>
#include  <sys/param.h>
#include  <sys/sysmacros.h>
#include  <sys/page.h>
#include  <sys/event.h>
#include  <mouse.h>

EVENT* ev_read ()

Description

ev_read returns a pointer to the next event in the queue or NULL if the queue is empty. Multiple calls to this routine return the same pointer until ev_pop is called.

An error occurs if this routine is called from a program without an open event queue.

Return values

This routine returns NULL if there is no event to read or if there is not an open event queue.

References

ev_block(3event), ev_close(3event), ev_count(3event), ev_flush(3event), ev_getdev(3event), ev_getemask(3event), ev_gindev(3event), ev_init(3event), ev_open(3event), ev_pop(3event), ev_resume(3event), ev_setemask(3event), ev_suspend(3event)

Standards conformance

ev_read is not part of any currently supported standard; it is an extension of AT&T System V provided by the Santa Cruz Operation.