runic_obj_t runic_node_left(runic_obj_t ro);

The above function signature outlines the operation regarding the access of the left child of a NODE.

Arguments:

ro – A runic_obj_t of type NODE that was returned as a result of a successful runic_alloc, runic_root, node_left or node_right operation. Meaning, this object will have an initialized base pointer and an offset greater than or equal to DEFAULT_ROOT as defined in dependencies. Using an uninitialized ro is an invalid operation and the program will likely return an invalid runic_obj_t as described in runic_root().

Returns:

On a successful operation, this function will return the child runic_obj_t from the object ro, on its left subtree, if any exist. If none exist, it will print a warning to console, return a runic_obj_t with a NULL pointer and an offset of 0 (returning an invalid runic_obj_t). If an invalid runic_obj_t is supplied in the argument, an invalid runic_obj_t is returned.