Notify fail

来自MudWiki

名称

   notify_fail - 传回一段错误讯息

语法

   int notify_fail( string | function str );

描述

   取代通过 add_action() 外部函数设置的默认错误消息,将 `str` 存为要返回的错误消息。这是一种比较好的显示错误消息的方式,因为这个函数允许其它对象继续响应这个指令。请不要使用 write() 显示错误消息,因为这样做会要求函数返回 1,除非你想在 write() 返回的消息后看到运行时配置文件中设置的 `default fail message`,而如果直接返回 1,又会让其它对象失去了响应这个指令的机会。

   如果参数使用函数指针,会调用这个函数,如果函数返回一个字符串,这个字符串会做为指令执行失败的消息。只要正确的设置 this_player(),在函数中也可以使用 write()。

   如果 notify_fail() 调用多次,仅最后一次呼叫有效。

   这个函数可以在指令执行失败时传回更友好的错误提示。

返回值

   notify_fail() 永远返回 0。

翻译

   雪风(i@mud.ren)