Museum

 ev_read(S)                     6 January 1993                     ev_read(S)


 Name

    ev_read - read the next event in the queue

 Syntax


    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

    evread 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 evpop is called.

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

 Diagnostics

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

 See also

    evblock(S), evclose(S), evcount(S), evflush(S), evgetdev(S),
    evgetemask(S), evgindev(S), evinit(S), evopen(S), evpop(S),
    evresume(S), evsetemask(S), evsuspend(S)

 Standards conformance

    evread is not part of any currently supported standard; it is an exten-
    sion of AT&T System V provided by the Santa Cruz Operation.