queue_peek

	value.g.v = queue_peek(queue.g.v [,was_found.i4.r])

	This routine will return the value at the end of a queue
	without removing it.

	queue		queue to peek
	[was_found]	flag indicating whether or not an element was found
			(TRUE -> element was found,
			 FALSE -> queue is empty,
			 CLIB_INVARG -> not a valid queue)

	This function requires the following include files:

	cbslib_h

	Related functions:

	queue_init, queue_insert, queue_remove, queue_delete, queue_free,
	queue_is_empty, queue_size

	C/C++ usage:

	int	was_found;
	void	*queue;
	void	*value;

	value = queue_peek(queue,&was_found);