该函数返回一个向量,包含最近 300 次来自键盘或鼠标的输入事件。所有输入事件均被包含,无论是否构成按键序列。因此始终返回最近 300 次事件,键盘宏生成的事件除外(此类事件对调试意义较低,只需查看调用宏的事件即可)。
若 include-cmds 非 nil,结果向量中的完整按键序列会与形如 (nil . COMMAND) 的伪事件交错排列,其中 COMMAND 为该按键序列的绑定命令(see 命令循环概述)。
调用 clear-this-command-keys(see 来自命令循环的信息)后,该函数会立即返回空向量。
该函数打开名为 filename 的 记录文件(dribble file)。记录文件开启后,所有来自键盘或鼠标的输入事件(键盘宏除外)均会写入该文件。非字符事件会以带 ‘<…>’ 的打印形式表示。注意敏感信息(如密码)可能被记录在该文件中。
传入参数 nil 可关闭记录文件。
另请参见函数 open-termscript(see 终端输出)。