XML Get First Iterator Position

Given a node list iterator pointing to any location in a node list, this XML tool returns an iterator that points to the first location in that node list.

Note: This tool does not modify the iterator given as an argument. Instead, it returns a new iterator pointing to the first item of the same collection as the argument. If you specify the same variable as an output argument that you also specified as input, the iterator will effectively reset back to the first position.

Inputs

Node Iterator First

Node list iterator, may point to any location in node list.

Outputs

Node Iterator

Node list iterator pointing to first location in the list.

Count

Number of nodes in the node list.

Exit Paths

Success

This path is taken if the child nodes were successfully retrieved.

End

This path is taken if the node output retrieves a value of NULL, indicating that iteration is complete.

Failure

This path is taken if the operation fails.