BxDomNodeList.h

// ##################################################################
// Binx
// $Id: BxDomNodeList_8h-source.html,v 1.1.1.1 2006/04/19 14:19:02 edikt2 Exp $
//
// BxDomNodeList keeps an ordered list of nodes of the same name.
// ##################################################################
/*

//  edikt::BinX
//  www.edikt.org
//  support@edikt.org

// Copyright (c) 2003 The University of Edinburgh.

*/

#ifndef __BxDomNodeList__
#define __BxDomNodeList__

#include "BxObject.h"
#include "BxDomAttributeList.h"
#include <xercesc/dom/DOMNode.hpp>
#include <xercesc/dom/DOMNodeList.hpp>

XERCES_CPP_NAMESPACE_USE

/*
 * Class holding a list of BinX XML elements from a DOM parser.
 * This class is primarily used by the class BxBinxParser to build
 * memory-resident object structures containing the BinX document XML elements
 * and attributes.
 * An instance of BxDom NodeList holds a list of DOM nodes provided by
 * a third party DOM parse (in this implementation the Xerces DOM parser is used).
 * XML element names, lists of XML attribute name-value pairs
 * as well as nested (child) XML element list can be obtained methods
 * implemented by this class.
 * <BR><B>Since:</B>  BinX version 1.0.
 */
class DECLSPEC BxDomNodeList : public BxObject
{
    DOMNodeList * nodeList_;    //< the DOMNodeList pointer
    DOMNode * currentNode_;     //< the referenced node pointer
    int numberOfNodes_;     //< count of the number of nodes in the list
    int currentNo_;         //< index to the "current" node in this list

public:
    BxDomNodeList();
    BxDomNodeList(DOMNodeList *);   // specify node list
    BxDomNodeList(BxDomNodeList *);
    virtual ~BxDomNodeList();

    bool hasAttributes() const; // whether the current referenced node has any attributes
    BxDomAttributeList * getAttributes() const;  // get the attribute list for this node if any
    char * getAttributeValue(const char * attributeName) const; // get attribute value of currentNode_
    char * getNodeName();   // get node name of currentNode_
    char * getNodeValue();  // get node value for text() node
    bool isElementNode();   // whether the currentNode_ is an element node.
    BxDomNodeList * getChildren() const;    // get children of currentNode_

    void reset();   // clear currentNode and start from the first
    bool next();    // pointer to next(first if not visited) and return true/false
};

#endif

---