24.1.1 运行钩子

本节介绍用于运行标准钩子的 run-hooks 函数,同时也说明运行各类非标准钩子的相关函数。

Function: run-hooks &rest hookvars

该函数接收一个或多个标准钩子变量名作为参数,并依次运行每个钩子。每个参数都应为表示标准钩子变量的符号。参数将按指定顺序处理。

若钩子变量的值非 nil,则该值应为一个函数列表。run-hooks 会依次无参数调用列表中的所有函数。

钩子变量的值也可以是单个函数—可以是 lambda 表达式或带有函数定义的符号—run-hooks 同样会调用该函数。但这种用法已被废弃。

若钩子变量为缓冲区局部变量,则会使用该局部变量而非全局变量。但如果局部变量中包含元素 t,则全局钩子变量也会一并运行。

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

该函数运行一个非标准钩子,依次调用 hook 中的所有钩子函数,并将参数 args 传递给每个函数。

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

该函数运行一个非标准钩子,依次调用各个钩子函数,若某个函数返回 nil 表示执行失败则停止运行。 所有函数均接收参数 args。若因函数执行失败而停止,该函数返回 nil;否则返回非 nil 值。

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

该函数运行一个非标准钩子,依次调用各个钩子函数,若某个函数返回非 nil 值表示执行成功则停止运行。 所有函数均接收参数 args。若因函数执行成功而停止,则返回该函数的返回值;否则返回 nil

emacs

Emacs

org-mode

Orgmode

Donations

打赏

Copyright

© Jasper Hsu

Creative Commons

Creative Commons

Attribute

Attribute

Noncommercial

Noncommercial

Share Alike

Share Alike