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,则将使用 current.save.lineSeparator 参数的设置。
filename 使用 filename 参数来指定保存此文档时应该使用的文件名。如果未指定该参数,则将使用 name 参数设置中的名称保存文档。如果还指定了可选参数 prompt,则会使用指定的文件名初始化保存对话框。

状态

status 参数将被设置为下列其中一项:
null 保存成功。
save.cancelled 用户取消了保存。
save.failed 保存不成功。

描述

当使用另一文件名进行保存时,将不使用 trimtextLimit 设置。

注意:编辑器应用程序中保存操作的实现可能与这里描述的基本编辑器的行为不同。

示例

save
save "test.java"
save prompt "test.java" 

相关概念
编辑器命令、操作和参数

相关参考
trim 命令
length 参数
name 参数
save.lineSeparator 参数
save.textLimit 参数
save.trim 参数
status 参数
visible 参数
save 操作
saveAs 操作
saveToWriter 操作