From the current node (the node used to call this member function), find all sub-nodes matching the supplied criteria. Warning! This function has been known to cause a lot of confusion. This function does not simply locate nodes that are children of the calling node whose name matches the supplied criteria. The aim is to locate descenant nodes, however far down the tree they are. Returns: None

Declared in file: hzDocument.h
Defined in file : hzDocXml.cpp

Function Logic:

Function body:

void hzXmlNode::FindSubnodes (hzVect<hzXmlNode*>& result)const char* srchExp, 
{
   //  From the current node (the node used to call this member function), find all sub-nodes matching the supplied criteria.
   //  
   //  Warning! This function has been known to cause a lot of confusion.
   //  
   //  This function does not simply locate nodes that are children of the calling node whose name matches the supplied criteria. The
   //  aim is to locate descenant nodes, however far down the tree they are.
   //  
   //  Arguments: 1) result A reference to a vector of nodes that will be populated by this operation
   //     2) srchExp The search expression that decendent nodes of this node, must match to be included in the result
   //  
   //  Returns: None
   _hzfunc("hzXmlNode::FindSubnodes") ;
   uint32_t    nLimit = 0; //  Level limit
   if (!m_pHostDoc)
       hzexit(E_NOINIT, "Node has no host document") ;
   result.Clear() ;
   _testnode(result, srchExp, nLimit) ;
}