previous_object

NAME

previous_object() - returns the object(s) that called the current func‐
tion

SYNOPSIS

mixed previous_object( int | void );

DESCRIPTION

Returns an object pointer to the object, if any,  that  called  current
function.   Note that local function calls do not set previous_object()
to the current object, but leave it unchanged.  If  passed  a  positive
integer, it goes back the given number of previous objects in the call‐
ing chain.  previous_object(0) is the same as previous_object(), previ‐
ous_object(1)  is the previous object's previous_object(), etc.  previ‐
ous_object(-1) returns an array containing all of the previous objects.

SEE ALSO

call_other(3), call_out(3), origin(3)