41-操作系统接口.texi

\input texinfo    @c -*- texinfo -*-
@c %**start of header
@setfilename 41-操作系统接口.info
@settitle 
@documentencoding UTF-8
@documentlanguage en
@c %**end of header

@finalout
@titlepage
@title 
@author zunrong
@end titlepage

@contents

@ifnottex
@node Top
@top 
@end ifnottex

@menu
* 41 操作系统接口::

@detailmenu
--- The Detailed Node Listing ---

41 操作系统接口

* 41.1 启动 Emacs: 411 启动 Emacs. 
* 41.2 退出 Emacs: 412 退出 Emacs. 
* 41.3 操作系统环境: 413 操作系统环境. 
* 41.4 用户识别: 414 用户识别. 
* 41.5 时间: 415 时间. 
* 41.6 时区规则: 416 时区规则. 
* 41.7 时间转换: 417 时间转换. 
* 41.8 解析和格式化时间: 418 解析和格式化时间. 
* 41.9 处理器运行时间: 419 处理器运行时间. 
* 41.10 时间计算: 4110 时间计算. 
* 41.11 延迟执行的定时器: 4111 延迟执行的定时器. 
* 41.12 空闲定时器: 4112 空闲定时器. 
* 41.13 终端输入: 4113 终端输入. 
* 41.14 终端输出: 4114 终端输出. 
* 41.15 声音输出: 4115 声音输出. 
* 41.16 X11 Keysyms 上的操作: 4116 X11 Keysyms 上的操作. 
* 41.17 批处理模式: 4117 批处理模式. 
* 41.18 会话管理: 4118 会话管理. 
* 41.19 桌面通知: 4119 桌面通知. 
* 41.20 文件更改通知: 4120 文件更改通知. 
* 41.21 动态加载的库: 4121 动态加载的库. 
* 41.22 安全考虑: 4122 安全考虑. 

41.1 启动 Emacs

* 41.1.1 小结：启动时的动作顺序: 4111 小结：启动时的动作顺序. 
* 41.1.2 初始化文件: 4112 初始化文件. 
* 41.1.3 终端特定初始化: 4113 终端特定初始化. 
* 41.1.4 命令行参数: 4114 命令行参数. 

41.2 退出 Emacs

* 41.2.1 杀死 Emacs: 4121 杀死 Emacs. 
* 41.2.2 挂起 Emacs: 4122 挂起 Emacs. 

41.13 终端输入

* 41.13.1 输入模式: 41131 输入模式. 
* 41.13.2 录音输入: 41132 录音输入. 

@end detailmenu
@end menu

@node 41 操作系统接口
@chapter 41 操作系统接口

本章是关于 Emacs 的启动和退出，在操作系统环境中访问值，以及终端输入、输出。

有关相关信息，请参阅构建 Emacs。有关终端和屏幕的其他操作系统状态信息，请参阅 Emacs 显示。

@menu
* 41.1 启动 Emacs: 411 启动 Emacs. 
* 41.2 退出 Emacs: 412 退出 Emacs. 
* 41.3 操作系统环境: 413 操作系统环境. 
* 41.4 用户识别: 414 用户识别. 
* 41.5 时间: 415 时间. 
* 41.6 时区规则: 416 时区规则. 
* 41.7 时间转换: 417 时间转换. 
* 41.8 解析和格式化时间: 418 解析和格式化时间. 
* 41.9 处理器运行时间: 419 处理器运行时间. 
* 41.10 时间计算: 4110 时间计算. 
* 41.11 延迟执行的定时器: 4111 延迟执行的定时器. 
* 41.12 空闲定时器: 4112 空闲定时器. 
* 41.13 终端输入: 4113 终端输入. 
* 41.14 终端输出: 4114 终端输出. 
* 41.15 声音输出: 4115 声音输出. 
* 41.16 X11 Keysyms 上的操作: 4116 X11 Keysyms 上的操作. 
* 41.17 批处理模式: 4117 批处理模式. 
* 41.18 会话管理: 4118 会话管理. 
* 41.19 桌面通知: 4119 桌面通知. 
* 41.20 文件更改通知: 4120 文件更改通知. 
* 41.21 动态加载的库: 4121 动态加载的库. 
* 41.22 安全考虑: 4122 安全考虑. 
@end menu

@node 411 启动 Emacs
@section 41.1 启动 Emacs

本节描述 Emacs 在启动时会做什么，以及如何自定义这些操作。

@menu
* 41.1.1 小结：启动时的动作顺序: 4111 小结：启动时的动作顺序. 
* 41.1.2 初始化文件: 4112 初始化文件. 
* 41.1.3 终端特定初始化: 4113 终端特定初始化. 
* 41.1.4 命令行参数: 4114 命令行参数. 
@end menu

@node 4111 小结：启动时的动作顺序
@subsection 41.1.1 小结：启动时的动作顺序

当 Emacs 启动时，它会执行以下操作（参见 startup.el 中的 normal-top-level ）：

@enumerate
@item
它通过在列表中的每个目录中运行名为 subdirs.el 的文件，将子目录添加到加载路径。通常，此文件会将目录的子目录添加到列表中，然后依次扫描这些子目录。subdirs.el 文件通常在安装 Emacs 时自动生成。
@item
它加载它在加载路径目录中找到的任何 leim-list.el。该文件用于注册输入法。仅搜索您可能创建的任何个人 leim-list.el 文件；  它会跳过包含标准 Emacs 库的目录（这些应该只包含一个 leim-list.el 文件，该文件被编译成 Emacs 可执行文件）。
@item
它将变量 before-init-time 设置为 current-time 的值（请参阅时间）。它还将 after-init-time 设置为 nil，这向 Lisp 程序发出 Emacs 正在初始化的信号。
@item
如果 LANG 等环境变量要求，它设置语言环境和终端编码系统。
@item
它对命令行参数进行一些基本的解析。
@item
它加载您的早期初始化文件（请参阅 GNU Emacs 手册中的早期初始化文件）。如果指定了选项 @code{-q} 、 @code{-Q} 或 @code{--batch} ，则不会执行此操作。如果指定了 '-u' 选项，Emacs 会在该用户的主目录中查找 init 文件。
@item
它调用函数 package-activate-all 来激活任何已安装的可选 Emacs Lisp 包。请参阅包装基础知识。但是，当 package-enable-at-startup 为 nil 或使用选项 @code{-q} 、 @code{-Q} 或 @code{--batch} 之一启动时，Emacs 不会激活包。要在后一种情况下激活包，应该显式调用 package-activate-all（例如，通过 @code{--funcall} 选项）。
@item
如果不在批处理模式下运行，它会初始化变量 initial-window-system 指定的窗口系统（参见 initial-window-system）。初始化函数 window-system-initialization 是一个通用函数（请参阅通用函数），其实际实现对于每个支持的窗口系统都不同。如果initial-window-system的值为windowsystem，那么初始化函数的适当实现定义在文件term/windowsystem-win.el中。该文件在构建时应该已经编译到 Emacs 可执行文件中。
@item
它在初始化钩子之前运行正常的钩子。
@item
如果合适，它会创建一个图形框架。作为创建图形框架的一部分，它通过为该窗口系统调用 window-system-initialization 函数来为图形框架初始化由 initial-frame-alist 和 default-frame-alist 指定的窗口系统（请参阅初始帧参数） .  这不是在批处理（非交互）或守护程序模式下完成的。
@item
它初始化初始帧的面，并在需要时设置菜单栏和工具栏。如果支持图形框架，即使当前框架不是图形框架，它也会设置工具栏，因为稍后可能会创建图形框架。
@item
它使用 custom-reevaluate-setting 重新初始化列表 custom-delayed-init-variables 的成员。这些是任何预加载的用户选项，其默认值取决于运行时而不是构建时上下文。请参阅自定义初始化延迟。
@item
它会加载库站点启动（如果存在）。如果指定了选项 @code{-Q} 或 @code{--no-site-file} ，则不会这样做。
@item
它加载您的初始化文件（请参阅初始化文件）。如果指定了选项 @code{-q} 、 @code{-Q} 或 @code{--batch} ，则不会执行此操作。如果指定了 '-u' 选项，Emacs 会在该用户的主目录中查找 init 文件。
@item
它加载库默认值（如果存在）。如果 inhibitor-default-init 为非 nil，或者指定了选项 @code{-q} 、 @code{-Q} 或 @code{--batch} ，则不会执行此操作。
@item
它从 abbrev-file-name 指定的文件加载您的缩写，如果该文件存在并且可以读取（请参阅 abbrev-file-name）。如果指定了选项 @code{--batch} ，则不会这样做。
@item
它将变量 after-init-time 设置为 current-time 的值。这个变量之前被设置为 nil；  将其设置为当前时间表示初始化阶段结束，并与 before-init-time 一起提供对所用时间的测量。
@item
它在初始化钩子之后运行正常的钩子。
@item
如果缓冲区 @strong{scratch} 存在并且仍处于基本模式（默认情况下应该如此），它会根据 initial-major-mode 设置其主要模式。
@item
如果在文本终端上启动，它会加载特定于终端的 Lisp 库（请参阅特定于终端的初始化），并运行挂钩 tty-setup-hook。这不是在 --batch 模式下完成的，如果 term-file-prefix 为 nil 也不会。
@item
它会显示初始回声区域消息，除非您使用禁止启动回声区域消息抑制了该消息。
@item
它处理之前未处理的任何命令行选项。
@item
如果指定了 --batch 选项，它现在退出。
@item
如果 @strong{scratch} 缓冲区存在并且为空，它会将 (substitute-command-keys initial-scratch-message) 插入该缓冲区。
@item
如果 initial-buffer-choice 是一个字符串，它会访问具有该名称的文件（或目录）。如果它是一个函数，它会调用不带参数的函数并选择它返回的缓冲区。如果一个文件作为命令行参数给出，则访问该文件并将其缓冲区显示在 initial-buffer-choice 旁边。如果给出了多个文件，则访问所有文件并且 @strong{Buffer List} 缓冲区显示在 initial-buffer-choice 旁边。
@item
它运行 emacs-startup-hook。
@item
它调用 frame-notice-user-settings，它根据 init 文件指定的任何内容修改所选框架的参数。
@item
它运行窗口设置挂钩。这个钩子和 emacs-startup-hook 的唯一区别是这个钩子是在前面提到的对帧参数的修改之后运行的。
@item
它显示启动屏幕，这是一个特殊的缓冲区，包含有关 copyleft 和基本 Emacs 使用的信息。如果 inhibitor-startup-screen 或 initial-buffer-choice 不为零，或者指定了 @code{--no-splash} 或 @code{-Q} 命令行选项，则不会执行此操作。
@item
如果请求了一个守护进程，它会调用 server-start。（在 POSIX 系统上，如果请求后台守护程序，它会从控制终端分离。）请参阅 The GNU Emacs Manual 中的 Emacs Server。
@item
如果由 X 会话管理器启动，它会调用 emacs-session-restore 将前一个会话的 ID 作为参数传递给它。请参阅会话管理。
@end enumerate

以下选项会影响启动顺序的某些方面。

@lisp
User Option: inhibit-startup-screen ¶
@end lisp

此变量，如果非零，禁止启动屏幕。在这种情况下，Emacs 通常会显示 @strong{scratch} 缓冲区；  但请参阅下面的初始缓冲区选择。

不要在新用户的 init 文件中设置此变量，或者以影响多个用户的方式设置此变量，因为这会阻止新用户接收有关 copyleft 和基本 Emacs 使用的信息。

禁止启动消息和禁止启动屏幕是此变量的别名。

@lisp
User Option: initial-buffer-choice ¶
@end lisp

如果非零，此变量是一个字符串，它指定 Emacs 在启动后显示的文件或目录，而不是启动屏幕。如果它的值是一个函数，Emacs 调用该函数，该函数必须返回一个缓冲区，然后显示该缓冲区。如果它的值为 t，Emacs 将显示 @strong{scratch} 缓冲区。

@lisp
User Option: inhibit-startup-echo-area-message ¶
@end lisp

此变量控制启动回显区域消息的显示。您可以通过将此表单的文本添加到您的 init 文件来抑制启动回显区域消息：

@lisp
(setq inhibit-startup-echo-area-message
      "your-login-name")
@end lisp

Emacs 在你的 init 文件中显式检查如上所示的表达式；  您的登录名必须作为 Lisp 字符串常量出现在表达式中。您还可以使用自定义界面。将 inhibitor-startup-echo-area-message 设置为相同值的其他方法不会禁止启动消息。这样，如果您愿意，您可以轻松地为自己禁止消息，但不假思索地复制您的 init 文件不会禁止其他人的消息。

@lisp
User Option: initial-scratch-message ¶
@end lisp

这个变量，如果非零，应该是一个字符串，当 Emacs 启动时，它被当作文档插入到 @strong{scratch} 缓冲区中。如果为 nil，则 @strong{scratch} 缓冲区为空。

以下命令行选项会影响启动顺序的某些方面。请参阅 GNU Emacs 手册中的初始选项。

@lisp
--no-splash
@end lisp

不要显示启动画面。
@lisp
--batch
@end lisp

在没有交互式终端的情况下运行。请参阅批处理模式。
@lisp
--daemon
@end lisp
@lisp
--bg-daemon
@end lisp
@lisp
--fg-daemon
@end lisp

不要初始化任何显示；  只需启动一个服务器。（ @code{后台} 守护程序自动在后台运行。）
@lisp
--no-init-file
@end lisp
@lisp
-q
@end lisp

不要加载初始化文件或默认库。
@lisp
--no-site-file
@end lisp

不要加载站点启动库。
@lisp
--quick
@end lisp
@lisp
-Q
@end lisp

相当于'-q --no-site-file --no-splash'。

@node 4112 初始化文件
@subsection 41.1.2 初始化文件

当您启动 Emacs 时，它通常会尝试加载您的 init 文件。这可以是主目录中名为 .emacs 或 .emacs.el 的文件，或者是主目录中名为 .emacs.d 的子目录中名为 init.el 的文件。

命令行开关 @code{-q} 、 @code{-Q} 和 @code{-u} 控制是否以及在哪里找到初始化文件；  '-q'（和更强的'-Q'）表示不加载init文件，而'-u user'表示加载用户的init文件而不是你的。请参阅 GNU Emacs 手册中的输入 Emacs。如果两个选项都没有指定，Emacs 使用 LOGNAME 环境变量，或者 USER（大多数系统）或 USERNAME（MS 系统）变量来查找你的主目录，从而找到你的 init 文件；  这样，即使你有 su'd，Emacs 仍然会加载你自己的 init 文件。但是，如果没有这些环境变量，Emacs 会使用您的用户 ID 来查找您的主目录。

