Next: , Previous: , Up: Tree methods   [Contents]

16.2 Creating a new tree iterator

Function: Marpa_Tree marpa_t_new (Marpa_Order o)

Creates a new tree iterator, with a reference count of 1. The reference count of its parent ordering object, o, is increased by 1.

When initialized, a tree iterator is positioned before the first parse tree. To position the tree iterator to the first parse, the application must call marpa_t_next().

Return value: On success, a newly created tree. On failure, NULL.