概述 (ADD DOCUMENT 命令)

ADD DOCUMENT 将任意长度的文本块保存在活动数据集中。 结果等同于 DOCUMENT 命令。 可以使用 DISPLAY DOCUMENT 命令显示文档。

当 GET 检索数据文件，或者 APPLY DICTIONARY 用于应用另一数据文件中的文档，或者 ADD FILES， MATCH FILES或 UPDATE 用于组合数据文件时，会将每个指定文件中的所有文档复制到工作文件中。 DROP DOCUMENTS 可用于从工作文件中删除这些文档。

基本规范

基本规范是 ADD DOCUMENT 后跟一个或多个可选的带引号文本行。 当数据文件以 IBM® SPSS® Statistics 格式保存时，文本将存储在文件字典中。

语法规则

• 每行必须以单引号或双引号括起，遵循带引号字符串的标准规则。
• 每行可长达 80 字节 (通常是单字节语言中的 80 个字符) ，包括命令名，但不包括用于将文本括起来的引号。 如果任何行超过 80 字节，那么将产生错误，并且不会执行该命令。
• 可以根据需要在任意行上输入文本。
• 可以为同一数据文件指定多个 ADD DOCUMENT 命令。

• 来自每个 ADD DOCUMENT 命令的文本将附加到文档列表的末尾，后跟括号中的日期。
• 没有带引号的文本字符串的 ADD DOCUMENT 命令将括号中的日期附加到文档中。
• DISPLAY DOCUMENTS 将显示在 ADD DOCUMENT 和/或 DOCUMENT 命令上指定的数据文件的所有文档。 文档完全按输入的方式显示; ADD DOCUMENT 命令的每一行都显示为单独的一行，并且没有换行。
• DROP DOCUMENTS 将删除由 ADD DOCUMENT 和 DOCUMENT创建的所有文档。

示例

如果在同一行上指定了命令名和带引号的文本字符串，那么命令名将计入 80 字节的行限制，因此最好将命令名放在单独的行上，如:

ADD DOCUMENT
  "This is some text that describes this file.".

示例

要在文本块之间插入空白行，请输入空字符串，如下所示:

ADD DOCUMENT
  "This is some text that describes this file."
  ""
  "This is some more text preceded by a blank line.".