以 str 代替系统在命令无效时返回的错误消息 :「什么 ?」当 add_action()
设定的动作返回 0 时, 就会显示此段 str 的消息. 使用 notify_fail() 显示错误消息是一个比较好的方法,
因为此函数允许其他的物件能对同一个命令作出反应. 别用 write() 来显示一段错误消息,
因为这样做需要返回 1. ( 除非你想在看到「什么 ?」之后再看到 write() 的结果
) 如果你返回 1, 其他的物件就没有机会对使用者的命令作出反应.
如果参数用的是一个函数指针, 则会调用指定的函数. 如果此函数返回一个字符串,
此字符串就会当作错误消息. 只要在此函数中正确地设定 this_player(), 就可以使用
write().
如果 notify_fail() 被调用一次以上, 只有最后一次的调用有效.
这个函数主要是返回比「什么 ?」要来得清楚的错误消息.