axl main logo
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Modules Pages
axlNode * axl_node_find_called ( axlNode parent,
const char *  name 

Allows to find the first child called name, inside all childs (including its descendants) held by the parent provided.

This function is similar to axl_node_get_child_called but though it will also look for a child node called as provided not only in direct childs but also on its all descendants.

If you are looking for a function to search for a particular child node inside direct childs stored for the provided parent, then you must use axl_node_get_child_called.

There is also a convenience function that allows to perform a lookup using as a reference a document (using the root node from it): axl_doc_find_called.

NOTE: This function isn't XML Namespace aware. You must use axl_ns_node_find_called instead. See axl_ns_doc_validate.

parentThe parent where the lookup will be produced.
nameThe name of the child to be looked up.
A reference to the node found (first instaned matching the name) or NULL if it fails to find a child. Do not release (axl_node_free) result returned by this function. It is a reference to the internal document.

References axl_node_get_first_child(), axl_node_get_next(), and NODE_CMP_NAME.