NAME

DOM_NodeList - the Document Object Model (DOM) DOM_NodeList interface

SYNOPSIS

#include <domc.h>

typedef struct {
	int length;
	/* other members */
} DOM_NodeList;

DOM_Node *DOM_NodeList_item(DOM_NodeList *this, int index);

DESCRIPTION

The DOM_NodeList type provides access to an ordered collection of nodes. The childNodes member of DOM_Node is a DOM_NodeList. The getElementsByTagName functions also return a DOM_NodeList.

The DOM recommendations specify that these lists are live meaning that modifying the children of a node should be reflected in a list returned by the getElementsByTagName functions.Currently DOMC does not update a DOM_NodeList returned by the getElementsByTagName functions if source nodes are subsequently removed or if a node is added that should be included.

item: The DOM_NodeList_item function returns the node in this list at index which starts from 0.

RETURNS

item: The node at the specified index or NULL if there is no such node.