WvStreams
Classes | Public Types | Public Member Functions | Protected Types | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Friends
UniConfTree< Sub > Class Template Reference

A recursively composed dictionary for tree-structured data indexed by UniConfKey. More...

#include <uniconftree.h>

Inheritance diagram for UniConfTree< Sub >:
Inheritance graph
[legend]

List of all members.

Classes

class  Iter
 An iterator that walks over all elements on one level of a UniConfTree. More...

Public Types

typedef wv::function< void(const
Sub *, void *) 
Visitor )
typedef wv::function< bool(const
Sub *, const Sub *) 
Comparator )

Public Member Functions

 UniConfTree (Sub *parent, const UniConfKey &key)
 Creates a node and links it to a subtree, if parent is non-NULL.
 ~UniConfTree ()
 Destroy this node's contents and children.
Sub * parent () const
 Returns a pointer to the parent node, or NULL if there is none.
void setparent (Sub *parent)
 Reparents this node.
Sub * root () const
 Returns a pointer to the root node of the tree.
UniConfKey fullkey (const Sub *ancestor=NULL) const
 Returns full path of this node relative to an ancestor.
Sub * find (const UniConfKey &key) const
 Finds the sub-node with the specified key.
Sub * findchild (const UniConfKey &key) const
 Finds the direct child node with the specified key.
void remove (const UniConfKey &key)
 Removes the node for the specified key from the tree and deletes it along with any of its children.
void zap ()
 Removes and deletes all children of this node.
void visit (const Visitor &visitor, void *userdata, bool preorder=true, bool postorder=false) const
 Performs a traversal on this tree using the specified visitor function and traversal type(s).
bool compare (const Sub *other, const Comparator &comparator)
 Compares this tree with another using the specified comparator function.
const UniConfKeykey () const
 Returns the key field.
bool haschildren () const
 Returns true if the node has children.

Protected Types

typedef WvScatterHash
< UniHashTreeBase, UniConfKey,
Accessor
Container
typedef UniHashTreeBaseVisitor BaseVisitor
typedef UniHashTreeBaseComparator BaseComparator

Protected Member Functions

UniConfKey _fullkey (const UniHashTreeBase *ancestor=NULL) const
UniHashTreeBase_find (const UniConfKey &key) const
UniHashTreeBase_findchild (const UniConfKey &key) const

Static Protected Member Functions

static bool _recursivecompare (const UniHashTreeBase *a, const UniHashTreeBase *b, const UniHashTreeBaseComparator &comparator)
static void _recursive_unsorted_visit (const UniHashTreeBase *a, const UniHashTreeBaseVisitor &visitor, void *userdata, bool preorder, bool postorder)

Protected Attributes

UniHashTreeBasexparent
Containerxchildren

Friends

class Iter

Detailed Description

template<class Sub>
class UniConfTree< Sub >

A recursively composed dictionary for tree-structured data indexed by UniConfKey.

Someday this could be further abstracted into a generic WvTreeDict.

"Sub" is the name of the concrete subclass of UniConfTree.

Definition at line 23 of file uniconftree.h.


Constructor & Destructor Documentation

template<class Sub>
UniConfTree< Sub >::~UniConfTree ( ) [inline]

Destroy this node's contents and children.

Definition at line 36 of file uniconftree.h.


Member Function Documentation

template<class Sub>
Sub* UniConfTree< Sub >::parent ( ) const [inline]

Returns a pointer to the parent node, or NULL if there is none.

Definition at line 40 of file uniconftree.h.

template<class Sub>
void UniConfTree< Sub >::setparent ( Sub *  parent) [inline]

Reparents this node.

Definition at line 44 of file uniconftree.h.

template<class Sub>
Sub* UniConfTree< Sub >::root ( ) const [inline]

Returns a pointer to the root node of the tree.

Definition at line 48 of file uniconftree.h.

template<class Sub>
UniConfKey UniConfTree< Sub >::fullkey ( const Sub *  ancestor = NULL) const [inline]

Returns full path of this node relative to an ancestor.

If ancestor is NULL, returns the root.

Definition at line 55 of file uniconftree.h.

Referenced by UniTransactionGen::deletion_visitor(), and UniTempGen::set().

template<class Sub>
Sub* UniConfTree< Sub >::find ( const UniConfKey key) const [inline]
template<class Sub>
Sub* UniConfTree< Sub >::findchild ( const UniConfKey key) const [inline]

Finds the direct child node with the specified key.

If key.numsegments() == 1, then performs the same task as find(key), but a little faster. Otherwise returns NULL.

Definition at line 71 of file uniconftree.h.

Referenced by UniConfRoot::add_callback(), UniTransactionGen::apply_values(), UniTransactionGen::cancel_values(), UniTransactionGen::gencallback(), UniTransactionGen::get(), UniTransactionGen::iterator(), GenStyleChangeTreeIter::next(), and UniTempGen::set().

template<class Sub>
void UniConfTree< Sub >::remove ( const UniConfKey key) [inline]

Removes the node for the specified key from the tree and deletes it along with any of its children.

If the key is UniConfKey::EMPTY, deletes this object.

Definition at line 80 of file uniconftree.h.

template<class Sub>
void UniConfTree< Sub >::zap ( ) [inline]

Removes and deletes all children of this node.

Definition at line 84 of file uniconftree.h.

Referenced by UniConfTree< UniConfChangeTree >::~UniConfTree().

template<class Sub>
void UniConfTree< Sub >::visit ( const Visitor &  visitor,
void *  userdata,
bool  preorder = true,
bool  postorder = false 
) const [inline]

Performs a traversal on this tree using the specified visitor function and traversal type(s).

"visitor" is the tree visitor function "userdata" is userdata for the tree visitor function

Definition at line 108 of file uniconftree.h.

Referenced by UniTransactionGen::cancel_changes(), and UniTempGen::set().

template<class Sub>
bool UniConfTree< Sub >::compare ( const Sub *  other,
const Comparator &  comparator 
) [inline]

Compares this tree with another using the specified comparator function.

Comparison of a subtree ends when the comparator returns false. "comparator" is the value compare function "userdata" is userdata for the compare function Returns: true if the comparison function returned true each time

Definition at line 124 of file uniconftree.h.

Referenced by UniIniGen::refresh().

const UniConfKey& UniHashTreeBase::key ( ) const [inline, inherited]

Returns the key field.

Definition at line 40 of file unihashtree.h.

Referenced by UniConfTree< UniConfChangeTree >::remove(), and UniTransactionGen::setv().

bool UniHashTreeBase::haschildren ( ) const [inherited]

Returns true if the node has children.

Definition at line 114 of file unihashtree.cc.

References UniHashTreeBase::xchildren.

Referenced by UniTempGen::haschildren(), and UniWatchInfoTree::isessential().


Member Data Documentation

UniHashTreeBase* UniHashTreeBase::xparent [protected, inherited]

the parent of this subtree

Definition at line 62 of file unihashtree.h.

Referenced by UniConfTree< UniConfChangeTree >::parent().

Container* UniHashTreeBase::xchildren [protected, inherited]

the hash table of children

Definition at line 63 of file unihashtree.h.

Referenced by UniHashTreeBase::haschildren(), and UniConfTree< UniConfChangeTree >::zap().


The documentation for this class was generated from the following file: