1 简介

在本手册中

• 短语 Lisp reader 和 Lisp printer 指的是 Lisp 中将 Lisp 对象的文本表示形式转换为实际 Lisp 对象的那些例程，反之亦然

  有关详细信息，请参阅打印表示和读取语法
  

• 你，阅读本手册的人，被认为是 程序员，被称为 你
• 用户是使用 Lisp 程序的人，包括您编写的程序

Lisp 代码示例 的格式如下：

(list 1 2 3)

代表元句法 变量的名称 ，或所描述 函数的参数 ，格式如下：

first-number 

在 Emacs Lisp 中，符号 nil 具有三种不同的含义：

1. 它是一个名称为 nil 的 符号
2. 是 逻辑真值 假
3. 它是一个 空列表 零元素的列表

当用作变量时， nil 始终具有 nil 值

就 Lisp 阅读器而言， () 和 nil 是相同的：它们代表同一个对象， 符号 nil

书写符号的不同方式完全适用于人类读者。在 Lisp 阅读器读取 () 或 nil 之后，无法确定程序员实际编写的表示形式

在本手册中：

• 当我们想强调它表示空列表时，我们写 ()
• 当我们想强调它表示真值 false 时，我们写 nil

(cons 'foo ())                ; Emphasize the empty list
(setq foo-flag nil)           ; Emphasize the truth value false

这也是在 Lisp 程序中使用的一个很好的约定

在期望真值的情况下， 任何非零值 都被认为是 真值 。但是， t 是表示 真值 true 的首选方式 。当你需要选择一个代表真实的值，并且没有其他选择依据时，使用 t 。符号 t 始终具有值 t

在 Emacs Lisp 中， nil 和 t 是特殊符号，它们总是对自己求值

这样您就不需要引用它们来将它们用作程序中的常量

尝试更改它们的值会导致设置常量错误。请参阅永不改变的变量

您可以评估的 Lisp 表达式 称为 形式 form 。计算一个 形式 ( form ) 总是会产生一个 结果 ，它是一个 Lisp 对象 。在本手册的示例中，这用 ⇒ 表示：

(car '(1 2))
⇒ 1

您可以将其解读为 (car '(1 2)) 计算结果为 1

当一个 形式 ( form ) 是一个 宏调用 时，它会 扩展 为一个 新的 形式 ( form ) 供 Lisp 计算。我们用 → 显示扩展的结果。我们可能会或可能不会显示扩展 形式 ( form ) 的评估结果

(third '(a b c))
→ (car (cdr (cdr '(a b c))))
⇒ c

为了帮助描述一种 形式 ( form ) ，我们有时会展示另一种产生相同结果的 形式 ( form ) 。两种 形式 ( form ) 的 精确等价 用 ≡ 表示

(make-sparse-keymap) ≡ (list 'keymap)

本手册中的许多示例在评估时都会打印文本

如果您通过在示例的右括号后键入 C-j 在 Lisp 交互缓冲区（例如缓冲区 *scratch*）中执行示例代码，则打印的文本将插入到缓冲区中

如果您通过其他方式执行示例（例如通过评估函数 eval-region ），则打印的文本将显示在回显区域中

本手册中的示例用 -| 表示打印文本，无论该文本位于何处。通过评估表单返回的值在单独的行后面加上 ⇒

(progn (prin1 'foo) (princ "\n") (prin1 'bar))
-| foo
-| bar
⇒ bar

一些示例表明错误。这通常会在 回显区域 中显示错误消息。我们在以 error→ 开头的行上显示错误消息

(+ 23 'x)
error→ Wrong type argument: number-or-marker-p, x

请注意， error→ 本身不会出现在回显区域中

一些示例通过显示文本的前后版本来描述对缓冲区内容的修改。这些示例显示了 包含缓冲区名称的两行破折号之间 的缓冲区内容。此外， * 表示点的位置

---------- Buffer: foo ----------
This is the ∗contents of foo.
---------- Buffer: foo ----------

(insert "changed ")
⇒ nil
---------- Buffer: foo ----------
This is the changed ∗contents of foo.
---------- Buffer: foo ----------

当然，点的符号不是缓冲区中文本的一部分；它表示点当前所在的两个字符之间的位置

本手册以统一的格式描述了 函数 、 变量 、 宏 、 命令 、 用户选项 和 特殊形式 ：

• 描述的第一行包含 项目的名称 ，后跟其 参数 （如果有）
• 类别（函数、变量或其他）出现在行首
• 描述在随后的行中
• 有时带有示例

这个函数返回一个描述正在运行的 Emacs 版本的字符串。在错误报告中包含此字符串很有用

(emacs-version)
⇒ "GNU Emacs 26.1 (build 1, x86_64-unknown-linux-gnu,
             GTK+ Version 3.16) of 2017-06-01"

如果 here 不是 nil ，则将文本插入缓冲区中的 point 之前，并返回 nil 。当这个函数被交互调用时，它会在回显区域打印相同的信息，但是给出一个前缀参数使得这里非零

这个变量的值表示 Emacs 的构建时间。它使用当前时间的样式（参见时间），如果信息不可用，则为 nil

emacs-build-time
⇒ (20614 63694 515336 438000)

这个变量的值是正在运行的 Emacs 的版本。它是一个字符串，例如 26.1 。具有三个数字分量的值，例如 26.0.91 ，表示未发布的测试版本

在 Emacs 26.1 之前，字符串包含一个额外的 final 组件，其整数现在存储在 emacs-build-number 中；例如， 25.1.1 

Emacs 的主版本号，以整数表示。对于 Emacs 版本 23.1 ，该值为 23

Emacs 的次要版本号，为整数。对于 Emacs 版本 23.1 ，该值为 1

每次在同一目录中构建 Emacs 时递增的整数（无需清理）。这仅在开发 Emacs 时具有相关性

一个字符串，它给出了构建 Emacs 的代码库版本。如果 Emacs 是在版本控制之外构建的，则该值为 nil

一个字符串，它给出了构建 Emacs 的代码库分支。在大多数情况下，这是 master 。如果 Emacs 是在版本控制之外构建的，则该值为 nil