Emacs 还尝试加载第二个 init 文件，称为 early init 文件（如果存在）。这是 ~/.emacs.d 目录中名为 early-init.el 的文件。early init 文件和常规 init 文件的区别在于，early init 文件在启动过程中加载得更早，因此您可以使用它来自定义一些在加载常规 init 文件之前初始化的东西。例如，您可以通过设置 package-load-list 或 package-enable-at-startup 等变量来自定义初始化包系统的过程。请参阅 GNU Emacs 手册中的软件包安装。

Emacs 安装可能有一个默认的 init 文件，它是一个名为 default.el 的 Lisp 库。Emacs 通过库的标准搜索路径找到这个文件（参见程序如何加载）。Emacs 发行版不附带此文件；  它用于本地定制。如果默认的 init 文件存在，它会在您启动 Emacs 时加载。但是你自己的个人初始化文件，如果有的话，首先被加载；  如果它将禁止默认初始化设置为非零值，则 Emacs 不会随后加载 default.el 文件。在批处理模式下，或者如果您指定 @code{-q} （或 @code{-Q} ），Emacs 既不会加载您的个人 init 文件，也不会加载默认的 init 文件。

站点定制的另一个文件是 site-start.el。Emacs 在用户的 init 文件之前加载它。您可以使用选项 @code{--no-site-file} 来禁止加载此文件。

用户选项：站点运行文件¶

此变量指定要在用户的 init 文件之前加载的站点自定义文件。它的正常值为 @code{site-start} 。您可以真正改变它的唯一方法是在转储 Emacs 之前这样做。

有关如何在 .emacs 文件中进行各种常用自定义的示例，请参阅 GNU Emacs 手册中的初始化文件示例。

@lisp
User Option: site-run-file ¶
@end lisp

如果这个变量不是 nil，它会阻止 Emacs 加载默认的初始化库文件。默认值为无。

@lisp
User Option: inhibit-default-init ¶
@end lisp

在加载所有初始化文件（site-start.el、您的初始化文件和 default.el）之前，这个正常的钩子会运行一次。（真正改变它的唯一方法是在转储 Emacs 之前。）

@lisp
Variable: before-init-hook ¶
@end lisp

这个正常的钩子运行一次，在加载所有初始化文件（site-start.el、你的初始化文件和 default.el）之后，在加载特定于终端的库（如果在文本终端上启动）和处理命令行操作参数。

@lisp
Variable: after-init-hook ¶
@end lisp

这个普通的钩子在处理命令行参数之后运行一次。在批处理模式下，Emacs 不会运行这个钩子。

@lisp
Variable: emacs-startup-hook ¶
@end lisp

这个普通的钩子与 emacs-startup-hook 非常相似。唯一的区别是它在设置帧参数之后运行稍晚一些。请参阅窗口设置挂钩。

@lisp
Variable: window-setup-hook ¶
@end lisp

此变量保存用户初始化文件的绝对文件名。如果实际加载的 init 文件是编译文件，如 .emacs.elc，则该值是指对应的源文件。

@lisp
Variable: user-init-file ¶
@end lisp

此变量保存 Emacs 默认目录的名称。如果该目录存在并且 ~/.emacs.d/ 和 ~/.emacs 不存在，则默认为 @{XDG@math{_CONFIG}@math{_HOME}-'~/.config'@} 代表环境变量 XDG@math{_CONFIG}@math{_HOME} 的值（如果设置了该变量），否则代表 ~/.config。请参阅 GNU Emacs 手册中的 Emacs 如何找到您的初始化文件。

@node 4113 终端特定初始化
@subsection 41.1.3 终端特定初始化

每个终端类型都可以有自己的 Lisp 库，当在该类型的终端上运行时，Emacs 会加载该库。库的名称是通过连接变量 term-file-prefix 的值和终端类型（由环境变量 TERM 指定）构成的。通常，term-file-prefix 的值为 @code{term/} ；  不建议更改此设置。如果在 term-file-aliases 关联列表中存在与 TERM 匹配的条目，Emacs 将使用关联的值代替 TERM。Emacs 通过搜索加载路径目录并尝试使用 @code{.elc} 和 @code{.el} 后缀以正常方式查找文件。

终端特定库的通常作用是启用特殊键来发送 Emacs 可以识别的序列。如果 Termcap 或 Terminfo 条目未指定所有终端的功能键，则可能还需要设置或添加到 input-decode-map。请参阅终端输入。

当终端类型的名称包含连字符或下划线，并且没有找到名称与终端名称相同的库时，Emacs 会从终端名称中删除最后一个连字符或下划线及其后面的所有内容，然后重试。重复这个过程，直到 Emacs 找到匹配的库，或者直到名称中不再有连字符或下划线（即，没有终端特定的库）。例如，如果终端名称是 'xterm-256color' 并且没有 term/xterm-256color.el 库，Emacs 会尝试加载 term/xterm.el。如有必要，终端库可以评估 (getenv "TERM") 以找到终端类型的全名。

您的 init 文件可以通过将变量 term-file-prefix 设置为 nil 来阻止加载特定于终端的库。

您还可以使用 tty-setup-hook 来安排覆盖终端特定库的一些操作。这是 Emacs 在初始化一个新的文本终端后运行的一个普通钩子。您可以使用此挂钩为没有自己的库的终端定义初始化。请参阅挂钩。

@lisp
User Option: term-file-prefix ¶
@end lisp

如果这个变量的值不是 nil，Emacs 会加载一个终端特定的初始化文件，如下所示：
@lisp
(load (concat term-file-prefix (getenv "TERM")))
@end lisp

如果您不想加载终端初始化文件，您可以在初始化文件中将 term-file-prefix 变量设置为 nil。

在 MS-DOS 上，Emacs 将 TERM 环境变量设置为 @code{内部} 。

@lisp
User Option: term-file-aliases ¶
@end lisp

此变量是将终端类型映射到它们的别名的关联列表。例如，形式为 ("vt102" . "vt100") 的元素意味着将类型为 @code{vt102} 的终端视为 @code{vt100} 类型的终端。

@lisp
Variable: tty-setup-hook ¶
@end lisp

这个变量是 Emacs 在初始化一个新的文本终端后运行的一个普通的钩子。（这适用于 Emacs 在非窗口模式下启动以及建立 tty emacsclient 连接时。）该钩子在加载您的 init 文件（如果适用）和特定于终端的 Lisp 文件后运行，因此您可以使用它来调整该文件所做的定义。

有关相关功能，请参阅 window-setup-hook。

@node 4114 命令行参数
@subsection 41.1.4 命令行参数

当您启动 Emacs 时，您可以使用命令行参数来请求各种操作。请注意，使用 Emacs 的推荐方法是在登录后只启动一次，然后在同一个 Emacs 会话中进行所有编辑（请​​参阅 The GNU Emacs Manual 中的 Entering Emacs）。出于这个原因，您可能不会经常使用命令行参数。尽管如此，在从会话脚本调用 Emacs 或调试 Emacs 时，它们还是很有用的。本节描述 Emacs 如何处理命令行参数。

@lisp
Function: command-line ¶
@end lisp

该函数解析调用 Emacs 的命令行，对其进行处理，并且（除其他外）加载用户的 init 文件并显示启动消息。

@lisp
Variable: command-line-processed ¶
@end lisp

一旦处理了命令行，此变量的值就是 t。

如果您通过调用 dump-emacs（请参阅 Building Emacs）来转储 Emacs，您可能希望首先将此变量设置为 nil，以便使新转储的 Emacs 处理其新的命令行参数。

@lisp
Variable: command-switch-alist ¶
@end lisp

此变量是用户定义的命令行选项和相关处理函数的列表。默认情况下它是空的，但您可以根据需要添加元素。

命令行选项是命令行上的一个参数，其形式为：

@lisp
-option
@end lisp

command-switch-alist 的元素如下所示：

@lisp
(option . handler-function)
@end lisp

CAR 选项是一个字符串，是命令行选项的名称（包括初始连字符）。调用处理函数来处理选项，并接收选项名称作为其唯一参数。

在某些情况下，该选项在命令行中后跟一个参数。在这些情况下，处理函数可以在变量 command-line-args-left 中找到所有剩余的命令行参数（见下文）。（命令行参数的完整列表在命令行参数中。）

请注意，command-switch-alist 的处理不会专门处理选项中的等号。也就是说，如果命令行上有类似 --name=value 的选项，那么只有 car 字面为 --name=value 的 command-switch-alist 成员才会匹配此选项。如果要解析此类选项，则需要改用命令行函数（见下文）。

命令行参数由 startup.el 文件中的 command-line-1 函数解析。另请参阅 GNU Emacs 手册中的 Emacs 调用的命令行参数。

@lisp
Variable: command-line-args ¶
@end lisp

这个变量的值是传递给 Emacs 的命令行参数列表。

@lisp
Variable: command-line-args-left ¶
@end lisp

此变量的值是尚未处理的命令行参数列表。

@lisp
Variable: command-line-functions ¶
@end lisp

此变量的值是用于处理无法识别的命令行参数的函数列表。每次要处理的下一个参数没有特殊含义时，都会按照出现的顺序调用此列表中的函数，直到其中一个返回非零值。

这些函数在没有参数的情况下被调用。他们可以通过此时临时绑定的变量 argi 访问正在考虑的命令行参数。其余参数（不包括当前参数）在变量 command-line-args-left 中。

当一个函数识别并处理 argi 中的参数时，它应该返回一个非零值来表示它已经处理了该参数。如果它还处理了以下一些参数，则可以通过从 command-line-args-left 中删除它们来表明这一点。

如果所有这些函数都返回 nil，则将参数视为要访问的文件名。

@node 412 退出 Emacs
@section 41.2 退出 Emacs

有两种方法可以退出 Emacs：您可以终止 Emacs 作业，它会永久退出，或者您可以暂停它，这允许您稍后重新进入 Emacs 进程。（在图形环境中，您当然可以简单地切换到另一个应用程序而无需对 Emacs 做任何特殊操作，然后在需要时切换回 Emacs。）

@menu
* 41.2.1 杀死 Emacs: 4121 杀死 Emacs. 
* 41.2.2 挂起 Emacs: 4122 挂起 Emacs. 
@end menu

@node 4121 杀死 Emacs
@subsection 41.2.1 杀死 Emacs

杀死 Emacs 意味着结束 Emacs 进程的执行。如果您从终端启动 Emacs，父进程通常会恢复控制。杀死 Emacs 的低级原语是 kill-emacs。

@lisp
Command: kill-emacs &optional exit-data ¶
@end lisp

该命令调用 hook kill-emacs-hook，然后退出 Emacs 进程并杀死它。

如果 exit-data 是一个整数，则用作 Emacs 进程的退出状态。（这主要在批处理操作中很有用；请参阅批处理模式。）

如果 exit-data 是一个字符串，它的内容将被填充到终端输入缓冲区中，以便 shell（或接下来读取输入的任何程序）可以读取它们。

如果 exit-data 既不是整数也不是字符串，或者被省略，这意味着使用（系统特定的）退出状态，表明程序成功终止。

kill-emacs 函数通常通过更高级别的命令 Cx Cc (save-buffers-kill-terminal) 调用。请参阅 GNU Emacs 手册中的退出。如果 Emacs 接收到 SIGTERM 或 SIGHUP 操作系统信号（例如，当控制终端断开连接时），或者如果它在批处理模式下运行时接收到 SIGINT 信号（请参阅批处理模式），它也会自动调用。

@lisp
Variable: kill-emacs-hook ¶
@end lisp

这个普通的钩子在杀死 Emacs 之前由 kill-emacs 运行。

因为 kill-emacs 可以在用户交互不可能的情况下被调用（例如，当终端断开时），这个钩子上的函数不应该尝试与用户交互。如果您想在 Emacs 关闭时与用户交互，请使用 kill-emacs-query-functions，如下所述。

当 Emacs 被杀死时，Emacs 进程中的所有信息，除了已保存的文件，都将丢失。因为无意中杀死 Emacs 会丢失大量工作，所以 save-buffers-kill-terminal 命令会查询以确认您是否有需要保存的缓冲区或正在运行的子进程。它还运行异常的钩子kill-emacs-query-functions：

@lisp
User Option: kill-emacs-query-functions ¶
@end lisp

当 save-buffers-kill-terminal 杀死 Emacs 时，它会在询问标准问题之后和调用 kill-emacs 之前调用此钩子中的函数。这些函数按出现的顺序调用，没有参数。每个功能都可以要求用户进行额外确认。如果其中任何一个返回 nil，则 save-buffers-kill-emacs 不会杀死 Emacs，并且不会运行此钩子中的其余函数。直接调用 kill-emacs 不会运行这个钩子。

@node 4122 挂起 Emacs
@subsection 41.2.2 挂起 Emacs

在文本终端上，可以暂停 Emacs，这意味着暂时停止 Emacs 并将控制权返回给其上级进程，通常是 shell。这允许您稍后在相同的 Emacs 进程中恢复编辑，使用相同的缓冲区、相同的终止环、相同的撤消历史记录等。要恢复 Emacs，请在父 shell 中使用适当的命令——很可能是 fg。

挂起仅适用于启动 Emacs 会话的终端设备。我们称该设备为会话的控制终端。如果控制终端是图形终端，则不允许挂起。挂起通常与图形环境无关，因为您可以简单地切换到另一个应用程序，而无需对 Emacs 做任何特殊的事情。

某些操作系统（没有 SIGTSTP 或 MS-DOS 的操作系统）不支持暂停作业；  在这些系统上，挂起实际上会临时创建一个新的 shell 作为 Emacs 的子进程。然后您将退出 shell 以返回 Emacs。

@lisp
Command: suspend-emacs &optional string ¶
@end lisp

此函数停止 Emacs 并将控制权返回给上级进程。如果并且当上级进程恢复 Emacs 时，suspend-emacs 将 nil 返回给其在 Lisp 中的调用者。

该功能仅在 Emacs 会话的控制终端上有效；  要放弃对其他 tty 设备的控制，请使用 suspend-tty（见下文）。如果 Emacs 会话使用多个终端，则必须在挂起 Emacs 之前删除所有其他终端上的帧，否则此函数会发出错误信号。请参阅多个终端。

如果 string 不是 nil，它的字符被发送到 Emacs 的上层 shell，作为终端输入读取。string 中的字符不被上级 shell 回显；  只显示结果。

在挂起之前，suspend-emacs 运行正常的挂起钩子。用户恢复 Emacs 后，suspend-emacs 运行正常的 hooksuspend-resume-hook。请参阅挂钩。

恢复后的下一次重新显示将重绘整个屏幕，除非变量 no-redraw-on-reenter 为非零。请参阅刷新屏幕。

以下是如何使用这些钩子的示例：
@lisp


(add-hook 'suspend-hook
          (lambda () (or (y-or-n-p "Really suspend?")
                         (error "Suspend canceled"))))

