Important: The information in this document is obsolete and should not be used for new development.
OTLIFOStealList
Removes all links in a LIFO list and returns a pointer to the first link in the list.C INTERFACE
OTLink* OTLIFOStealList (OTLIFO* list)C++ INTERFACE
None. C++ applications use the C interface to this function.PARAMETERS
list
- A pointer to the LIFO list from which you want to remove all linked entries.
- function result
- A pointer to the first link in the list.
DISCUSSION
This function atomically removes all of the elements from the specified LIFO list and returns a pointer to the first link in the list. You can access the other elements in the list by referring to thefNext
field of theOTLink
structures that make up the list.If the list is empty, it returns
nil
.