假使将 Elisp 的利用场景固定为文本处理，学习 Elisp，我认为无需像学习其余任何一门编程语言那样亦步亦趋，所以本章间接从文件读写开始动手，通过一些小程序，建设对 Elisp 语言的初步感触。

Hello world!

尽管我已决定从文件读写开始学习 Elisp，然而我还是心愿对初学者敌对一点，毕竟我也是初学者。这种敌对应该像学习任何一门编程语言那样，从写一个可能输入 Hello world! 的程序。

用 Emacs 新建一份文本文件，名曰 hello-world.el。当然，也能够应用其余文本编辑器实现此事，然而要保证系统已装置了 Emacs 且可用。hello-world.el 的内容只有一行：

(princ "Hello world!")

在终端（或命令行窗口）里，将工作目录（当前目录）切换至 hello-world.el 文件所在的目录，而后执行

$ emacs -Q --script hello-world.el

终端会随即显示

Hello world!

从这个 Hellow world 程序里，能学到哪些 Elisp 常识呢？

首先，princ 是一个函数，确切地说，是 Elisp 的内建函数。什么是函数？在数学里，y=f(x) 是函数，f 可将 x 映射为 y。princ 也是这样的函数，它将 "Hello world! 这个对象映射为显示于终端的对象。

其次，"Hello world!" 是 Elisp 的字符串类型，用于示意一段文本。文本是数据。数据未必是文本。若将 Elisp 作为用于解决文本的语言，字符串就是根本且外围的数据类型。

最初，这个作为示例的 Elisp 程序的最小单位是一个函数调用。我向 princ 函数提供一个字符串类型的值，便可令其工作，且足以形成一个程序。Emacs 里有 Elisp 解释器。Elisp 程序是由 Elisp 解释器解释运行的，相似于计算机程序是由计算机的 CPU「解释」运行。换言之，Elisp 解释器可能读懂 Elisp 程序，并实现这个程序所形容的那些工作，例如，在终端里输入 Hello world!。

定义一个新的函数

hello-world.el 程序尽管能在终端里输入 Hello world!，然而它的输入很容易令终端有所错乱，例如将我的终端弄成了上面这幅样子：

这是因为，princ 函数仅仅是将字符串类型的数据原样输入。若让终端放弃有序，输入的文本开端需附加一个换行符 \n。尽管批改 princ 的定义实现此事仿佛甚为艰难，然而站在它的肩膀上定义一个新的函数实现此事，则甚为简略：

(defun princ\' (x)
  (princ x)
  (princ "\n"))

