Function xml-get-first-element-named

xml-get-first-element-named root name

Retrieves the first child node that is an element with a given tag name.

Parameters:

root - The element among whose child nodes an element will be looked for.

name - The tag name of the element to look for.

Returns:

The first child node of root that is an element with the given tag name. Null if root has not an element with that tag name among its children nodes.

Looks among the child nodes of the root element and locates the first occurrence of an element with a tag name of name.

This function is usefull to retrieve a known occurrence of an element that might be surrounded by text nodes or other elements.