Legacy Document

Important: The information in this document is obsolete and should not be used for new development.

Inside Macintosh: Networking With Open Transport / Part 2 - Open Transport Reference

Chapter 27 - Utilities Reference / Functions

OTFindAndRemoveLink
Finds a link in a FIFO list and removes it.

C INTERFACE
OTLink* OTFindAndRemoveLink(
                     OTList* list,
                     OTListSearchProcPtr proc,
                     const void* refPtr)
C++ INTERFACE
None. C++ applications use the C interface to this function.

PARAMETERS

list
A pointer to the FIFO list to be searched.
proc
A pointer to the user-defined procedure to be used in searching for the link. See MyListSearchFunction for information on defining your own link.
refPtr
A pointer to a value that is passed to the user-defined search procedure and that is useful to that procedure in finding a link. This value might be the address of a field, the value of a field, or any other kind of data that would help identify the link being sought.
function result
A pointer to the link that was found and removed. The value of this pointer is NULL if no link matching your search criteria is found.

DISCUSSION
This function behaves exactly the same as the OTFindLink function except that if a link value is found, it is removed from the list.
Use the OTIsInList function to determine whether a link is in a FIFO list.
Use the OTRemoveLink function to remove a link from a FIFO list.
Use the OTFindLink function to find a link in a FIFO list.
Use the OTGetIndexedLink function to find a link in a FIFO list based on its index in the list.