VMS Help RTL Routines, LIB$, LIB$TRAVERSE_TREE_64  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    (Alpha only.) The Traverse a Balanced Binary Tree routine calls
    an action routine for each node in a binary tree.

    Format

      LIB$TRAVERSE_TREE_64  treehead ,user-action-procedure

                            [,user-data-address]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 treehead

    OpenVMS usage:address
    type:         address
    access:       read only
    mechanism:    by reference

    Tree head of the binary tree. The treehead argument is the
    address of an unsigned quadword that is the tree head in the
    binary tree traversal.

 user-action-procedure

    OpenVMS usage:procedure
    type:         procedure value
    access:       function call (before return)
    mechanism:    by value

    User-supplied action routine called by LIB$TRAVERSE_TREE_64 for
    each node in the tree. The user-action-procedure argument must
    return a success status for LIB$TRAVERSE_TREE_64 to continue
    traversal.

 user-data-address

    OpenVMS usage:user_arg
    type:         quadword (unsigned)
    access:       read only
    mechanism:    by reference

    User data that LIB$TRAVERSE_TREE_64 passes to your action
    routine. The user-data-address argument contains the address of
    this user data. This is an optional argument; the default value
    is 0.