(princ\'"Hello world!")

princ\' 便是我定义的新函数。我本来想应用 princ' 这个名字，然而符号 ' 已被 Elisp 语言作为一个有非凡语意的符号，因而我不得不应用 Elisp 语言的字符本义符 \ 对 ' 进行本义，表明后者无非凡含意，仅仅是一个符号。

定义一个函数，遵循的格局是

(defun 函数名 ( 参数)
  函数体 )

函数体由一个或一组表达式形成。在 princ\' 的定义中，函数体由两个表达式形成。

运行新的 hello-world.el 程序，后果如下图所示：

缓冲区

假如存在文本文件 foo.txt，其内容为

Hello world!

如何写一个 Elisp 程序，从 foo.txt 读取全部内容并输入到终端？

读取文件，这个操作意味着什么？意味着从计算机辅存（硬盘）中获取数据，放入主存（内存）。起因在于，计算机 CPU 拜访主存的速度远快于辅存。

为了简化文件的读写，Elisp 提供一种数据类型——缓冲区（Buffer）。缓冲区对象（也可称为缓冲区实例）实质上是计算机主存里的一段空间。文件的内容被读取后，存入缓冲区实例里，在后者中可进行文件内容的编辑工作。编辑结束后，缓冲区实例蕴含的信息能够再存回文件。为了便于形容，在不至于引起误会的前提下，我会将缓冲区实例简称为缓冲区。相似的称呼也实用于 Elisp 的其余数据类型上，例如数字、字符串、列表、数组、哈希表等。

应用 Elisp 函数 generate-new-buffer 能够创立一个有名字的缓冲区。例如，创立一个名曰 foo 的缓冲区：

(generate-new-buffer "foo")

能创立一个，就能创立多个，然而无论创立了多少个，其中只可能有一个是激活的，亦即以后缓冲区。在读取文件时，从文件获取的数据总是寄存在以后缓冲区内。Elisp 函数 buffer-name 能够取得以后缓冲区的名字。以下程序可查看以后缓冲区的名字：

(princ\' (buffer-name))

Elisp 解释器有一个默认的缓冲区，名字叫 *scratch*。假使没有创立新的缓冲区并将其激活为以后缓冲区，那么上述程序的输入就是 *scratch*。

Elisp 函数 set-buffer 可将指定的缓冲区设为以后缓冲区。例如，上面这个程序可将上文创立的 foo 缓冲区设为以后缓冲区，并通过输入以后缓冲区的名字它是否为以后缓冲区：

(set-buffer "foo")
(princ\' (buffer-name))

set-buffer 的参数除了能够是缓冲区的名字，也能够是缓冲区自身。因为 generate-new-buffer 可能返回它创立的新缓冲区，因而它能够与 set-buffer 函数复合，用于创立一个缓冲区并将其设为以后的缓冲区，例如

(set-buffer (generate-new-buffer "foo"))

将上述代码综合一下，能够放在一个名字叫 foo.el 的文本文件里。foo.el 内容为

(defun princ\' (x)
  (princ x)
  (princ "\n"))

(princ\' (buffer-name))

(set-buffer (generate-new-buffer "foo"))
(princ\' (buffer-name))

在终端里，若以 foo.el 所在目录为工作目录，执行

$ emacs -Q --script ./foo.el

输入为

*scratch*
foo

这是我写的第二个 Elisp 程序，感觉还不错。别的编程语言里，可能没有缓冲区这种设施。没有比照，就没有挫伤。没有挫伤，就没有骄傲。

文件读取

对于上一节一开始所提出的问题，事实上并不需要我去为待读取的文件创建一个缓冲区，并将其设为以后缓冲区。Elisp 提供的 find-file 能够替我实现这项工作。例如，

(find-file "foo.txt")
(princ\' (buffer-name))

所产生的输入为

foo.txt

这个名曰 foo.txt 的缓冲区，便是 find-file 函数为 foo.txt 文件而创立的。

如何确认 foo.txt 文件里的内容真的被读取后寄存到 foo.txt 缓冲区呢？可通过 buffer-string 函数以字符串的模式取得以后缓冲区存储的数据，而后将所得结果显示于终端，例如

(princ\' (buffer-string))

因而，读取 foo.txt 文件里的内容，并将其显示于终端的程序至此便实现了。残缺的程序如下：

(defun princ\' (x)
  (princ x)
  (princ "\n"))

(find-file "foo.txt")
(princ\' (buffer-string))

代码格调

Elisp 代码，只有不毁坏名字，它的格调是很随便的。例如 princ\' 函数的定义，写成

(defun princ\'(x) (princ x) (princ"\n"))

也是能够的。

写成

(defun
    princ\'
    (x)
  (princ
   x)(princ
       "\n"))

也不是不行。然而，最好不要写怪异的代码。毕竟，那层层括号的嵌套，人生曾经很不容易了。

括号无论是内层的，还是外层的，它们总是成对呈现。Lisp 语言最大特点就是，无论是函数的定义，还是函数的调用，还是其余的一些表达式，在模式上是由括号形成的嵌套构造。这种构造，Lisp 语言称为列表。

如果应用 Emacs 编写 Elisp 代码或其余 Lisp 方言的代码，要记得装置 paredit 包。我不想浪费时间去讲如何装置和应用这个包。不齐全是因为没人给我发稿费，次要是每个人都应该会用网络搜索引擎。

在缓冲区内插入文本

无论是用 find-file 函数主动创立的缓冲区，还是基于 generate-new-buffer 创立的缓冲区，一旦它们被设定为以后缓冲区，便能够应用 Elisp 提供的一些函数，将数据写入其中。

insert 函数可将字符串类型的数据写入以后缓冲区，例如：

(defun princ\' (s)
  (princ (concat s "\n")))
  
(find-file "foo.txt")
(insert "|||")
(princ\' (buffer-string))

输入后果为

|||Hello world!

可见 insert 函数将 ||| 插入到了以后缓冲区存储的文本数据的首部。这是因为，以后缓冲区内存在这一个不可见的光标，我将其称为插入点，它对应于 Emacs 图形窗口里一直闪动的那个光标，示意文本的插入点。在应用 find-file 关上一份文件时，插入点会主动定位在文件的结尾，坐标为 1。为了了解插入点，就须要将缓冲区想像成一维数组，寄存的元素为字符，这个一维数组就像一根很长的纸带那样，插入点的坐标就是插入点位于第几个字符之前。

point 函数能够取得插入点的坐标。例如

(find-file "foo.txt")
(princ (point))

输入 1。

goto-char 函数可将插入点挪动到缓冲区内的任何地位。例如，假使将 ||| 插入 Hello world! 的两个单词的两头，只需

(find-file "foo.txt")
(goto-char 6)
(insert "|||")

因为函数 point-min 和 point-max 能够取得缓冲区的起止地位，因而可基于它们将插入点挪动到缓冲区的结尾或结尾。例如，将 ||| 插入到 Hello world! 的尾部：

(find-file "foo.txt")
(goto-char (point-max))
(insert "|||")

在此，兴许应该提出一个疑难，为何须要用 point-min 取得缓冲区起始地位？难道这个地位不是 1 吗？因为在缓冲区外部能够创立更小的部分区域，而它也是 Elisp 的一种数据类型，它的名字叫 Narrowing。对于位于 Narrowing 区域的文本，也能够用 point-min 和 point-max 获取起止地位，故而 point-min 取得的后果未必是 1。对于 Narrowing，它在 Emacs 图形界面里较为有用，在应用 Elisp 编写文本处理程序方面，我临时还没思考出它的利用场景。

在缓冲区内删除文本

Elisp 函数 delete-char 能够删除插入点之后的字符。例如，以下程序将 foo.txt 读入缓冲区后，插入点尚在缓冲区起始地位时，删除它前面 5 个字符，

(find-file "foo.txt")
(delete-char 5)

Elisp 也提供了一些与插入点地位无关的缓冲区文本删除函数，其中 delete-region 能够删除落入指定区间的文本。例如，删除缓冲区内第 6 个字符到第 12 个字符之间的字符，被删除的字符包含前者，但不包含后者，

(find-file "foo.txt")
(delete-region 6 12)

能够应用 (princ\' (buffer-string)) 查看缓冲区内容的变动。

将缓冲区内容写入文件

当初，曾经根本把握了从文件读取内容到缓冲区，在缓冲区内写入一些内容，接下来，须要思考的一个问题是，缓冲区的内容该如何保留到文件里。保留形式天然有两种，一种是保留到与以后缓冲区关联的文件，另一种是保留到其余文件。

save-buffer 可将以后缓冲区保留到与之关联的文件里。例如

(find-file "foo.txt")
(goto-char (point-max))
(insert "|||")
(save-buffer)

运行上述程序后，可关上 foo.txt 文件查看其内容，是否在 Hello world! 之后多出了 |||。

write-file 可将以后缓冲区保留到其余文件。例如

(find-file "foo.txt")
(goto-char (point-max))
(insert "|||")
(write-file "bar.txt")

结语

本章的内容尽管较为简单，然而曾经隐约涉及了 Emacs 的一些实质。假使了解并相熟了本文呈现的所有 Elisp 曾经提供的函数的用法，相当于把握了 Emacs 最奢侈的性能，即关上一份文件，增加一些内容，删除一些内容，而后保留，并不需要一个图形界面帮忙咱们实现这些事。

文中所呈现的函数，除 princ\' 之外，我将其余所有函数说成 Elisp 提供的，甚至一度想将它们称为 Elisp 规范库里的函数。但事实上，Elisp 只是一门语言，而且也不存在这个规范库。这些函数皆来自于 Emacs 的外围性能——数量宏大的函数集，扩散于泛滥 Elisp 源程序文件。我将这些函数统称为 Elisp 函数。

在 Emacs 里默认的键绑定 C-h f，而后输出其中的某个函数名，回车，Emacs 便会关上该函数的文档。在文档里，函数的用处、参数以及返回后果皆有具体的阐明。一开始，看不懂，也不大要紧，要害是要去看。