foreach_node
Description:
Calls the given function for each of the nodes in the Tree.
The function is passed the pointer to the particular node, and the given data parameter. The tree traversal happens in-order.
The tree may not be modified while iterating over it (you can't add/remove items). To remove all items matching a predicate, you need to add each item to a list in your TraverseFunc as you walk over the tree, then walk the list and remove each item.
Parameters:
| this |
a Tree |
| func |
the function to call for each node visited. If this function returns true, the traversal is stopped. |
| user_data |
user data to pass to the function |