queue_free

	num_deleted.i4.v = queue_free(queue.gp.r)

	This routine will delete a queue and free all of the data
	that it points to.

	queue		queue to delete

	This function returns status values as follows:

	CLIB_INVARG		invalid queue passed
	otherwise		number of queue entries deleted

	This function requires the following include files:

	cbslib_h

	Related functions:

	queue_delete, queue_init, queue_insert, queue_remove, queue_peek,
	queue_is_empty, queue_size

	C/C++ usage:

	int	num_deleted;
	void	*queue;

	num_deleted = queue_free(&queue);