NAME

add_action() - bind a command verb to a local function

SYNOPSIS

void add_action( string fun, string cmd, int flag );

DESCRIPTION

Set up a local function to be called when user input matches the command . Functions called by a player command will get the arguments as a string. It must then return 0 if it was the wrong command, otherwise 1.

If it was the wrong command, the parser will continue searching for another command, until one returns true or give error message to player.

For example, there can be a wand and a rod. Both of these objects define add_verb("wave"). One of them will be randomly called first, and it must look at the argument, and match against "wand" or "rod" respectively.

If the second argument () is not given, it must be given by add_verb(). Support of add_verb() is of historical reasons.

Always have add_action() called only from an init() routine. The object that defines commands must be present to the player, either being the player, being carried by the player, being the room around the player, or being an object in the same room as the player.

If argument is 1, then only the leading characters of the command has to match the verb .

Never define an action that will call the function exit(), because it is a special function.

SEE ALSO

query_verb(3) , add_verb(3) , init(l) , exit(l)