save 指令

使用 save 指令來儲存現行文件。

語法

save [ prompt
     | visible
     | trim
     | noTrim
     | textLimit n
     | encoding charEncoding
     | lineSeparator { CRLF | CR | LF }
     ] [...]
     [ "filename" ] 

參數

prompt 使用選用參數 prompt 來提示使用者提供這份文件的存檔名稱。
visible 使用選用參數 visible 來指出只有可見的元素才應該儲存。
trim 使用選用參數 trim 來指出文件的所有字行的任何尾端空格都應該去除。 如果沒有指定 trimnoTrim,則從 current.save.trim 參數的現行設定值取得這個選項。
noTrim 使用選用參數 noTrim 來確定不要去除文件字行。 如果沒有指定 trimnoTrim,則從 current.save.trim 參數的設定值取得這個選項。
textLimit n 使用選用參數 textLimit 來指出字行長度上限。 n 必須是一個大於或等於零的整數。如果 n 為零,則不會強制字行長度上限。如果文件中的字行長度超過 n, 則那些行會被截斷。如果您沒有指定 textLimit,則會從 current.save.textLimit 參數中取得設定值。
encoding charEncoding 使用選用參數 encoding 來指定已儲存檔案的字元編碼。如果您沒有指定 encoding, 則會使用用來載入原始檔案的字元編碼。
lineSeparator 使用選用參數 lineSeparator 來指定應該用來儲存的行定界字元。您可以指定下列其中一項:
  • CRLF - "\r\n" (0x0D, 0x0A)
  • LF - "\n" (0x0A)
  • CR - "\r" (0x0D)。
如果您沒有指定 lineSeparator,則會使用平台的預設字行分隔字元。
filename 使用 filename 參數來指定這份文件的存檔名稱。如果沒有指定的話,就會用 name 設定中的名稱來儲存文件。

狀態

status 參數可設為下列其中一項:
null 指出順利完成儲存。
save.failed 指出儲存失敗。
save.cancelled 指出使用者取消了儲存。

說明

使用不同的檔名儲存時,不會使用 trimtextLimit 設定值。

附註:編輯器應用程式中儲存作業的實作可能會不同於這裡所說明的基本編輯器的行為。

範例

save
save "test.java" 
相關概念
編輯器指令、動作和參數

相關參照
length 參數
name 參數
save.lineSeparator 參數
save.textLimit 參數
save.trim 參數
visible 參數
save 動作
saveAs 動作
saveToWriter 動作
預設編輯器指令