| SYNOPSIS |
| #include <sys/driver_hooks.h> |
| |
| set_driver_hook(H_SEND_NOTIFY_FAIL, value) |
| |
| <value> being: |
| |
| void <name>(string msg, object msgobj, object orig_cmd_giver) |
| void <closure>(string msg, object msgobj, object orig_cmd_giver) |
| |
| DESCRIPTION |
| Optional hook to send the notify fail message, regardless |
| of how it was determined, to the player. If the hook is not |
| set, the message is delivered using tell_object() internally. |
| Hook setting can be a string or a closure. |
| |
| If the hook is a string, it is the name of a (possibly static) |
| function to call in the current command giver. If the hook |
| is a closure, it is the function to be called. Lambda closures |
| are bound to the current command giver first. |
| |
| The arguments to the call are: |
| - <msg> is the notify fail message to be delivered. |
| - <msgobj> is the object which set the message. It is 0 for |
| the default message. |
| - <orig_cmd_giver> is the object for which the original |
| command was first received. It is usually identical with |
| the current command giver this_player(). |
| |
| HISTORY |
| |
| SEE ALSO |
| hooks(C), command(H), modify_command(H), modify_command_fname(H), |
| notify_fail(H) |