macro LFDS710_LIST_ASO_GET_VALUE_FROM_ELEMENT
Jump to navigation
Jump to search
Source File
└───liblfds710
└───inc
└───liblfds710
lfds710_list_addonly_singlylinked_ordered.h
Opaque Structures
struct lfds710_list_aso_element;
Macro
#define LFDS710_LIST_ASO_GET_VALUE_FROM_ELEMENT( list_aso_element )
Parameters
list_aso_element
- A struct lfds710_list_aso_element. Not a pointer to it - the struct itself.
Return Value
Returns a void pointer, the value from the element.
Notes
As with all liblfds macros, the macro operates on the structure itself, not a pointer to it.
The value in an element is set and set atomically by LFDS710_LIST_ASO_SET_VALUE_IN_ELEMENT and this get macro issues a load barrier before reading, which ensures that by the time LFDS710_LIST_ASO_SET_VALUE_IN_ELEMENT returns, the value set will be seen by all readers.
This contrasts to the bouded, single consumer, single producer queue, which only guarantees that the order of queuing will be honoured; it does not guarantee that by the time the enqueue function returns, readers will be able to dequeue the newly enqueued element.
Example
Coming soon. No, really! (Written 29th Dec 2015).