概觀 (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 指令上所指定資料檔案的所有文件。 Documentation 與輸入的完全相同; 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.".