(add-hook 'suspend-resume-hook (lambda () (message "Resumed!")
                                 (sit-for 2)))
@end lisp

以下是您在评估时会看到的内容 (suspend-emacs "pwd")：
@lisp


---------- Buffer: Minibuffer ----------
Really suspend? y
---------- Buffer: Minibuffer ----------


---------- Parent Shell ----------
bash$ /home/username
bash$ fg


---------- Echo Area ----------
Resumed!
@end lisp
请注意，Emacs 挂起后不会回显 @code{pwd} 。但它是由 shell 读取和执行的。

@lisp
Variable: suspend-hook ¶
@end lisp

这个变量是 Emacs 在挂起之前运行的普通钩子。

@lisp
Variable: suspend-resume-hook ¶
@end lisp

此变量是 Emacs 在暂停后恢复时运行的正常钩子。

@lisp
Function: suspend-tty &optional tty ¶
@end lisp

如果 tty 指定 Emacs 使用的终端设备，此函数将放弃该设备并将其恢复到之前的状态。使用该设备的帧继续存在，但不会更新，并且 Emacs 不会从它们读取输入。tty 可以是终端对象、框架（表示该框架的终端）或 nil（表示所选框架的终端）。请参阅多个终端。

如果 tty 已经挂起，这个函数什么也不做。

该函数运行 hook 挂起 tty 函数，将终端对象作为参数传递给每个函数。

@lisp
Function: resume-tty &optional tty ¶
@end lisp

该函数恢复之前挂起的终端设备tty；  其中 tty 具有与 suspend-tty 相同的可能值。

此函数重新打开终端设备，重新初始化它，并使用该终端的选定帧重新绘制它。然后它运行钩子 resume-tty-functions，将终端对象作为参数传递给每个函数。

如果同一设备已被另一个 Emacs 终端使用，则此函数会发出错误信号。如果 tty 没有挂起，这个函数什么也不做。

@lisp
Function: controlling-tty-p &optional tty ¶
@end lisp

如果 tty 是 Emacs 会话的控制终端，则此函数返回非 nil；  tty 可以是终端对象、框架（表示该框架的终端）或 nil（表示所选框架的终端）。

@lisp
Command: suspend-frame ¶
@end lisp

此命令暂停一帧。对于 GUI 框架，它调用 iconify-frame（参见框架的可见性）；  对于文本终端上的框架，它调用suspend-emacs 或suspend-tty，这取决于框架是否显示在控制终端设备上。

@node 413 操作系统环境
@section 41.3 操作系统环境

Emacs 通过各种函数提供对操作系统环境中变量的访问。这些变量包括系统名称、用户的 UID 等。

@lisp
Variable: system-configuration ¶
@end lisp

此变量以字符串形式保存系统硬件/软件配置的标准 GNU 配置名称。例如，64 位 GNU/Linux 系统的典型值为 '"x86@math{_64}-unknown-linux-gnu"'。

@lisp
Variable: system-type ¶
@end lisp

这个变量的值是一个符号，表示 Emacs 正在运行的操作系统的类型。可能的值是：

@lisp
aix
@end lisp

IBM 的 AIX。
@lisp
berkeley-unix
@end lisp

伯克利 BSD 及其变体。
@lisp
cygwin
@end lisp

Cygwin，MS-Windows 之上的 POSIX 层。
@lisp
darwin
@end lisp

达尔文 (macOS)。
@lisp
gnu
@end lisp

GNU 系统（使用 GNU 内核，由 HURD 和 Mach 组成）。
@lisp
gnu/linux
@end lisp

GNU/Linux 系统——即使用 Linux 内核的变体 GNU 系统。（这些系统就是人们常说的 @code{Linux} ，但实际上 Linux 只是内核，而不是整个系统。）
@lisp
gnu/kfreebsd
@end lisp

具有 FreeBSD 内核的 GNU（基于 glibc）系统。
@lisp
hpux
@end lisp

惠普 HPUX 操作系统。
@lisp
nacl
@end lisp

Google Native Client (NaCl) 沙盒系统。
@lisp
ms-dos
@end lisp

微软的 DOS。使用 DJGPP 为 MS-DOS 编译的 Emacs 将系统类型绑定到 ms-dos，即使您在 MS-Windows 上运行它也是如此。
@lisp
usg-unix-v
@end lisp

AT&T Unix System V@.
@lisp
windows-nt
@end lisp

Microsoft Windows NT、9X 及更高版本。system-type 的值始终为 windows-nt，例如，即使在 Windows 10 上也是如此。

除非绝对必要，否则我们不希望添加新符号来进行更精细的区分！  事实上，我们希望在未来消除其中的一些替代方案。如果您需要比系统类型允许的更精细的区分，您可以测试系统配置，例如，针对正则表达式。

@lisp
Function: system-name ¶
@end lisp

此函数以字符串形式返回您正在运行的机器的名称。

@lisp
User Option: mail-host-address ¶
@end lisp

如果此变量不为 nil，则使用它代替 system-name 来生成电子邮件地址。例如，在构造用户邮件地址的默认值时使用。请参阅用户标识。

@lisp
Command: getenv var &optional frame ¶
@end lisp

此函数以字符串形式返回环境变量 var 的值。var 应该是一个字符串。如果环境中未定义 var，则 getenv 返回 nil。如果设置了 var 但为 null，则返回 '""'。在 Emacs 中，环境变量及其值的列表保存在变量 process-environment 中。

@lisp
(getenv "USER")
     ⇒ "lewis"
@end lisp

shell 命令 printenv 打印全部或部分环境：
@lisp
bash$ printenv
PATH=/usr/local/bin:/usr/bin:/bin
USER=lewis

TERM=xterm
SHELL=/bin/bash
HOME=/home/lewis

…
@end lisp

@lisp
Command: setenv variable &optional value substitute ¶
@end lisp

此命令将名为 variable 的环境变量的值设置为 value。变量应该是一个字符串。在内部，Emacs Lisp 可以处理任何字符串。但是，通常变量应该是有效的外壳标识符，即字母、数字和下划线的序列，以字母或下划线开头。否则，如果 Emacs 的子进程尝试访问变量的值，可能会出现错误。如果 value 被省略或 nil （或者，交互地，使用前缀参数）， setenv 从环境中删除变量。否则，值应该是一个字符串。

如果可选参数替代非零，Emacs 调用函数替代环境变量来扩展任何环境变量的值。

setenv 通过修改进程环境来工作；  将该变量与 let 绑定也是合理的做法。

setenv 返回变量的新值，如果从环境中删除变量，则返回 nil。

@lisp
Macro: with-environment-variables variables body… ¶
@end lisp

该宏在执行body时临时根据变量设置环境变量。表单完成后将恢复以前的值。参数变量应该是格式为 (var value) 的字符串对列表，其中 var 是环境变量的名称，value 是该变量的值。

@lisp
(with-environment-variables (("LANG" "C")
                             ("LANGUAGE" "en_US:en"))
  (call-process "ls" nil t))
@end lisp

@lisp
Variable: process-environment ¶
@end lisp

该变量是一个字符串列表，每个字符串描述一个环境变量。函数 getenv 和 setenv 通过这个变量工作。

@lisp


process-environment
⇒ ("PATH=/usr/local/bin:/usr/bin:/bin"
    "USER=lewis"

    "TERM=xterm"
    "SHELL=/bin/bash"
    "HOME=/home/lewis"
    …)
@end lisp

如果 process-environment 包含多个指定相同环境变量的元素，则这些元素中的第一个指定变量，而其他元素将被忽略。

@lisp
Variable: initial-environment ¶
@end lisp

此变量保存 Emacs 启动时从其父进程继承的环境变量列表。

@lisp
Variable: path-separator ¶
@end lisp

此变量包含一个字符串，该字符串表示搜索路径中的哪个字符分隔目录（如在环境变量中找到的那样）。对于 Unix 和 GNU 系统，它的值是 @code{:} ，而 @code{;}   用于 MS 系统。

@lisp
Function: path-separator ¶
@end lisp

此函数返回变量路径分隔符的连接局部值。那是 ~ ;~   对于 MS 系统和本地默认目录， @code{：} 对于 Unix 和 GNU 系统，或远程默认目录。

@lisp
Function: parse-colon-path path ¶
@end lisp

此函数采用搜索路径字符串（例如 PATH 环境变量的值），并在分隔符处将其拆分，返回目录列表。此列表中的 nil 表示当前目录。虽然函数的名称是 @code{冒号} ，但它实际上使用了变量路径分隔符的值。

@lisp
(parse-colon-path ":/foo:/bar")
     ⇒ (nil "/foo/" "/bar/")
@end lisp

@lisp
Variable: invocation-name ¶
@end lisp

此变量保存调用 Emacs 的程序名称。该值是一个字符串，并且不包括目录名称。

@lisp
Variable: invocation-directory ¶
@end lisp

此变量保存 Emacs 可执行文件在运行时所在的目录，如果无法确定该目录，则为 nil。

@lisp
Variable: installation-directory ¶
@end lisp

如果非零，这是一个目录，可以在其中查找 lib-src 和 etc 子目录。在已安装的 Emacs 中，它通常为 nil。当 Emacs 无法在其标准安装位置找到这些目录，但可以在与包含 Emacs 可执行文件的目录（即调用目录）相关的目录中找到它们时，它是非零的。

@lisp
Function: load-average &optional use-float ¶
@end lisp

此函数以列表的形式返回当前 1 分钟、5 分钟和 15 分钟的系统负载平均值。平均负载表示试图在系统上运行的进程数。

默认情况下，这些值是系统负载平均值的 100 倍的整数，但如果 use-float 不为零，则它们将作为浮点数返回，而不乘以 100。

如果无法获得负载平均值，则此函数会发出错误信号。在某些平台上，访问平均负载需要将 Emacs 安装为 setuid 或 setgid，以便它可以读取内核信息，这通常是不可取的。

如果 1 分钟负载平均值可用，但 5 或 15 分钟平均值不可用，则此函数返回包含可用平均值的缩短列表。
@lisp
(load-average)
     ⇒ (169 48 36)

(load-average t)
     ⇒ (1.69 0.48 0.36)
@end lisp

shell 命令 uptime 返回类似的信息。

@lisp
Function: emacs-pid ¶
@end lisp

此函数以整数形式返回 Emacs 进程的进程 ID。

@lisp
Variable: tty-erase-char ¶
@end lisp

此变量保存在 Emacs 启动之前在系统终端驱动程序中选择的擦除字符。

@lisp
Variable: null-device ¶
@end lisp

此变量保存系统空设备。对于 Unix 和 GNU 系统，其值为 @code{/dev/null} ，对于 MS 系统，其值为 @code{NUL} 。

@lisp
Function: null-device ¶
@end lisp

此函数返回变量 null-device 的连接本地值。对于 MS 系统和本地默认目录是 @code{NUL} ，对于 Unix 和 GNU 系统是 @code{/dev/null} ，或者是远程默认目录。

@node 414 用户识别
@section 41.4 用户识别

@lisp
Variable: init-file-user ¶
@end lisp

这个变量表示 Emacs 应该使用哪个用户的 init 文件——如果没有，则为 nil。"" 代表最初登录的用户。该值反映了命令行选项，例如 @code{-q} 或 @code{-u 用户} 。

加载自定义文件或任何其他类型的用户配置文件的 Lisp 包在决定在哪里找到它时应该遵循这个变量。他们应该加载在这个变量中找到的用户名的配置文件。如果 init-file-user 为 nil，意味着使用了 @code{-q} 、 @code{-Q} 或 @code{-batch} 选项，则 Lisp 包不应加载任何自定义文件或用户配置文件。

@lisp
User Option: user-mail-address ¶
@end lisp

这包含使用 Emacs 的用户的电子邮件地址。

@lisp
Function: user-login-name &optional uid ¶
@end lisp

此函数返回用户登录的名称。它使用环境变量 LOGNAME 或 USER（如果已设置）。否则，该值基于有效 UID，而不是真实 UID。

如果指定 uid（一个数字），则结果是对应于 uid 的用户名，如果没有这样的用户，则返回 nil。

@lisp
Function: user-real-login-name ¶
@end lisp

该函数返回 Emacs 的真实 UID 对应的用户名。这将忽略有效的 UID，以及环境变量 LOGNAME 和 USER。

@lisp
Function: user-full-name &optional uid ¶
@end lisp

此函数返回登录用户的全名，或者环境变量 NAME 的值（如果已设置）。

如果 Emacs 进程的用户 ID 不对应于任何已知用户（并且未设置 NAME），则结果为 @code{未知} 。

如果 uid 不是 nil，那么它应该是一个数字（一个用户 ID）或一个字符串（一个登录名）。然后 user-full-name 返回与该用户 ID 或登录名对应的全名。如果您指定未定义的用户 ID 或登录名，则返回 nil。

符号 user-login-name、user-real-login-name 和 user-full-name 是变量和函数。这些函数返回与变量相同的值。这些变量允许您通过告诉函数返回什么来伪造 Emacs。这些变量对于构造框架标题也很有用（请参阅框架标题）。

@lisp
Function: user-real-uid ¶
@end lisp

此函数返回用户的真实 UID。

@lisp
Function: user-uid ¶
@end lisp

该函数返回用户的有效 UID。

@lisp
Function: group-gid ¶
@end lisp

该函数返回 Emacs 进程的有效 GID。

@lisp
Function: group-real-gid ¶
@end lisp

该函数返回 Emacs 进程的真实 GID。

@lisp
Function: system-users ¶
@end lisp

此函数返回字符串列表，列出系统上的用户名。如果 Emacs 无法检索此信息，则返回值是一个仅包含 user-real-login-name 值的列表。

@lisp
Function: system-groups ¶
@end lisp

该函数返回一个字符串列表，列出系统上用户组的名称。如果 Emacs 无法检索此信息，则返回值为 nil。

@lisp
Function: group-name gid ¶
@end lisp

此函数返回与数字组 ID gid 对应的组名，如果没有这样的组，则返回 nil。

@node 415 时间
@section 41.5 时间

本节说明如何确定当前时间和时区。

当前时间和文件属性等许多函数返回计数秒数的 Lisp 时间戳值，并且可以通过从 1970-01-01 00:00:00 UTC 的纪元开始计数秒来表示绝对时间。

尽管传统上 Lisp 时间戳是整数对，但它们的形式已经发展，程序通常不应该依赖于当前的默认形式。如果您的程序需要特定的时间戳形式，您可以使用 time-convert 函数将其转换为所需的形式。请参阅时间转换。

目前有三种形式的 Lisp 时间戳，每一种都代表秒数：

