c_qdelete - Delete an entry in a queue

SYNTAX

long FUNCTION c_qdelete(q, position)

     long q;      
     long position;

PARAMETERS

q (long, input)

The number of the queue to delete from. This number is returned by the c_qcreate() routine.

position (long, input)

The position of the item to delete from the queue. The position may be determined by the qfind() routine.

DESCRIPTION

This routine is used to delete an entry in a queue. The space allocated for the entry will be freed. The entries surrounding the deleted entry will be relinked to maintain the remainder of the queue. The current position in the queue becomes undefined when this function exits.

RETURN VALUE

c_qdelete() returns

    0 --> Successful completion.  The specified object is deleted from 
          the queue.
   -1 --> Operation failed.  No such queue exists.