Description
Base class for Tree nodes.
All nodes of a tree inherit from this type. The main features that this class provides are:
- When declaring a tree node, the parent-child edges are declared using the ChildEdge type as described in that type's documentation.
- Every node has a
childrendata member that enumerates the nodes pointed to by the ChildEdge data members. This list of all children is updated automatically as assignments are made to the ChildEdge data members.
- Every node has a
parentdata member that points to the parent node in the tree, or null if this node is the root of a tree. The parent pointers are updated automatically as nodes are inserted into and removed from the tree.
- Node memory is managed using
std::shared_ptr, and node memory is reclaimed automatically when there are no more references to the node, either as parent-child edges or other shared pointers outside the tree's control. The pointers from child to parent within the tree data structure itself are weak and do not count as references to the parent node.
- a number of traversals are defined, the two most general being traverse and traverseParents. The other traversals are more specialized and are built upon the first two.
#include <Tree.h>
Public Member Functions | |
| Node () | |
| Construct an empty node. | |
| virtual | ~Node () |
| Nodes are polymorphic. | |
| Node (const Node &)=delete | |
| Node & | operator= (const Node &)=delete |
| template<class Functor > | |
| TraversalAction | traverse (Functor functor) |
| Traverse the tree starting at this node and following child pointers. More... | |
| template<class Functor > | |
| TraversalAction | traverse (Functor functor) const |
| Traverse the tree starting at this node and following child pointers. More... | |
| template<class T , class Functor > | |
| TraversalAction | traverseType (Functor functor) |
| Traverse the tree restricted by type. More... | |
| template<class T , class Functor > | |
| TraversalAction | traverseType (Functor functor) const |
| Traverse the tree restricted by type. More... | |
| template<class Functor > | |
| TraversalAction | traverseParents (Functor functor) |
| Traverse the tree by following parent pointers. More... | |
| template<class Functor > | |
| TraversalAction | traverseParents (Functor functor) const |
| Traverse the tree by following parent pointers. More... | |
| template<class Predicate > | |
| NodePtr | find (Predicate predicate) |
| Traverse an tree to find the first node satisfying the predicate. | |
| template<class Predicate > | |
| NodePtr | find (Predicate predicate) const |
| Traverse an tree to find the first node satisfying the predicate. | |
| template<class T > | |
| std::shared_ptr< T > | findType () |
| Find first child that's the specified type. | |
| template<class T > | |
| std::shared_ptr< T > | findType () const |
| Find first child that's the specified type. | |
| template<class T , class Predicate > | |
| std::shared_ptr< T > | findType (Predicate predicate) |
| Find first child of specified type satisfying the predicate. | |
| template<class T , class Predicate > | |
| std::shared_ptr< T > | findType (Predicate predicate) const |
| Find first child of specified type satisfying the predicate. | |
| template<class Predicate > | |
| NodePtr | findParent (Predicate predicate) |
| Find closest ancestor that satifies the predicate. | |
| template<class Predicate > | |
| NodePtr | findParent (Predicate predicate) const |
| Find closest ancestor that satifies the predicate. | |
| template<class T > | |
| std::shared_ptr< T > | findParentType () |
| Find closest ancestor of specified type. | |
| template<class T > | |
| std::shared_ptr< T > | findParentType () const |
| Find closest ancestor of specified type. | |
| template<class T , class Predicate > | |
| std::shared_ptr< T > | findParentType (Predicate predicate) |
| Find closest ancestor of specified type that satisfies the predicate. | |
| template<class T , class Predicate > | |
| std::shared_ptr< T > | findParentType (Predicate predicate) const |
| Find closest ancestor of specified type that satisfies the predicate. | |
Public Attributes | |
| ParentEdge | parent |
| Pointer to the parent node, if any. | |
| Children | children |
| Vector of pointers to children. | |
Member Function Documentation
◆ traverse() [1/2]
|
inline |
Traverse the tree starting at this node and following child pointers.
The functor takes two arguments: the tree node under consideration, and a TraversalEvent that indicates whether the traversal is entering or leaving the node. The functor must return a TraversalAction to describe what should happen next.
If the functor called by the node enter event returns SKIP_CHILDREN, then none of the children are traversed and the next call to the functor is for leaving that same node.
If any call to the functor returns ABORT, then the traversal is immediately aborted.
If any functor returns ABORT, then the traverse function also returns ABORT. Otherwise the traverse function returns CONTINUE.
◆ traverse() [2/2]
|
inline |
Traverse the tree starting at this node and following child pointers.
The functor takes two arguments: the tree node under consideration, and a TraversalEvent that indicates whether the traversal is entering or leaving the node. The functor must return a TraversalAction to describe what should happen next.
If the functor called by the node enter event returns SKIP_CHILDREN, then none of the children are traversed and the next call to the functor is for leaving that same node.
If any call to the functor returns ABORT, then the traversal is immediately aborted.
If any functor returns ABORT, then the traverse function also returns ABORT. Otherwise the traverse function returns CONTINUE.
◆ traverseType() [1/2]
| TraversalAction Sawyer::Tree::Node::traverseType | ( | Functor | functor | ) |
◆ traverseType() [2/2]
| TraversalAction Sawyer::Tree::Node::traverseType | ( | Functor | functor | ) | const |
◆ traverseParents() [1/2]
|
inline |
◆ traverseParents() [2/2]
|
inline |
The documentation for this class was generated from the following file:
