search_node
Description:
Searches a Tree using search_func
.
The search_func
is called with a pointer to the key of a key/value pair in the tree, and the passed in user_data
. If
search_func
returns 0 for a key/value pair, then the corresponding node is returned as the result of
search_key. If search_func
returns -1, searching will proceed
among the key/value pairs that have a smaller key; if search_func
returns 1, searching will proceed among the key/value pairs that
have a larger key.
Parameters:
this |
a Tree |
search_func |
a function used to search the Tree |
user_data |
the data passed as the second argument to |
Returns:
the node corresponding to the found key, or null if the key was not found |