long FUNCTION c_qdelete(q, position)
long q; long position;
The number of the queue to delete from. This number is returned by the c_qcreate() routine.
The position of the item to delete from the queue. The position may be determined by the qfind() routine.
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.
c_qdelete() returns
0 --> Successful completion. The specified object is deleted from the queue. -1 --> Operation failed. No such queue exists.