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 必须是大于或等于 0 的整数。如果 n 为 0,则不强制实施最大行长度。如果文档中有的行的长度大于 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 操作
缺省编辑器命令