# children qname iterator
[AXIOM]

## Functions
AXIS2_EXTERN axiom_children_qname_iterator_t * | axiom_children_qname_iterator_create (const axutil_env_t *env, axiom_node_t *current_child, axutil_qname_t *given_qname)
AXIS2_EXTERN void | axiom_children_qname_iterator_free (axiom_children_qname_iterator_t *iterator, const axutil_env_t *env)
AXIS2_EXTERN axis2_status_t | axiom_children_qname_iterator_remove (axiom_children_qname_iterator_t *iterator, const axutil_env_t *env)
AXIS2_EXTERN axis2_bool_t | axiom_children_qname_iterator_has_next (axiom_children_qname_iterator_t *iterator, const axutil_env_t *env)
AXIS2_EXTERN axiom_node_t * | axiom_children_qname_iterator_next (axiom_children_qname_iterator_t *iterator, const axutil_env_t *env)

## Function Documentation

AXIS2_EXTERN void axiom_children_qname_iterator_free | ( | axiom_children_qname_iterator_t * | iterator,
|  | const axutil_env_t * | env |
| ) |  |  |

free om_children_qname_iterator struct

Parameters:

  | iterator | a pointer to axiom children iterator struct
  | env | environment, MUST NOT be NULL

AXIS2_EXTERN axis2_bool_t axiom_children_qname_iterator_has_next | ( | axiom_children_qname_iterator_t * | iterator,
|  | const axutil_env_t * | env |
| ) |  |  |

Returns `true` if the iteration has more elements. (In other words, returns `true` if `next` would return an axiom_node_t struct rather than null with error code set in environment

Parameters:

  | iterator | a pointer to axiom children iterator struct
  | env | environment, MUST NOT be NULL

AXIS2_EXTERN axiom_node_t* axiom_children_qname_iterator_next | ( | axiom_children_qname_iterator_t * | iterator,
|  | const axutil_env_t * | env |
| ) |  |  |

Returns the next element in the iteration.

Parameters:

  | iterator | a pointer to axiom children iterator struct
  | env | environment, MUST NOT be NULL

AXIS2_EXTERN axis2_status_t axiom_children_qname_iterator_remove | ( | axiom_children_qname_iterator_t * | iterator,
|  | const axutil_env_t * | env |
| ) |  |  |

Removes from the underlying collection the last element returned by the iterator (optional operation). This method can be called only once per call to `next`. The behavior of an iterator is unspecified if the underlying collection is modified while the iteration is in progress in any way other than by calling this method.

Parameters:

  | iterator | a pointer to axiom children iterator struct
  | env | environment, MUST NOT be NULL