NAME

present() - find an object by id

SYNOPSIS

object present(mixed str, object ob)

DESCRIPTION

If an object that identifies to the name `str' is present, then return it.

`str' can also be an object, in which case the test is much faster and easier.

The object is searched for in the inventory of the current object, and in the inventory of the environment of the current object.

A second optional argument `ob' is the enviroment where the search for the `str' is done. Normally "this_player()" is a good environment.

SEE ALSO

move_object(3) , environment(3) .