一个整数。虽然这是最简单的形式，但它不能表示亚秒级时间戳。
一对整数（记号 .hz），其中 hz 为正数。这表示滴答/hz 秒，如果 hz 为 1，则与普通滴答时间相同。对于纳秒分辨率时钟，hz 的常见值为 1000000000。27
四个整数的列表（高低微 pico），其中 0≤low<65536、0≤micro<1000000 和 0≤pico<1000000。这表示使用以下公式的秒数：high * 2**16 + low + micro * 10**-6 + pico * 10**-12。在某些情况下，函数可能默认返回两个或三个元素的列表，省略的 micro 和 pico 组件默认为零。在所有当前机器上，pico 是 1000 的倍数，但随着更高分辨率时钟的可用，这可能会发生变化。

函数参数，例如，当前时间字符串的时间参数，接受更通用的时间值格式，可以是 Lisp 时间戳、当前时间的 nil、秒的单个浮点数或列表 ( high low micro) 或 (high low)，它是一个截断的列表时间戳，缺少的元素被视为零。

时间值可以与日历和其他形式相互转换。其中一些转换依赖于限制可能时间值范围的操作系统功能，如果超出限制，则会发出错误信号，例如 @code{指定时间不可表示} 。例如，系统可能不支持 1970 年之前的年份、1901 年之前的年份或遥远的未来年份。您可以使用 format-time-string 将时间值转换为人类可读的字符串，使用 time-convert 将时间值转换为 Lisp 时间戳，并使用 decode-time 和 float-time 将其转换为其他形式。这些功能将在以下部分中描述。

@lisp
Function: current-time-string &optional time zone ¶
@end lisp

此函数将当前时间和日期作为人类可读的字符串返回。字符串的初始部分的格式没有变化，其中包含按顺序排列的星期几、月份、月份中的日期和时间：用于这些字段的字符数始终相同，尽管（除非无论语言环境如何，您都需要英文工作日或月份缩写）通常使用格式时间字符串比从当前时间字符串的输出中提取字段更方便，因为年份可能不完全是四位数字，以及其他信息可能有一天会在最后添加。

如果给定参数时间，则指定要格式化的时间，而不是当前时间。可选参数 zone 默认为当前时区规则。请参阅时区规则。操作系统限制时间和区域值的范围。

@lisp
(current-time-string)
     ⇒ "Fri Nov  1 15:59:49 2019"
@end lisp

@lisp
Function: current-time ¶
@end lisp

此函数以 Lisp 时间戳的形式返回当前时间。尽管时间戳在当前 Emacs 版本中采用（高低微 pico）形式，但计划在未来的 Emacs 版本中进行更改。您可以使用 time-convert 函数将时间戳转换为其他形式。请参阅时间转换。

@lisp
Function: float-time &optional time ¶
@end lisp

此函数将当前时间作为自纪元以来的浮点秒数返回。如果给定可选参数 time，则指定要转换的时间而不是当前时间。

警告：由于结果是浮点数，因此可能不准确。如果需要精确的时间戳，请勿使用此功能。例如，在典型系统上（浮点时间 '(1 . 10)）显示为 '0.1' 但略大于 1/10。

time-to-seconds 是此函数的别名。

脚注
(27)

当前 hz 应该至少为 65536 以避免在将时间戳传递给标准函数时出现兼容性警告，因为以前版本的 Emacs 由于向后兼容性问题会以不同方式解释此类时间戳。这些警告旨在在未来的 Emacs 版本中删除。

@node 416 时区规则
@section 41.6 时区规则

默认时区由 TZ 环境变量确定。请参阅操作系统环境。例如，您可以使用 (setenv "TZ" "UTC0") 告诉 Emacs 默认为世界时。如果 TZ 不在环境中，Emacs 使用系统挂钟时间，这是一个依赖于平台的默认时区。

支持的 TZ 字符串集取决于系统。GNU 和许多其他系统支持 tzdata 数据库，例如，'"America/New@math{_York}"' 指定纽约市附近位置的时区和夏令时历史。GNU 和大多数其他系统支持 POSIX 样式的 TZ 字符串，例如，'"EST+5EDT,M4.1.0/2,M10.5.0/2"' 指定纽约从 1987 年到 2006 年使用的规则。所有系统都支持该字符串'"UTC0"' 表示世界时。

与本地时间相互转换的函数接受可选的时区规则参数，该参数指定转换的时区和夏令时历史。如果时区规则被省略或为零，则转换使用 Emacs 的默认时区。如果是 t，则转换使用世界时。如果是 wall，则转换使用系统挂钟时间。如果是字符串，则转换使用相当于将 TZ 设置为该字符串的时区规则。如果它是一个列表（偏移量缩写），其中偏移量是世界时间以东的整数秒数，而缩写是一个字符串，则转换使用具有给定偏移量和缩写的固定时区。整数偏移量被视为 (offset abbr)，其中 abbr 是 POSIX 兼容平台上的数字缩写，在 MS-Windows 上未指定。

@lisp
Function: current-time-zone &optional time zone ¶
@end lisp

此函数返回一个描述用户所在时区的列表。

该值的形式为（偏移缩写）。这里的 offset 是一个整数，表示世界时间（格林威治以东）之前的秒数。负值表示格林威治以西。第二个元素 abbr 是一个字符串，它给出了时区的缩写，例如， @code{CST} 代表中国标准时间或美国中部标准时间。当夏令时开始或结束时，这两个元素都可以改变；  如果用户指定了不使用季节性时间调整的时区，则该值在时间上是恒定的。

如果操作系统没有提供计算该值所需的所有信息，则列表的未知元素为零。

如果给定参数时间，则指定要分析的时间值而不是当前时间。可选参数 zone 默认为当前时区规则。操作系统限制时间和区域值的范围。

@node 417 时间转换
@section 41.7 时间转换

这些函数将时间值（参见时间）转换为 Lisp 时间戳，或转换为日历信息，反之亦然。

许多 32 位操作系统仅限于在其秒组件中包含 32 位信息的系统时间；  这些系统通常只处理从 1901-12-13 20:45:52 到 2038-01-19 03:14:07 世界时的时间。但是，64 位和一些 32 位操作系统具有更大的秒组件，并且可以表示过去或未来的时间。

日历转换函数始终使用公历，即使对于引入公历之前的日期也是如此。年份数字计算自公元前 1 年以来的年数，并且不要像传统的公历年份那样跳过零；  例如，年份数字 -37 表示公历 38 BC。

@lisp
Function: time-convert time &optional form ¶
@end lisp

此函数将时间值转换为 Lisp 时间戳。

可选形式参数指定要返回的时间戳形式。如果 form 是符号整数，则此函数返回以秒为单位的整数计数。如果form是一个正整数，它指定一个时钟频率并且这个函数返回一个整数对时间戳（ticks .form）。28如果form是t，这个函数把它当作一个正整数来表示时间戳；  例如，如果时间为零并且平台时间戳具有纳秒分辨率，则将其视为 1000000000。如果form是list，这个函数返回一个整数列表（高低微微微）。尽管当前省略或 nil 形式的行为类似于列表，但计划在未来的 Emacs 版本中进行更改，因此需要列表时间戳的调用者应显式传递列表。

如果时间是无限的或 NaN，则此函数会发出错误信号。否则，如果无法准确表示时间，则转换会将其截断为负无穷大。当form为t时，转换总是精确的，不会发生截断，返回的时钟分辨率不小于时间。相比之下，float-time 可以转换任何 Lisp 时间值而不会发出错误信号，尽管结果可能不准确。请参阅一天中的时间。

为了提高效率，这个函数可能返回一个与时间相等的值，或者与时间共享结构的值。

虽然 (time-convert nil nil) 等价于 (current-time)，但后者可能会快一点。
@lisp


(setq a (time-convert nil t))
⇒ (1564826753904873156 . 1000000000)

(time-convert a 100000)
⇒ (156482675390487 . 100000)

