public size_t n_children ()
Queries the number of child items in the container that we are iterating over.
This is the total number of items -- not the number of items remaining.
This function might be useful for preallocation of arrays.
the number of children in the container