23.1.1 运行钩子

在本节中，Emacs 记录了run-hooks用于运行普通钩子的函数。同时还记录了运行各种异常钩子的函数。

Function: run-hooks &rest hookvars

该函数将一个或多个普通钩子变量名作为参数，并依次运行每个钩子。每个参数应该是一个符号，它是一个普通的钩子变量。这些参数按指定的顺序运行处理。

如果钩子变量具有非nil值，也是函数列表。run-hooks一一不带参数的调用所有函数。

钩子变量的值也可以是单个函数——一个 lambda 表达式或一个具有函数定义的符号。但是这种用法已经过时了。

如果钩子变量是缓冲区局部性，那么run-hooks 会使用缓冲区局部变量而不是全局变量。但是，如果缓冲区局部变量包含元素 t，则全局钩子变量也将运行。

Function: run-hook-with-args hook &rest args

此函数调用钩子中的所有异常函数，并向每个异常函数传递参数ARGS。

Function: run-hook-with-args-until-failure hook &rest args

此函数通过依次调用每个钩子函数来运行异常钩子，直到其中一个函数调用失败。每个钩子函数都会被传递参数args。如果这个函数因为某个钩子函数执行失败而停止，它返回nil；否则它返回一个非nil值。

Function: run-hook-with-args-until-success hook &rest args

此函数通过依次调用每个钩子函数来运行异常钩子，直到其中一个函数调用成功。每个钩子函数都会被传递参数args。如果这个函数因为某个钩子函数执行成功而停止，它返回nil；否则它返回一个非nil值。