removeNext Method (Compact 2013)

3/26/2014

Removes the next node.

Syntax

var objXMLDOMNode = objXMLDOMSelection.removeNext();

HRESULT removeNext(
  IXMLDOMNode** ppNode
);

Parameters

Script

None.

C/C++

• ppNode
  [out, retval] The node that was removed, or Null if there is no nextNode Method (IXMLDOMNamedNodeMap) to remove. If the parameter is Null, the removed node is not returned, but is still removed.

Return Value

Script

Object. Returns the node that was removed, or Null if there is no nextNode Method (IXMLDOMNamedNodeMap) to remove. If the parameter is Null, the removed node is not returned, but is still removed.

C/C++

• S_OK
  Value returned if the method is successful.

• S_FALSE
  Value returned if no nodes left in the selection.

• E_PENDING
  Value returned if all nodes cannot be found at this time (in which case no nodes are removed).

Remarks

The removeNext method is equivalent to the following (except that it also works for attributes).

var node = list.peekNode();
node.parentNode.removeChild(node);

The side effect is that the length of the collection is decremented and the nextNode and item methods will not return it because it has been removed.

This method applies to the following interface:

IXMLDOMSelection.

Requirements

See Also

Reference

XML DOM Methods