queue_get_head()

Get a pointer to the first element in the specified queue.

Synopsis:

#include <hnm/queue.h>
 
void* queue_get_head(queue_Queue queue)

Arguments:

queue

The queue structure whose head element will be retrieved.

Library:

libhnm

Description:

The queue_get_head() function returns a void pointer to the first element in the specified queue. This pointer can be cast by the calling context to the expected storage type of the queue.

Returns:

A pointer to the head element in queue. If the queue is empty, the returned value will be NULL.