nrf_802154_queue_pop_begin()

void * nrf_802154_queue_pop_begin

(

const nrf_802154_queue_t *

p_queue

)

Returns pointer to the next item to be read from the queue.

This function is to be used when reading data from the queue directly (no copy). Returned pointer is valid when the queue is not empty (nrf_802154_queue_is_empty returned false). To ensure thread-safety external locking is required.

To read an item from the queue perform following.

if (!nrf_802154_queue_is_empty(&queue))
{
    my_item_t * p_item = (my_item_t *)nrf_802154_queue_pop_begin(&queue);
    ... read & process data pointed by p_item
    nrf_802154_queue_pop_commit(&queue)
}

Parameters

[in]

p_queue

Pointer to the queue instance.

Returns

Pointer to the next item to be written.