(time-convert a 'integer)
⇒ 1564826753

(time-convert a 'list)
⇒ (23877 23681 904873 156000)
@end lisp

@lisp
Function: decode-time &optional time zone form ¶
@end lisp

此函数将时间值转换为日历信息。如果您不指定时间，它会解码当前时间，并且类似地，区域默认为当前时区规则。请参阅时区规则。操作系统限制时间和区域值的范围。

form 参数控制返回的 seconds 元素的形式，如下所述。返回值是九个元素的列表，如下：

@lisp
(seconds minutes hour day month year dow dst utcoff)
@end lisp

以下是元素的含义：

@lisp
seconds
@end lisp

分钟后的秒数，格式如下所述。
@lisp
minutes
@end lisp

一小时后的分钟数，为 0 到 59 之间的整数。
@lisp
hour
@end lisp

一天中的小时，为 0 到 23 之间的整数。
@lisp
day
@end lisp

月份中的日期，为 1 到 31 之间的整数。
@lisp
month
@end lisp

一年中的月份，为 1 到 12 之间的整数。
@lisp
year
@end lisp

年份，通常大于 1900 的整数。
@lisp
dow
@end lisp

星期几，0 到 6 之间的整数，其中 0 代表星期日。
@lisp
dst
@end lisp

t 如果夏令时有效，nil 如果无效，-1 如果此信息不可用。
@lisp
utcoff
@end lisp

一个整数，表示以秒为单位的世界时偏移量，即格林威治以东的秒数。

seconds 元素是一个非负数且小于 61 的 Lisp 时间戳；  它小于 60，除非在正闰秒期间（假设操作系统支持闰秒）。如果可选的表单参数是 t，秒使用与时间相同的精度；  如果 form 是整数，秒被截断为整数。例如，如果 time 是时间戳 (1566009571321 . 1000)，它在缺少闰秒的典型系统上表示 2019-08-17 02:39:31.321 UTC，则 (decode-time time tt) 返回 ((31321 . 1000) 39 2 17 8 2019 6 nil 0)，而 (decode-time time t 'integer) 返回 (31 39 2 17 8 2019 6 nil 0)。如果 form 被省略或为零，它当前默认为整数，但此默认值可能会在未来的 Emacs 版本中更改，因此需要特定表单的调用者应指定 form。

Common Lisp 注意：Common Lisp 对于 dow 和 utcoff 有不同的含义，它的第二个是 0 到 59 之间的整数。

要访问（或更改）时间值中的元素，解码时间-秒、解码时间-分钟、解码时间-小时、解码时间-日、解码时间-月、解码时间-年，可以使用decoded-time-weekday、decoded-time-dst 和decoded-time-zone 访问器。

例如，要在解码时间内增加年份，您可以说：
@lisp
(setf (decoded-time-year decoded-time)
      (+ (decoded-time-year decoded-time) 4))
@end lisp

另请参阅以下功能。

@lisp
Function: decoded-time-add time delta ¶
@end lisp

此函数采用解码的时间结构并向其添加 delta（也是解码的时间结构）。delta 中为 nil 的元素将被忽略。

例如，如果你想要 @code{下个月的同一时间} ，你可以说：

@lisp
(let ((time (decode-time nil nil t))
      (delta (make-decoded-time :month 2)))
   (encode-time (decoded-time-add time delta)))
@end lisp

如果此日期不存在（例如，如果您在 1 月 31 日运行此日期），则日期将向后移动，直到您获得有效日期（取决于 2 月 28 日或 29 日）。

字段按最重要到最不重要的顺序添加，因此如果发生上述调整，则在添加天、小时、分钟或秒之前发生。

delta 中的值可以是负数来减去值。

返回值是一个解码的时间结构。

@lisp
Function: make-decoded-time &key second minute hour day month year dst zone ¶
@end lisp

返回一个解码的时间结构，只填写给定的关键字，其余的为零。例如，要获得一个表示 @code{两个月} 的结构，您可以说：

@lisp
(make-decoded-time :month 2)
@end lisp


@lisp
Function: encode-time time &rest obsolescent-arguments ¶
@end lisp

此函数将时间转换为 Lisp 时间戳。它可以作为解码时间的倒​​数。

通常，第一个参数是一个列表（第二分钟小时日月年忽略 dst 区域），它以 decode-time 的样式指定解码时间，因此 (encode-time (decode-time @dots{})) 有效。这些列表成员的含义见decode-time下的表格。

作为一个过时的调用约定，这个函数可以有六个或更多的参数。前六个参数 second、minute、hour、day、month 和 year 指定解码时间的大部分组成部分。如果有超过六个参数，则最后一个参数用作区域，并且任何其他额外参数都将被忽略，因此 (apply #'encode-time (decode-time @dots{})) 有效。在这个过时的约定中，区域默认为当前时区规则（请参阅时区规则），并且 dst 被视为 -1。

小于 100 的年份不作特殊处理。如果您希望它们代表 1900 年以上或 2000 年以上的年份，您必须在调用编码时间之前自己更改它们。操作系统限制时间和区域值的范围。

编码时间函数作为解码时间的粗略逆。例如，您可以将后者的输出传递给前者，如下所示：

@lisp
(encode-time (decode-time …))
@end lisp
您可以通过使用超出范围的秒、分、小时、日和月值来执行简单的日期算术；  例如，第 0 天表示给定月份的前一天。

脚注
(28)

目前，如果返回值旨在提供给期望 Lisp 时间戳的标准函数，则正整数形式应至少为 65536。

@node 418 解析和格式化时间
@section 41.8 解析和格式化时间

这些函数将时间值转换为字符串中的文本，反之亦然。时间值包括 nil、数字和 Lisp 时间戳（请参阅时间）。

@lisp
Function: date-to-time string ¶
@end lisp

该函数解析时间字符串并返回相应的 Lisp 时间戳。参数字符串应表示日期时间，并且应采用 parse-time-string 识别的形式之一（见下文）。如果字符串缺少明确的时区信息，则此函数采用世界时间。操作系统限制时间和区域值的范围。

@lisp
Function: parse-time-string string ¶
@end lisp

此函数将时间字符串解析为以下形式的列表：

@lisp
(sec min hour day mon year dow dst tz)
@end lisp

此列表的格式与 decode-time 接受的格式相同（请参阅时间转换），并在此处进行了更详细的描述。任何无法从输入中确定的 dst 元素设置为 -1，任何其他未知元素设置为 nil。参数字符串应类似于 RFC 822（或更高版本）或 ISO 8601 字符串，例如 @code{Fri, 25 Mar 2016 16:24:56 +0100} 或 @code{1998-09-12T12:21:54-0200} ，但此函数也将尝试解析格式不太好的时间字符串。

@lisp
Function: iso8601-parse string ¶
@end lisp

对于更严格的函数（在输入无效时会出错），可以使用此函数代替。它可以解析 ISO 8601 标准的所有变体，因此除了上述格式之外，它还解析诸如 @code{1998W45-3} （周数）和 @code{1998-245} （序数天数）之类的内容。要解析持续时间，有 iso8601-parse-duration，要解析间隔，有 iso8601-parse-interval。所有这些函数都返回解码的时间结构，除了最后一个，它返回其中的三个（开始、结束和持续时间）。

@lisp
Function: format-time-string format-string &optional time zone ¶
@end lisp


此函数根据格式字符串将时间（或当前时间，如果时间省略或为零）转换为字符串。转换使用时区规则 zone，默认为当前时区规则。请参阅时区规则。参数格式字符串可能包含 '%' 序列，表示替换部分时间。以下是 '%' 序列的含义表：

@lisp
‘%a’
@end lisp

这代表星期几的缩写名称。
@lisp
‘%A’
@end lisp

这代表星期几的全名。
@lisp
‘%b’
@end lisp

这代表月份的缩写名称。
@lisp
‘%B’
@end lisp

这代表月份的全名。
@lisp
‘%c’
@end lisp

这是 @code{%x %X} 的同义词。
@lisp
‘%C’
@end lisp

这代表世纪，即年份除以 100，向零截断。默认字段宽度为 2。
@lisp
‘%d’
@end lisp

这代表一个月中的一天，零填充。
@lisp
‘%D’
@end lisp

这是 '%m/%d/%y' 的同义词。
@lisp
‘%e’
@end lisp

这代表月份的日期，空白填充。
@lisp
‘%F’
@end lisp

这代表 ISO 8601 日期格式，类似于 '%+4Y-%m-%d'，除了任何标志或字段宽度覆盖 @code{+} 和（减去 6 后） @code{4} 。
@lisp
‘%g’ ¶
@end lisp

这代表对应于当前 ISO 周数的没有世纪 (00–99) 的年份。ISO 周从星期一开始，到星期日结束。如果一个 ISO 周从一年开始并在另一年结束，那么关于 '%g' 将产生哪一年的规则很复杂，此处不再赘述；  但是，一般来说，如果一周中的大部分时间都在结束年份，则 '%g' 将产生那一年。
@lisp
‘%G’
@end lisp

这代表与当前 ISO 周数对应的带有世纪的年份。
@lisp
‘%h’
@end lisp

这是 '%b' 的同义词。
@lisp
‘%H’
@end lisp

这代表小时 (00–23)。
@lisp
‘%I’
@end lisp

这代表小时 (01–12)。
@lisp
‘%j’
@end lisp

这代表一年中的某一天 (001–366)。
@lisp
‘%k’
@end lisp

这代表小时（0-23），空白填充。
@lisp
‘%l’
@end lisp

这代表小时（1-12），空白填充。
@lisp
‘%m’
@end lisp

这代表月份 (01–12)。
@lisp
‘%M’
@end lisp

这代表分钟 (00–59)。
@lisp
‘%n’
@end lisp

这代表换行符。
@lisp
‘%N’
@end lisp

这代表纳秒 (000000000–999999999)。要要求更少的数字，请使用 '%3N' 表示毫秒，使用 '%6N' 表示微秒等。任何多余的数字都将被丢弃，不进行四舍五入。
@lisp
‘%p’
@end lisp

这代表 @code{AM} 或 @code{PM} ，视情况而定。
@lisp
‘%q’
@end lisp

这代表日历季度 (1-4)。
@lisp
‘%r’
@end lisp

这是 '%I:%M:%S %p' 的同义词。
@lisp
‘%R’
@end lisp

这是 '%H:%M' 的同义词。
@lisp
‘%s’
@end lisp

这代表自纪元以来的整数秒数。
@lisp
‘%S’
@end lisp

这代表秒（在支持闰秒的平台上为 00-59 或 00-60）。
@lisp
‘%t’
@end lisp

这代表制表符。
@lisp
‘%T’
@end lisp

这是 '%H:%M:%S' 的同义词。
@lisp
‘%u’
@end lisp

这代表一周中的数字天 (1–7)。星期一是第 1 天。
@lisp
‘%U’
@end lisp

这代表一年中的第几周（01-52），假设星期从星期日开始。
@lisp
‘%V’
@end lisp

根据 ISO 8601，这代表一年中的一周。
@lisp
‘%w’
@end lisp

这代表数字星期几 (0–6)。星期日是第 0 天。
@lisp
‘%W’
@end lisp

这代表一年中的一周（01-52），假设周从星期一开始。
@lisp
‘%x’
@end lisp

这具有特定于语言环境的含义。在默认语言环境（名为 @code{C} ）中，它等同于 @code{%D} 。
@lisp
‘%X’
@end lisp

这具有特定于语言环境的含义。在默认语言环境（名为 @code{C} ）中，它等同于 @code{%T} 。
@lisp
‘%y’
@end lisp

这代表没有世纪的年份（00-99）。
@lisp
‘%Y’
@end lisp

这代表有世纪的年份。
@lisp
‘%Z’
@end lisp

这代表时区缩写（例如， @code{EST} ）。
@lisp
‘%z’
@end lisp

这代表时区数字偏移量。 @code{z} 前面可以有一个、两个或三个冒号；  如果简单的 @code{%z} 代表 @code{-0500} ，那么 @code{%:z} 代表 @code{-05:00} ， @code{%::z} 代表 @code{-05:00:00} ， @code{%::}  :z' 与 '%::z' 类似，只是它抑制了 ':00' 的尾随实例，因此在同一个示例中它代表 '-05'。
@lisp
‘%%’
@end lisp

这代表单个 @code{％} 。

一个或多个标志字符可以紧跟在 '%' 之后。'0' 用零填充，'' 用零填充，并且在多于四位的非负年份数字之前放置 ''，'_' 用空格填充，'-' 禁止填充，'^' 大写字母， '#' 反转字母的大小写。

您还可以为这些 '%' 序列中的任何一个指定字段宽度和填充类型。这与在 printf 中一样工作：您将字段宽度写为 '%' 序列中的数字，在任何标志之后。例如，'%S' 指定从分钟开始的秒数；  '%03S' 表示用零填充到 3 个位置，'%@math{_3S}' 用空格填充到 3 个位置。普通的 '%3S' 用零填充，因为这就是 '%S' 通常填充到两个位置的方式。

当在 @code{%} 序列中的任何标志和字段宽度之后使用时，字符 @code{E} 和 @code{O} 充当修饰符。'E' 指定使用当前语言环境的替代版本的日期和时间。例如，在日本语言环境中，%Ex 可能会生成基于日本天皇在位的日期格式。在 @code{%Ec} 、 @code{%EC} 、 @code{%Ex} 、 @code{%EX} 、 @code{%Ey} 和 @code{%EY} 中允许使用 @code{E} 。

'O' 表示使用当前语言环境的替代数字表示，而不是普通的十进制数字。大多数字母都允许这样做，所有输出数字的字母。

为了帮助调试程序，无法识别的 '%' 序列代表它们自己并按原样输出。程序不应依赖这种行为，因为未来版本的 Emacs 可能会将新的 '%' 序列识别为扩展。

该函数使用 C 库函数 strftime（参见 GNU C 库参考手册中的格式化日历时间）来完成大部分工作。为了与该函数进行通信，它首先将时间和区域转换为内部形式；  操作系统限制时间和区域值的范围。此函数还使用由 locale-coding-system 指定的编码系统对格式字符串进行编码（请参阅区域设置）；  在 strftime 返回结果字符串后，此函数使用相同的编码系统对字符串进行解码。

@lisp
Function: format-seconds format-string seconds ¶
@end lisp

该函数根据 format-string 将其参数 seconds 转换为由年、日、小时等组成的字符串。参数格式字符串可能包含控制转换的 @code{%} 序列。以下是 '%' 序列的含义表：

@lisp
‘%y’
@end lisp
@lisp
‘%Y’
@end lisp

365 天年的整数。
@lisp
‘%d’
@end lisp
@lisp
‘%D’
@end lisp

整数天数。
@lisp
‘%h’
@end lisp
@lisp
‘%H’
@end lisp

整数小时数。
@lisp
‘%m’
@end lisp
@lisp
‘%M’
@end lisp

整数分钟数。
@lisp
‘%s’
@end lisp
@lisp
‘%S’
@end lisp

秒数。如果使用了可选的','参数，它是一个浮点数，','后面的数字指定使用多少个小数。'%,2s' 表示 @code{使用两位小数} 。
@lisp
‘%z’
@end lisp

非打印控制标志。使用时，其他说明符必须按大小递减的顺序给出，即年在天之前，小时在分钟之前，等等。在'%z'左侧的结果字符串中不会产生任何内容，直到第一个非遇到零转换。例如 emacs-uptime 使用的默认格式（见 emacs-uptime） @code{%Y, %D, %H, %M, %z%S}  表示总是会产生秒数，但会产生年数、天数、小时和分钟仅在非零时才会显示。
@lisp
‘%%’
@end lisp

产生一个文字 '%'。

大写格式序列除了数字之外还产生单位，小写格式只产生数字。

您还可以通过在 @code{％} 后面加上数字来指定字段宽度；  较短的数字将用空格填充。宽度请求零填充之前的可选时间段。例如， @code{%.3Y} 可能会产生 @code{004 年} 。

@node 419 处理器运行时间
@section 41.9 处理器运行时间

Emacs 提供了几个函数和原语，它们返回 Emacs 进程使用的时间，包括已用时间和处理器时间。

@lisp
Command: emacs-uptime &optional format ¶
@end lisp

这个函数返回一个代表 Emacs 正常运行时间的字符串——这个 Emacs 实例正在运行的挂钟时间。字符串根据可选参数格式由 format-seconds 格式化。有关可用的格式描述符，请参阅格式秒。如果 format 为 nil 或省略，则默认为 "%Y, %D, %H, %M, %z%S"。

当以交互方式调用时，它会在回声区域打印正常运行时间。

@lisp
Function: get-internal-run-time ¶
@end lisp

此函数返回 Emacs 使用的处理器运行时间，作为 Lisp 时间戳（请参阅时间）。

注意这个函数返回的时间不包括 Emacs 没有使用处理器的时间，如果 Emacs 进程有多个线程，则返回值是所有 Emacs 线程使用的处理器时间的总和。

如果系统没有提供确定处理器运行时间的方法，get-internal-run-time 将返回与当前时间相同的时间。

@lisp
Command: emacs-init-time ¶
@end lisp

此函数以字符串形式返回 Emacs 初始化的持续时间（请参阅摘要：启动时的操作序列），以秒为单位。当以交互方式调用时，它会在回声区域打印持续时间。

@node 4110 时间计算
@section 41.10 时间计算

这些函数使用时间值执行日历计算（请参阅时间）。与任何时间值一样，其任何时间值参数的 nil 值代表当前系统时间，单个数字代表自纪元以来的秒数。

@lisp
Function: time-less-p t1 t2 ¶
@end lisp

如果时间值 t1 小于时间值 t2，则返回 t。如果任一参数是 NaN，则结果为零。

@lisp
Function: time-equal-p t1 t2 ¶
@end lisp

如果 t1 和 t2 是相等的时间值，则返回 t。如果任一参数是 NaN，则结果为零。

@lisp
Function: time-subtract t1 t2 ¶
@end lisp

这将返回两个时间值之间的时间差 t1 - t2，作为 Lisp 时间值。结果是准确的，它的时钟分辨率并不比它的两个参数的分辨率差。仅当它是无限的或 NaN 时，结果才是浮点数。如果需要经过秒数单位的差异，可以使用 time-convert 或 float-time 进行转换。请参阅时间转换。

@lisp
Function: time-add t1 t2 ¶
@end lisp

这将返回两个时间值的总和，使用与时间减法相同的转换规则。一个参数应该表示一个时间差而不是一个时间点，作为一个时间值，通常只是一个经过的秒数。以下是如何将秒数添加到时间值：

@lisp
(time-add time seconds)
@end lisp

@lisp
Function: time-to-days time-value ¶
@end lisp

假设默认时区，此函数返回第 1 年开始与时间值之间的天数。操作系统限制时间和区域值的范围。

@lisp
Function: time-to-day-in-year time-value ¶
@end lisp

假设默认时区，这将返回与时间值对应的一年中的天数。操作系统限制时间和区域值的范围。

@lisp
Function: date-leap-year-p year ¶
@end lisp

如果 year 是闰年，此函数返回 t。

@lisp
Function: date-days-in-month year month ¶
@end lisp

返回一年中月份的天数。例如，2020 年 2 月有 29 天。

@lisp
Function: date-ordinal-to-time year ordinal ¶
@end lisp

将年份中的序数日期作为解码的时间结构返回。例如，2004 年的第 120 天是 4 月 29 日。

@node 4111 延迟执行的定时器
@section 41.11 延迟执行的定时器

您可以设置一个计时器，以在指定的未来时间或一定时间的空闲时间后调用函数。计时器是一个特殊的对象，它存储有关下一次调用时间和要调用的函数的信息。

@lisp
Function: timerp object ¶
@end lisp

如果 object 是计时器，则此谓词函数返回非 nil。

Emacs 不能在 Lisp 程序的任意点运行计时器；  只有当 Emacs 可以接受来自子进程的输出时，它才能运行它们：即，在等待时或在某些可以等待的原始函数（如坐席或读取事件）内。因此，如果 Emacs 忙，计时器的执行可能会延迟。但是，如果 Emacs 空闲，则执行时间非常精确。

Emacs 在调用定时器函数之前将禁止退出绑定到 t，因为退出许多定时器函数会使事物处于不一致的状态。这通常是没有问题的，因为大多数计时器功能不会做很多工作。实际上，对于一个需要大量时间来运行的函数来说，一个计时器可能会很烦人。如果一个定时器函数需要允许退出，它应该使用 with-local-quit（参见 Quitting）。例如，如果一个计时器函数调用accept-process-output 来接收来自外部进程的输出，那么该调用应该包含在with-local-quit 中，以确保在外部进程挂起时Cg 可以正常工作。

定时器函数更改缓冲区内容通常是个坏主意。当他们这样做时，他们通常应该在更改缓冲区之前和之后调用 undo-boundary，以将计时器的更改与用户命令的更改分开，并防止单个撤消条目变得非常大。

定时器函数还应该避免调用导致 Emacs 等待的函数，例如坐等（请参阅等待经过的时间或输入）。这可能会导致不可预知的效果，因为其他计时器（甚至同一个计时器）可以在等待时运行。如果一个定时器函数需要在某个时间过去后执行一个动作，它可以通过调度一个新的定时器来完成。

如果定时器函数执行远程文件操作，它可能与同一连接的已经运行的远程文件操作发生冲突。检测到此类冲突，它们会导致远程文件错误错误（请参阅标准错误）。这应该通过将定时器函数体包装起来来保护

@lisp
(ignore-error 'remote-file-error
  …)
@end lisp

如果计时器函数调用可以更改匹配数据的函数，它应该保存和恢复匹配数据。请参阅保存和恢复匹配数据。

@lisp
Command: run-at-time time repeat function &rest args ¶
@end lisp

这设置了一个计时器，该计时器在时间时间调用带有参数 args 的函数函数。如果repeat 是一个数字（整数或浮点数），则定时器计划在time 之后每隔repeat 秒再次运行。如果repeat 为nil，则定时器只运行一次。

time 可以指定绝对时间或相对时间。

绝对时间可以使用具有有限多种格式的字符串来指定，并且被认为是今天的时间，即使已经在过去。可识别的形式为 @code{xxxx} 、 @code{x:xx} 或 @code{xx:xx} （军用时间），以及 @code{xxam} 、 @code{xxAM} 、 @code{xxpm} 、 @code{xxPM} 、 @code{xx:xxam} 、 @code{xx}  :xxAM'、'xx:xxpm' 或 'xx:xxPM'。可以使用句点代替冒号来分隔小时和分钟部分。

要将相对时间指定为字符串，请使用数字后跟单位。例如：

@lisp
‘1 min’
@end lisp

表示从现在开始 1 分钟。
@lisp
‘1 min 5 sec’
@end lisp

表示从现在起 65 秒。
@lisp
‘1 min 2 sec 3 hour 4 day 5 week 6 fortnight 7 month 8 year’
@end lisp

正好表示从现在开始的 103 个月、123 天和 10862 秒。

对于相对时间值，Emacs 认为一个月正好是 30 天，而一年正好是 365.25 天。

并非所有方便的格式都是字符串。如果 time 是一个数字（整数或浮点），则指定以秒为单位的相对时间。encode-time 的结果也可以用来指定时间的绝对值。

在大多数情况下，重复对第一次调用发生的时间没有影响——只有时间指定了这一点。有一个例外：如果时间是 t，那么只要时间是 epoch 后重复秒数的倍数，计时器就会运行。这对于显示时间等功能很有用。

如果 Emacs 在定时器运行时没有获得任何 CPU 时间（例如，如果系统正忙于运行另一个进程，或者计算机正在睡眠或处于挂起状态），则定时器将在 Emacs 恢复时立即运行，并且闲。

run-at-time 函数返回一个计时器值，该值标识特定的计划未来操作。您可以使用此值来调用取消计时器（见下文）。

@lisp
Command: run-with-timer secs repeat function &rest args ¶
@end lisp

这与 run-at-time 完全相同（请参阅该定义以了解参数的说明；secs 作为时间传递给该函数），但应在以秒为单位指定延迟时使用。

重复计时器名义上应该每隔重复秒运行一次，但请记住，计时器的任何调用都可能延迟。一次重复的迟到对下一次重复的预定时间没有影响。例如，如果 Emacs 忙于计算足够长的时间以覆盖定时器的三个计划重复，然后开始等待，它会立即连续调用定时器函数 3 次（假设在它们之前或它们之间没有其他定时器触发）。如果您希望计时器在上次调用后不少于 n 秒再次运行，请不要使用 repeat 参数。相反，定时器函数应该显式地重新调度定时器。

@lisp
User Option: timer-max-repeats ¶
@end lisp

此变量的值指定在许多先前计划的调用不可避免地延迟时，连续重复调用计时器函数的最大次数。

@lisp
Macro: with-timeout (seconds timeout-forms…) body… ¶
@end lisp

执行身体，但在几秒钟后放弃。如果 body 在时间结束之前完成，with-timeout 返回 body 中最后一个表单的值。但是，如果 body 的执行被超时中断，那么 with-timeout 会执行所有的 timeout-forms 并返回它们中最后一个的值。

这个宏的工作原理是设置一个计时器在几秒后运行。如果 body 在此时间之前完成，它将取消计时器。如果计时器实际运行，它会终止 body 的执行，然后执行 timeout-forms。

由于计时器只能在程序调用可以等待的原语时在 Lisp 程序中运行，所以 with-timeout 不能在计算过程中停止执行主体——只有当它调用这些原语之一时。因此，with-timeout 只能用于等待输入的主体，而不是进行长时间计算的主体。

函数 y-or-np-with-timeout 提供了一种使用计时器的简单方法，以避免等待太久才能得到答案。请参阅是或否查询。

@lisp
Function: cancel-timer timer ¶
@end lisp

这取消了计时器的请求操作，它应该是一个计时器——通常是之前由 run-at-time 或 run-with-idle-timer 返回的计时器。这取消了对这些函数之一的调用的效果；  指定时间的到来不会导致任何特别的事情发生。

list-timers 命令列出所有当前活动的计时器。命令 c (timer-list-cancel) 将取消点下行的计时器。您可以使用命令 S (tabulated-list-sort) 按列对列表进行排序。

@node 4112 空闲定时器
@section 41.12 空闲定时器

以下是如何设置在 Emacs 空闲一定时间长度时运行的计时器。除了如何设置它们之外，空闲计时器的工作方式与普通计时器一样。

@lisp
Command: run-with-idle-timer secs repeat function &rest args ¶
@end lisp

设置一个计时器，该计时器在 Emacs 下一次空闲 secs 秒时运行。secs 的值可以是数字，也可以是 current-idle-time 返回的类型的值。

如果repeat 为nil，定时器只运行一次，第一次Emacs 保持空闲足够长的时间。更常见的重复是非零，这意味着每次 Emacs 保持空闲 secs 秒时运行计时器。

run-with-idle-timer 函数返回一个计时器值，您可以在调用取消计时器时使用它（请参阅延迟执行的计时器）。

Emacs 在开始等待用户输入时变为空闲状态，并且在用户提供一些输入之前它保持空闲状态。如果一个定时器设置为 5 秒空闲，它会在 Emacs 第一次空闲后运行大约 5 秒。即使repeat 不是nil，只要Emacs 保持空闲，这个定时器就不会再次运行，因为空闲的持续时间会继续增加，不会再次下降到5 秒。

Emacs 可以在空闲时做各种事情：垃圾收集、自动保存或处理来自子进程的数据。但是空闲期间的这些插曲不会干扰空闲计时器，因为它们不会将空闲时钟重置为零。设置为 600 秒的空闲计时器将在自最后一个用户命令完成十分钟后运行，即使在这十分钟内子进程输出已被接受数千次，即使已经进行了垃圾收集和自动保存。

当用户提供输入时，Emacs 在执行输入时变为非空闲状态。然后它再次变得空闲，所有设置为重复的空闲计时器随后将一个接一个地运行另一个时间。

不要编写包含循环的空闲计时器函数，该循环每次都会执行一定数量的处理，并在 (input-pending-p) 为非零时退出。这种方法看起来很自然，但有两个问题：

它阻止所有进程输出（因为 Emacs 仅在等待时接受进程输出）。
它会阻止任何应该在此期间运行的空闲计时器。

同样，不要编写一个空闲定时器函数来设置另一个空闲定时器（包括相同的空闲定时器），其 secs 参数小于或等于当前空闲时间。这样的计时器将几乎立即运行，并一次又一次地继续运行，而不是等待 Emacs 下一次空闲。正确的做法是使用空闲时间的当前值的适当增量重新调度，如下所述。

@lisp
Function: current-idle-time ¶
@end lisp

如果 Emacs 空闲，此函数返回 Emacs 空闲的时间长度，使用与当前时间相同的格式（请参阅时间）。

当 Emacs 不空闲时，current-idle-time 返回 nil。这是测试 Emacs 是否空闲的一种便捷方法。

current-idle-time 的主要用途是当一个空闲计时器函数想要 @code{休息} 一段时间。它可以设置另一个空闲计时器来再次调用相同的函数，在几秒钟之后再空闲。这是一个例子：

@lisp
(defvar my-resume-timer nil
  "Timer for `my-timer-function' to reschedule itself, or nil.")

(defun my-timer-function ()
  ;; If the user types a command while my-resume-timer
  ;; is active, the next time this function is called from
  ;; its main idle timer, deactivate my-resume-timer.
  (when my-resume-timer
    (cancel-timer my-resume-timer))
  ...do the work for a while...
  (when taking-a-break
    (setq my-resume-timer
          (run-with-idle-timer
            ;; Compute an idle time break-length
            ;; more than the current value.
            (time-add (current-idle-time) break-length)
            nil
            'my-timer-function))))
@end lisp

@node 4113 终端输入
@section 41.13 终端输入

本节介绍用于记录或操作终端输入的函数和变量。有关相关功能，请参阅 Emacs Display。

@menu
* 41.13.1 输入模式: 41131 输入模式. 
* 41.13.2 录音输入: 41132 录音输入. 
@end menu

@node 41131 输入模式
@subsection 41.13.1 输入模式

@lisp
Function: set-input-mode interrupt flow meta &optional quit-char ¶
@end lisp

该函数设置读取键盘输入的模式。如果中断是非零，那么 Emacs 使用输入中断。如果为 nil，则使用 CBREAK 模式。默认设置取决于系统。无论指定什么，某些系统总是使用 CBREAK 模式。

当 Emacs 直接与 X 通信时，它会忽略此参数并使用中断（如果这是它知道如何通信的方式）。

如果 flow 不是 nil，那么 Emacs 使用 XON/XOFF (Cq, Cs) 流控制来输出到终端。除了 CBREAK 模式外，这没有任何影响。

参数 meta 控制对 127 以上的输入字符代码的支持。如果 meta 为 t，Emacs 将设置第 8 位的字符转换为 Meta 字符，然后根据需要对它们进行解码（请参阅终端 I/O 编码）。如果 meta 为 nil，Emacs 忽略第 8 位；  当终端将其用作奇偶校验位时，这是必需的。如果 meta 是编码的符号，Emacs 首先使用每个字节的所有 8 位对字符进行解码，然后将解码后的单字节字符转换为 Meta 字符（如果设置了第 8 位）。最后，如果 meta 既不是 t 也不是 nil 也不是编码的，Emacs 使用所有 8 位输入不变，无论是在解码之前还是之后。这对于使用 8 位字符集并且不将 Meta 修饰符编码为第八位的终端非常有用。

如果 quit-char 不为 nil，它指定用于退出的字符。通常这个角色是Cg。请参阅退出。

current-input-mode 函数返回 Emacs 当前使用的输入模式设置。

@lisp
Function: current-input-mode ¶
@end lisp

此函数返回读取键盘输入的当前模式。它返回一个列表，对应于 set-input-mode 的参数，形式为（中断流元退出），其中：

@lisp
interrupt
@end lisp

当 Emacs 使用中断驱动输入时为非零。如果为零，则 Emacs 使用 CBREAK 模式。
@lisp
flow
@end lisp

如果 Emacs 使用 XON/XOFF (Cq, Cs) 流控制输出到终端，则为非零。该值仅在中断为 nil 时才有意义。
@lisp
meta
@end lisp

如果 Emacs 将输入字符的第 8 位视为解码输入之前的 Meta 位，则为 t；  如果 Emacs 将解码后的单字节字符的第 8 位视为 Meta 位，则进行编码；  如果 Emacs 清除每个输入字符的第 8 位，则为 nil；  任何其他值意味着 Emacs 使用所有八位作为基本字符代码。
@lisp
quit
@end lisp

是 Emacs 当前用于退出的字符，通常是 Cg。

@node 41132 录音输入
@subsection 41.13.2 录音输入

@lisp
Function: recent-keys &optional include-cmds ¶
@end lisp

此函数返回一个向量，其中包含来自键盘或鼠标的最后 300 个输入事件。包括所有输入事件，无论它们是否被用作键序列的一部分。因此，您始终会获得最后 300 个输入事件，不包括键盘宏生成的事件。（这些被排除在外，因为它们对调试不太感兴趣；看到调用宏的事件就足够了。）

如果 include-cmds 不是 nil，则结果向量中的完整键序列与 (nil . COMMAND) 形式的伪事件交错，其中 COMMAND 是键序列的绑定（请参阅命令循环概述）。

对 clear-this-command-keys 的调用（请参阅命令循环中的信息）会导致此函数随后立即返回一个空向量。

@lisp
Command: open-dribble-file filename ¶
@end lisp

此函数打开一个名为 filename 的 dribbble 文件。当一个 dribble 文件打开时，来自键盘或鼠标的每个输入事件（但不是来自键盘宏的输入事件）都会写入该文件中。非字符事件使用由 @code{<…>} 包围的打印表示来表示。请注意，敏感信息（例如密码）最终可能会记录在 dribble 文件中。

通过使用 nil 参数调用此函数来关闭 dribble 文件。

另请参阅 open-termscript 函数（请参阅终端输出）。

@node 4114 终端输出
@section 41.14 终端输出

终端输出功能将输出发送到文本终端，或跟踪发送到终端的输出。变量波特率告诉你 Emacs 认为终端的输出速度是多少。

@lisp
User Option: baud-rate ¶
@end lisp

这个变量的值是终端的输出速度，据 Emacs 所知。设置此变量不会改变实际数据传输的速度，但该值用于填充等计算。

它还影响有关是否滚动部分屏幕或在文本终端上重新绘制的决定。有关图形终端上的相应功能，请参阅强制重新显示。

该值以波特为单位。

如果您在网络上运行，并且网络的不同部分以不同的波特率工作，则 Emacs 返回的值可能与您本地终端使用的值不同。一些网络协议将本地终端速度传达给远程机器，以便 Emacs 和其他程序可以获得正确的值，但其他程序则不能。如果 Emacs 有错误的值，它会做出不是最优的决策。要解决此问题，请设置波特率。

@lisp
Function: send-string-to-terminal string &optional terminal ¶
@end lisp

此函数将字符串发送到终端而不进行更改。字符串中的控制字符具有与终端相关的效果。（如果您需要在终端上显示非 ASCII 文本，请使用显式编码和解码中描述的函数之一对其进行编码。）此函数仅在文本终端上运行。终端可以是终端对象、框架或选定框架终端的 nil。在批处理模式下，当终端为 nil 时，字符串被发送到标准输出。

该功能的一种用途是在具有可下载功能键定义的终端上定义功能键。例如，这是如何（在某些终端上）定义功能键 4 以向前移动四个字符（通过将字符 Cu Cf 传输到计算机）：

@lisp
(send-string-to-terminal "\eF4\^U\^F")
     ⇒ nil
@end lisp

@lisp
Command: open-termscript filename ¶
@end lisp

此函数用于打开一个 termscript 文件，该文件将记录 Emacs 发送到终端的所有字符。它返回零。Termscript 文件对于调查 Emacs 屏幕乱码的问题非常有用，这些问题是由于 Termcap 条目不正确或终端选项的不良设置导致的问题，而不是实际的 Emacs 错误。一旦确定实际输出了哪些字符，就可以可靠地确定它们是否符合使用的 Termcap 规范。

@lisp
(open-termscript "../junk/termscript")
     ⇒ nil
@end lisp

通过使用 nil 参数调用此函数来关闭 termscript 文件。

另请参阅录制输入中的 open-dribble-file。

@node 4115 声音输出
@section 41.15 声音输出

要使用 Emacs 播放声音，请使用函数 play-sound。仅支持某些系统；  如果您在无法真正完成工作的系统上调用 play-sound，则会出现错误。

声音必须存储为 RIFF-WAVE 格式 ('.wav') 或 Sun Audio 格式 ('.au') 的文件。

@lisp
Function: play-sound sound ¶
@end lisp

此函数播放指定的声音。参数 sound 的形式为 (sound properties@dots{})，其中属性由交替的关键字（特别识别的特定符号）和对应的值组成。

以下是当前在声音中有意义的关键字及其含义的表格：

@lisp
:file file
@end lisp

这指定了包含要播放的声音的文件。如果文件名不是绝对的，则根据目录数据目录进行扩展。
@lisp
:data data
@end lisp

这指定了无需引用文件即可播放的声音。值 data 应该是一个字符串，包含与声音文件相同的字节。我们建议使用单字节字符串。
@lisp
:volume volume
@end lisp

这指定了播放声音的音量。它应该是 0 到 1 范围内的数字。默认值是使用之前指定的任何音量。
@lisp
:device device
@end lisp

这将在其上播放声音的系统设备指定为字符串。默认设备取决于系统。

在实际播放声音之前，play-sound 会调用列表 play-sound-functions 中的函数。每个函数都用一个参数调用，声音。

@lisp
Command: play-sound-file file &optional volume device ¶
@end lisp

此功能是播放指定可选音量和设备的声音文件的替代接口。

@lisp
Variable: play-sound-functions ¶
@end lisp

在播放声音之前要调用的函数列表。每个函数都用一个参数调用，一个描述声音的属性列表。

@node 4116 X11 Keysyms 上的操作
@section 41.16 X11 Keysyms 上的操作

要定义系统特定的 X11 键符，请设置变量 system-key-alist。

@lisp
Variable: system-key-alist ¶
@end lisp

这个变量的值应该是一个列表，每个系统特定的键符都有一个元素。每个元素都有格式 (code.symbol)，其中 code 是数字键符代码（不包括特定于供应商的位，-2**28），symbol 是功能键的名称。

例如 (168 . mute-acute) 定义一个系统特定的键（由 HP X 服务器使用），其数字代码为 -2**28 + 168。

从 alist 中排除其他 X 服务器的键符并不重要；  只要它们不与实际使用的 X 服务器所使用的相冲突，它们就没有害处。

该变量始终是当前终端的本地变量，并且不能是缓冲区本地的。请参阅多个终端。

您可以通过设置这些变量来指定 Emacs 应该为 Control、Meta、Alt、Hyper 和 Super 修饰符使用哪些键符：

@lisp
Variable: x-ctrl-keysym ¶
@end lisp
@lisp
Variable: x-alt-keysym ¶
@end lisp
@lisp
Variable: x-meta-keysym ¶
@end lisp
@lisp
Variable: x-hyper-keysym ¶
@end lisp
@lisp
Variable: x-super-keysym ¶
@end lisp

应代表 Control 修饰符的键符名称（分别代表 Alt、Meta、Hyper 和 Super）。例如，这里是如何在 Emacs 中交换 Meta 和 Alt 修饰符：

@lisp
(setq x-alt-keysym 'meta)
(setq x-meta-keysym 'alt)
@end lisp

@node 4117 批处理模式
@section 41.17 批处理模式

命令行选项 '-batch' 使 Emacs 以非交互方式运行。在这种模式下，Emacs 不会从终端读取命令，它不会改变终端模式，也不会期望输出到可擦除屏幕。这个想法是您指定要运行的 Lisp 程序；  完成后，Emacs 应该退出。指定要运行的程序的方法是使用'-l file'，它加载名为file 的库，或'-f function'，它调用不带参数的函数，或'--eval=form'。

任何 Lisp 程序的输出，无论是使用消息，还是使用 prin1 等，以 t 作为流（请参阅输出流），在批处理模式下都会转到 Emacs 的标准描述符：消息写入标准错误描述符，而 prin1 和其他打印函数写入标准输出。类似地，通常来自 minibuffer 的输入是从标准输入描述符中读取的。因此，Emacs 的行为很像一个非交互式应用程序。（Emacs 本身通常生成的回显区域输出，例如命令回显，完全被抑制。）

写入标准输出或错误描述符的非 ASCII 文本默认情况下使用 locale-coding-system（请参阅 Locales）进行编码，如果它是非零的话；  这可以通过将 coding-system-for-write 绑定到您选择的编码系统来覆盖（请参阅显式编码和解码）。

@lisp
Variable: noninteractive ¶
@end lisp

当 Emacs 以批处理模式运行时，此变量不为零。

如果 Emacs 由于在批处理模式下发出错误信号而退出，则 Emacs 命令的退出状态为非零：

@lisp
$ emacs -Q --batch --eval '(error "foo")'; echo $?
foo
255
@end lisp

@node 4118 会话管理
@section 41.18 会话管理

Emacs 支持 X 会话管理协议，该协议用于暂停和重新启动应用程序。在 X Window 系统中，一个称为会话管理器的程序负责跟踪正在运行的应用程序。当 X 服务器关闭时，会话管理器要求应用程序保存它们的状态，并延迟实际关闭，直到它们做出响应。应用程序也可以取消关闭。

当会话管理器重新启动暂停的会话时，它会指示这些应用程序单独重新加载其保存的状态。它通过指定一个特殊的命令行参数来执行此操作，该参数说明要恢复的已保存会话。对于 Emacs，这个参数是 '--smid session'。

@lisp
Variable: emacs-save-session-functions ¶
@end lisp

Emacs 通过名为 emacs-save-session-functions 的钩子支持保存状态。当会话管理器告诉它窗口系统正在关闭时，Emacs 运行这个钩子。这些函数在没有参数的情况下被调用，并且当前缓冲区设置为临时缓冲区。每个函数都可以使用 insert 将 Lisp 代码添加到此缓冲区。最后，Emacs 将缓冲区保存在一个文件中，称为会话文件。

随后，当会话管理器重新启动 Emacs 时，它会自动加载会话文件（请参阅加载）。这是由一个名为 emacs-session-restore 的函数执行的，该函数在启动期间被调用。请参阅摘要：启动时的操作顺序。

如果 emacs-save-session-functions 中的函数返回非 nil，Emacs 会告诉会话管理器取消关闭。

这是一个示例，当会话管理器重新启动 Emacs 时，它只是在 @strong{scratch} 中插入一些文本。
@lisp


(add-hook 'emacs-save-session-functions 'save-yourself-test)


(defun save-yourself-test ()
  (insert
   (format "%S" '(with-current-buffer "*scratch*"
                   (insert "I am restored"))))
  nil)
@end lisp

@node 4119 桌面通知
@section 41.19 桌面通知

Emacs 能够在支持 freedesktop.org 桌面通知规范的系统和 MS-Windows 上发送通知。为了在 POSIX 主机上使用此功能，必须使用 D-Bus 支持编译 Emacs，并且必须加载通知库。请参阅 Emacs 中的 D-Bus 集成中的 D-Bus。当 D-Bus 支持可用时，支持以下功能：

@lisp
Function: notifications-notify &rest params ¶
@end lisp

该函数通过 D-Bus 向桌面发送通知，通知由 params 参数指定的参数组成。这些参数应该由交替的关键字和值对组成。支持的关键字和值如下：

@lisp
:bus bus
@end lisp

D-Bus 总线。仅当应使用 :session 以外的总线时才需要此参数。
@lisp
:title title
@end lisp

通知标题。
@lisp
:body text
@end lisp

通知正文。根据通知服务器的实现，文本可能包含 HTML 标记，如 @code{<b>粗体文本</b>} 、超链接或图像。必须将特殊的 HTML 字符编码为 @code{联系 <postmaster@@localhost>!} 。
@lisp
:app-name name
@end lisp

发送通知的应用程序的名称。默认值为通知应用程序名称。
@lisp
:replaces-id id
@end lisp

此通知替换的通知 ID。id 必须是先前通知通知调用的结果。
@lisp
:app-icon icon-file
@end lisp

通知图标的文件名。如果设置为 nil，则不显示图标。默认为通知应用程序图标。
@lisp
:actions (key title key title ...)
@end lisp

要应用的操作列表。key 和 title 都是字符串。默认操作（通常通过单击通知调用）应该有一个名为 @code{默认} 的键。标题可以是任何东西，尽管实现可以不显示它。
@lisp
:timeout timeout
@end lisp

自显示通知后通知应自动关闭的超时时间（以毫秒为单位）。如果为 -1，则通知的到期时间取决于通知服务器的设置，并且可能因通知类型而异。如果为 0，则通知永不过期。默认值为 -1。
@lisp
:urgency urgency
@end lisp

紧急程度。它可以是低的、正常的或严重的。
@lisp
:action-items
@end lisp

当给出这个关键字时，动作的标题字符串被解释为图标名称。
@lisp
:category category
@end lisp

通知的类型是字符串。有关标准类别的列表，请参阅桌面通知规范。
@lisp
:desktop-entry filename
@end lisp

这指定了代表调用程序的桌面文件名的名称，例如 @code{emacs} 。
@lisp
:image-data (width height rowstride has-alpha bits channels data)
@end lisp

这是一种原始数据图像格式，分别描述了宽度、高度、行距、是否有 alpha 通道、每个样本的位数、通道和图像数据。
@lisp
:image-path path
@end lisp

这表示为 URI（ @code{file://} 是目前唯一支持的 URI 模式）或来自 @code{$XDG_DATA_DIRS/icons} 的符合 freedesktop.org 的图标主题中的名称。
@lisp
:sound-file filename
@end lisp

弹出通知时要播放的声音文件的路径。
@lisp
:sound-name name
@end lisp

来自 @code{$XDG_DATA_DIRS/sounds} 的 freedesktop.org 声音命名规范中的主题命名声音，在通知弹出时播放。类似于图标名称，仅用于声音。一个例子是'"message-new-instant"'。
@lisp
:suppress-sound
@end lisp

使服务器抑制播放任何声音，如果它有能力的话。
@lisp
:resident
@end lisp

设置后，服务器不会在调用操作时自动删除通知。通知将一直驻留在服务器中，直到它被用户或发送者明确删除。此提示可能仅在服务器具有 :persistence 功能时才有用。
@lisp
:transient
@end lisp

设置时，服务器会将通知视为瞬态并绕过服务器的持久性能力（如果它应该存在）。
@lisp
:x position
@end lisp
@lisp
:y position
@end lisp

指定通知应指向的屏幕上的 X、Y 位置。两个参数必须一起使用。
@lisp
:on-action function
@end lisp

调用动作时调用的函数。通知 id 和操作的键作为参数传递给函数。
@lisp
:on-close function
@end lisp

当通知因超时或用户关闭时调用的函数。该函数接收通知 ID 和关闭原因作为参数：

如果通知已过期，则过期
如果通知被用户驳回，则驳回
close-notification 如果通知是通过调用通知关闭通知关闭的
如果通知服务器未提供原因，则未定义

通知服务器接受哪些参数可以通过通知获取功能进行检查。

此函数返回一个通知 id，一个整数，可用于使用通知关闭通知或另一个通知通知调用的 :replaces-id 参数来操作通知项。例如：

@lisp
(defun my-on-action-function (id key)
  (message "Message %d, key \"%s\" pressed" id key))
     ⇒ my-on-action-function


(defun my-on-close-function (id reason)
  (message "Message %d, closed due to \"%s\"" id reason))
     ⇒ my-on-close-function


(notifications-notify
 :title "Title"
 :body "This is <b>important</b>."
 :actions '("Confirm" "I agree" "Refuse" "I disagree")
 :on-action 'my-on-action-function
 :on-close 'my-on-close-function)
     ⇒ 22


A message window opens on the desktop.  Press ``I agree''.
     ⇒ Message 22, key "Confirm" pressed
        Message 22, closed due to "dismissed"
@end lisp

@lisp
Function: notifications-close-notification id &optional bus ¶
@end lisp

此函数关闭带有标识符 id 的通知。bus 可以是表示 D-Bus 连接的字符串，默认为 :session。

@lisp
Function: notifications-get-capabilities &optional bus ¶
@end lisp

返回通知服务器的功能，符号列表。bus 可以是表示 D-Bus 连接的字符串，默认为 :session。可以预期以下功能：

@lisp
:actions
@end lisp

服务器将向用户提供指定的操作。
@lisp
:body
@end lisp

支持正文。
@lisp
:body-hyperlinks
@end lisp

服务器支持通知中的超链接。
@lisp
:body-images
@end lisp

服务器支持通知中的图像。
@lisp
:body-markup
@end lisp

支持正文中的标记。
@lisp
:icon-multi
@end lisp

服务器将渲染给定图像数组中所有帧的动画。
@lisp
:icon-static
@end lisp

支持显示任何给定图像阵列的精确 1 帧。该值与 :icon-multi 互斥。
@lisp
:persistence
@end lisp

服务器支持通知的持久性。
@lisp
:sound
@end lisp

服务器支持通知声音。

更多特定于供应商的上限以 :x-vendor 开头，例如 :x-gnome-foo-cap。

@lisp
Function: notifications-get-server-information &optional bus ¶
@end lisp

返回通知服务器上的信息，字符串列表。bus 可以是表示 D-Bus 连接的字符串，默认为 :session。返回的列表是 (name vendor version spec-version)。

@lisp
name
@end lisp

服务器的产品名称。
@lisp
vendor
@end lisp

供应商名称。例如，'"KDE"'、'"GNOME"'。
@lisp
version
@end lisp

服务器的版本号。
@lisp
spec-version
@end lisp

服务器符合的规范版本。

如果 spec@math{_version} 为 nil，则服务器支持 '"1.0"' 之前的规范。

当 Emacs 作为 GUI 会话在 MS-Windows 上运行时，它通过原生原语支持一小部分 D-Bus 通知功能：

@lisp
Function: w32-notification-notify &rest params ¶
@end lisp

此函数显示由 params 指定的 MS-Windows 托盘通知。MS-Windows 托盘通知显示在任务栏通知区域中的图标的气球中。

值是通知的整数唯一 ID，可用于使用 w32-notification-close 删除通知，如下所述。如果函数失败，则返回值为 nil。

参数 params 被指定为关键字/值对。所有参数都是可选的，但是如果没有指定参数，函数什么也不做，返回 nil。

支持以下参数：

@lisp
:icon icon
@end lisp

在系统托盘中显示图标。如果 icon 是一个字符串，它应该指定一个从中加载图标的文件名；  指定的文件应该是 .ico Windows 图标文件。如果 icon 不是字符串，或者没有指定此参数，则将使用标准 Emacs 图标。
@lisp
:tip tip
@end lisp

使用tip 作为通知的工具提示。如果tip 是一个字符串，则这是当鼠标指针悬停在通知添加的托盘图标上时将显示的工具提示文本。如果tip 不是字符串，或者未指定此参数，则默认工具提示文本为 @code{Emacs 通知} 。工具提示文本最长可达 127 个字符（W2K 之前的 Windows 版本为 63 个）。较长的字符串将被截断。
@lisp
:level level
@end lisp

通知严重性级别，信息、警告或错误之一。如果给定，则该值确定显示在通知标题左侧的图标，但前提是还指定了 :title 参数（见下文）并且是字符串。
@lisp
:title title
@end lisp

通知的标题。如果标题是一个字符串，它会在正文上方以较大的字体显示。标题文本最长可达 63 个字符；  较长的文本将被截断。
@lisp
:body body
@end lisp

通知的正文。如果 body 是一个字符串，它指定通知消息的文本。使用嵌入的换行符来控制文本被分成几行的方式。正文文本最长可达 255 个字符，如果过长将被截断。与 D-Bus 不同，正文应该是纯文本，没有标记。

请注意，W2K 之前的 Windows 版本仅支持 :icon 和 :tip。可以传递其他参数，但在那些旧系统上它们将被忽略。

在任何给定时间最多只能有一个活动通知。必须通过调用 w32-notification-close 删除活动通知，然后才能显示新通知。

要从任务栏中删除通知及其图标，请使用以下函数：

@lisp
Function: w32-notification-close id ¶
@end lisp

此函数删除由其唯一 ID 给出的托盘通知。

@node 4120 文件更改通知
@section 41.20 文件更改通知

一些操作系统支持监视文件系统以查找文件更改。如果配置正确，Emacs 会静态链接相应的库，如 inotify、kqueue、gfilenotify 或 w32notify。这些库可以监视本地机器上的文件系统。

也可以查看远程机器上的文件系统，参见 GNU Emacs 手册中的远程文件 这不依赖于链接到 Emacs 的库之一。

由于所有这些库都会在通知文件更改时发出不同的事件，因此 Emacs 库 filenotify 提供了一个统一的接口。想要接收文件通知的 Lisp 程序应该始终优先使用这个库而不是本地库。

@lisp
Function: file-notify-add-watch file flags callback ¶
@end lisp

添加对与文件有关的文件系统事件的监视。这安排了与要报告给 Emacs 的文件有关的文件系统事件。

返回值是添加的手表的描述符。它的类型取决于底层库，不能假定为整数，如下例所示。它应该仅用于相等的比较。

如果由于某种原因无法查看文件，则此函数会发出 file-notify-error 错误信号。

有时，无法监视已挂载的文件系统的文件更改。此函数未检测到这一点，非零返回值不保证将通知文件更改。

flags 是设置要监视的条件的列表。它可以包括以下符号：

@lisp
change
@end lisp

监视文件更改
@lisp
attribute-change
@end lisp

监视文件属性更改，例如权限或修改时间

如果 file 是一个目录，则更改该目录中文件创建或删除的监视。一些文件通知后端报告还文件更改。这不能递归地工作。

当任何事件发生时，Emacs 将调用回调函数传递给它一个单参数事件，其形式为

@lisp
(descriptor action file [file1])
@end lisp

描述符是与此函数返回的对象相同的对象。action 是事件的描述。它可以是以下任何一种符号：

@lisp
created
@end lisp

文件已创建
@lisp
deleted
@end lisp

文件已被删除
@lisp
changed
@end lisp

文件内容已更改；  使用 w32notify 库，还可以报告属性更改
@lisp
renamed
@end lisp

文件已重命名为 file1
@lisp
attribute-changed
@end lisp

文件属性已更改
@lisp
stopped
@end lisp

观看文件已停止

请注意，w32notify 库不报告属性更改事件。当某些文件的属性（例如权限或修改时间）发生更改时，此库会报告更改事件。同样，kqueue 库在监视目录时不会可靠地报告文件属性更改。

停止事件报告，观看文件已停止。这可能是因为调用了 file-notify-rm-watch（见下文），或者因为正在监视的文件被删除，或者由于底层库报告了另一个错误。

file 和 file1 是正在报告其事件的文件的名称。例如：
@lisp
(require 'filenotify)
     ⇒ filenotify


(defun my-notify-callback (event)
  (message "Event %S" event))
     ⇒ my-notify-callback


(file-notify-add-watch
  "/tmp" '(change attribute-change) 'my-notify-callback)
     ⇒ 35025468


(write-region "foo" nil "/tmp/foo")
     ⇒ Event (35025468 created "/tmp/.#foo")
        Event (35025468 created "/tmp/foo")
        Event (35025468 changed "/tmp/foo")
        Event (35025468 deleted "/tmp/.#foo")


(write-region "bla" nil "/tmp/foo")
     ⇒ Event (35025468 created "/tmp/.#foo")
        Event (35025468 changed "/tmp/foo")
        Event (35025468 deleted "/tmp/.#foo")


(set-file-modes "/tmp/foo" (default-file-modes) 'nofollow)
     ⇒ Event (35025468 attribute-changed "/tmp/foo")
@end lisp
Whether the action renamed is returned, depends on the used watch library. Otherwise, the actions deleted and created could be returned in a random order.

@lisp


(rename-file "/tmp/foo" "/tmp/bla")
     ⇒ Event (35025468 renamed "/tmp/foo" "/tmp/bla")


(delete-file "/tmp/bla")
     ⇒ Event (35025468 deleted "/tmp/bla")

@end lisp
@lisp
Function: file-notify-rm-watch descriptor ¶
@end lisp

删除由其描述符指定的现有文件监视。描述符应该是 file-notify-add-watch 返回的对象。

@lisp
Function: file-notify-valid-p descriptor ¶
@end lisp

检查由其描述符指定的手表的有效性。描述符应该是 file-notify-add-watch 返回的对象。

如果监视的文件或目录被删除，或者监视线程由于任何其他原因异常退出，则监视可能会变得无效。通过调用 file-notify-rm-watch 删除监视也会使其无效。
@lisp


(make-directory "/tmp/foo")
     ⇒ Event (35025468 created "/tmp/foo")


(setq desc
      (file-notify-add-watch
        "/tmp/foo" '(change) 'my-notify-callback))
     ⇒ 11359632


(file-notify-valid-p desc)
     ⇒ t


(write-region "bla" nil "/tmp/foo/bla")
     ⇒ Event (11359632 created "/tmp/foo/.#bla")
        Event (11359632 created "/tmp/foo/bla")
        Event (11359632 changed "/tmp/foo/bla")
        Event (11359632 deleted "/tmp/foo/.#bla")


;; Deleting a file in the directory doesn't invalidate the watch.
(delete-file "/tmp/foo/bla")
     ⇒ Event (11359632 deleted "/tmp/foo/bla")


(write-region "bla" nil "/tmp/foo/bla")
     ⇒ Event (11359632 created "/tmp/foo/.#bla")
        Event (11359632 created "/tmp/foo/bla")
        Event (11359632 changed "/tmp/foo/bla")
        Event (11359632 deleted "/tmp/foo/.#bla")


;; Deleting the directory invalidates the watch.
;; Events arrive for different watch descriptors.
(delete-directory "/tmp/foo" 'recursive)
     ⇒ Event (35025468 deleted "/tmp/foo")
        Event (11359632 deleted "/tmp/foo/bla")
        Event (11359632 deleted "/tmp/foo")
        Event (11359632 stopped "/tmp/foo")


(file-notify-valid-p desc)
     ⇒ nil
@end lisp

@node 4121 动态加载的库
@section 41.21 动态加载的库

动态加载的库是在首次需要其设施时按需加载的库。Emacs 支持对其某些功能的这种按需加载支持库。

@lisp
Variable: dynamic-library-alist ¶
@end lisp

这是动态库和实现它们的外部库文件的列表。

每个元素都是表单（库文件@dots{}）的列表，其中 car 是表示支持的外部库的符号，其余是为该库提供备用文件名的字符串。

Emacs 尝试按照它们在列表中出现的顺序从文件中加载库；  如果没有找到，Emacs 会话将无法访问该库，并且它提供的功能将不可用。

某些平台上的图像支持使用此功能。下面是设置此变量以支持 MS-Windows 上的图像的示例：

@lisp
(setq dynamic-library-alist
      '((xpm "libxpm.dll" "xpm4.dll" "libXpm-nox4.dll")
        (png "libpng12d.dll" "libpng12.dll" "libpng.dll"
             "libpng13d.dll" "libpng13.dll")
        (jpeg "jpeg62.dll" "libjpeg.dll" "jpeg-62.dll"
              "jpeg.dll")
        (tiff "libtiff3.dll" "libtiff.dll")
        (gif "giflib4.dll" "libungif4.dll" "libungif.dll")
        (svg "librsvg-2-2.dll")
        (gdk-pixbuf "libgdk_pixbuf-2.0-0.dll")
        (glib "libglib-2.0-0.dll")
        (gobject "libgobject-2.0-0.dll")))
@end lisp

请注意，图像类型 pbm 和 xbm 不需要此变量中的条目，因为它们不依赖于外部库并且在 Emacs 中始终可用。

另请注意，此变量并非用于访问外部库的通用工具；  只有 Emacs 已知的那些才能通过它加载。

如果给定的库静态链接到 Emacs，则忽略此变量。

@node 4122 安全考虑
@section 41.22 安全考虑

与任何应用程序一样，Emacs 可以在安全的环境中运行，其中操作系统强制执行有关访问等的规则。稍加注意，基于 Emacs 的应用程序也可以成为检查此类规则的安全边界的一部分。尽管 Emacs 的默认设置适用于典型的软件开发环境，但它们可能需要在包含可能包括攻击者的不受信任用户的环境中进行调整。如果您正在开发此类应用程序，以下是安全问题的概要，可能会对您有所帮助。它绝不是完整的；  它旨在让您了解所涉及的安全问题，而不是作为安全清单。

@lisp
File local variables ¶
@end lisp

Emacs 访问的文件可以包含影响访问该文件的缓冲区的变量设置；  请参阅文件局部变量。类似地，一个目录可以指定该目录中所有文件共有的局部变量值；  请参阅目录局部变量。尽管 Emacs 采取了一些措施来防止这些变量的滥用，但仅仅通过过于乐观地设置 safe-local-variable 的包就可以创建一个安全漏洞，这个问题太常见了。要对文件和目录禁用此功能，请将 enable-local-variables 设置为 nil。
@lisp
Access control
@end lisp

尽管 Emacs 通常尊重底层操作系统的访问权限，但在某些情况下它会专门处理访问。例如，文件名可以具有专门处理文件的处理程序，并具有自己的访问检查。请参阅使某些文件名 @code{神奇} 。此外，即使相应的文件是可写的，缓冲区也可以是只读的，反之亦然，这可能导致诸如'File passwd is write-protected;  无论如何尝试保存？  （是还是不是）'。请参阅只读缓冲区。
@lisp
Authentication
@end lisp

Emacs 有几个处理密码的函数，例如 read-passwd。请参阅读取密码。尽管这些函数不会尝试向世界广播密码，但它们的实现并不能证明可以访问 Emacs 内部的坚定攻击者。例如，即使 Elisp 代码在使用后使用 clear-string 从其内存中清除密码，密码的残余部分仍可能驻留在垃圾回收的空闲列表中。请参阅修改字符串。
@lisp
Code injection
@end lisp

Emacs 可以向许多其他应用程序发送命令，并且应用程序应该注意作为这些命令的操作数发送的字符串不会被误解为指令。例如，当使用 shell 命令将文件 a 重命名为 b 时，不要简单地使用字符串 mv ab，因为文件名可能以 @code{-} 开头，或者可能包含 shell 元字符，如 @code{;} 。尽管 shell-quote-argument 之类的函数可以帮助避免此类问题，但它们并不是万能的；  例如，在 POSIX 平台上，shell-quote-argument 引用 shell 元字符但不前导 @code{-} 。在 MS-Windows 上，引用 '%' 假定所有环境变量的名称中都没有 '^'。请参阅 Shell 参数。通常使用 call-process 比使用 subshel​​l 更安全。请参阅创建同步进程。而且使用内置的 Emacs 函数更安全；  例如，使用 (rename-file "a" "b" t) 而不是调用 mv。请参阅更改文件名和属性。
@lisp
Coding systems
@end lisp

Emacs 尝试推断它访问的文件和网络连接的编码系统。请参阅编码系统。如果 Emacs 推断不正确，或者如果网络连接的其他方不同意 Emacs 的推断，则生成的系统可能不可靠。此外，即使推断正确，Emacs 也经常可以使用其他程序无法使用的字节。例如，尽管对于 Emacs 空字节只是一个字符，但许多其他应用程序将其视为字符串终止符并错误处理包含空字节的字符串或文件。
@lisp
Environment and configuration variables
@end lisp

POSIX 指定了几个可以影响 Emacs 行为方式的环境变量。任何名称完全由大写 ASCII 字母、数字和下划线组成的环境变量都可能影响 Emacs 的内部行为。Emacs 使用了几个这样的变量，例如，EMACSLOADPATH。请参阅图书馆搜索。在某些平台上，某些环境变量（例如，PATH、POSIXLY@math{_CORRECT}、SHELL、TMPDIR）需要具有正确配置的值，以便获得 Emacs 可能调用的任何实用程序的标准行为。即使像 TZ 这样看似良性的变量也可能具有安全隐患。请参阅操作系统环境。

Emacs 具有自定义和其他具有类似考虑的变量。例如，如果变量 shell-file-name 指定了具有非标准行为的 shell，则基于 Emacs 的应用程序可能会出现异常。
@lisp
Installation
@end lisp

在安装 Emacs 时，如果安装目录层次结构可以被不受信任的用户修改，则应用程序不能被信任。这也适用于 Emacs 使用的程序的目录层次结构，以及 Emacs 读取和写入的文件的目录层次结构。
@lisp
Network access
@end lisp

Emacs 经常访问网络，您可能需要对其进行配置以避免它通常会进行的网络访问。例如，除非您将 tramp-mode 设置为 nil，否则使用特定语法的文件名将被解释为网络文件，并通过网络进行检索。请参阅《流浪汉手册》中的《流浪汉手册》。
@lisp
Race conditions
@end lisp

Emacs 应用程序具有与其他应用程序相同的竞争条件问题。例如，即使 (file-readable-p "foo.txt") 返回 t，也可能是 foo.txt 不可读，因为其他程序在调用 file-readable-p 和现在之间更改了文件的权限。请参阅测试可访问性。
@lisp
Resource limits
@end lisp

当 Emacs 耗尽内存或其他操作系统资源时，它的行为可能不太可靠，因为通常运行到完成的计算可能会中止回到顶层。这可能会导致 Emacs 忽略它通常会执行的操作。

@bye