efun: command

SYNOPSIS:

        int command(string str)
        int command(string str, object ob)

DESCRIPTION:

        Execute str as a command given directly by the user. Any
        effects of the command will apply to the current object,
        or to the given <ob>ject.

        Return value is 0 for failure. Otherwise a numeric value is
        returned which tells the evaluation cost. Bigger number means
        higher cost.  The evaluation cost is approximately the number
        of LPC machine code instructions executed.

        If command() is called on another object, it is not possible
        to call static functions in this way, to give some protection
        against illegal forces.

        Commands are stacked, meaning that after the given command <str>
        has finished, the old settings of this_player(), query_verb()
        etc, are restored.

HISTORY:

        Up to 3.2.6 in native mode, commands could be applied to the current
        object only.
        Since 3.2.7, commands are stacked.

SEE ALSO:

	
	command_stack(E), notify_fail(E), enable_commands(E), get_eval_cost(E)