Double-Linked Lists - Occasional Find Function

    #include <mplib1/dl_list.h>

    Node_t *Find_Node_By_Item( List_t *list, const void *item );

In certain conditions it may well be that the the item refered to in a list does not actually know which node references it in the list. In this case it is possible to find the relevant node by calling this function. It walk the list from the head until it reaches the first node that points to the item. The node pointer is returned, or NULL on failure.

In common with the other Find_ functions, any found node is not removed from the list.