efun: all_environment

SYNOPSIS:

        object *all_environment()
        object *all_environment(object o)

DESCRIPTION:

        Returns an array with all environments object <o> is in. If <o> is
        omitted, the environments of the current object is returned.

        If <o> has no environment, or if <o> is destructed, 0 is returned.

EXAMPLE:

        If o is a match in a matchbox which is in a box in a chest,
        in a room, all_environment(o) will return
        ({ matchbox, box, chest, room }).

HISTORY:

        Introduced in LDMud 3.2.6, suggested by TubMud.

SEE ALSO:

	
	environment(E), all_inventory(E)