@events = $session->getExplains($object, $eventname[, $onehop ]);
MODEL developers can add information to a problem in order to emphasize events that occur because of a problem. The getExplains() function returns a list of these events.
The $onehop parameter is optional:
If it is omitted or passed as FALSE, the full list of problems that explain $eventname, whether directly or indirectly, is returned.
If it is passed as TRUE, only those problems that directly list eventname among the events they explain are returned.
The function returns an array of array references with the format:
[ [ <classname::instancename>,<problemname> ], [ <classname::instancename>,<problemname> ], ... ]