Befehl save

Mit dem Befehl save können Sie das aktuelle Dokument sichern.

Syntax

save [ prompt
     | visible
     | trim
     | noTrim
     | textLimit n
     | encoding Zeichenverschlüsselung
     | lineSeparator { CRLF | CR | LF }
     ] [...]
     [ "Dateiname" ] 

Parameter

prompt Verwenden Sie den optionalen Parameter prompt, um den Benutzer zur Eingabe des Dateinamens aufzufordern, unter dem dieses Dokument gesichert werden soll.
visible Verwenden Sie den optionalen Parameter visible, um anzugeben, dass nur die sichtbaren Elemente gesichert werden sollen.
trim Verwenden Sie den optionalen Parameter trim, um anzugeben, dass bei allen Zeilen des Dokuments die nachgestellten Leerzeichen abgeschnitten werden sollen.  Wird trim oder noTrim nicht angegeben, wird die Option aus der aktuellen Einstellung des Parameters current.save.trim verwendet.
noTrim Verwenden Sie den optionalen Parameter noTrim, um sicherzustellen, dass die Zeilen des Dokuments nicht abgeschnitten werden.  Wird trim oder noTrim nicht angegeben, wird die Option aus der Einstellung des Parameters current.save.trim verwendet.
textLimit n Verwenden Sie den optionalen Parameter textLimit, um die maximale Zeilenlänge anzugeben.  n muss eine ganze Zahl größer-gleich Null sein.  Ist n Null, wird keine maximale Zeilenlänge erzwungen.  Enthält das Dokument Zeilen, die länger als n sind, werden diese Zeilen abgeschnitten.  Wird textLimit nicht angegeben, wird die Einstellung aus dem Parameter current.save.textLimit verwendet.
encoding charEncoding Verwenden Sie den optionalen Parameter encoding, um die Zeichenverschlüsselung der gesicherten Datei anzugeben.  Wird encoding nicht angegeben, kommt die Zeichenverschlüsselung, die zum Laden der Originaldatei verwendet wurde, zum Einsatz.
lineSeparator Verwenden Sie den optionalen Parameter lineSeparator, um die Zeilenbegrenzungszeichen anzugeben, die für die Sicherung verwendet werden sollen.  Sie können eine der folgenden Einstellungen wählen:
  • CRLF - "\r\n" (0x0D, 0x0A)
  • LF - "\n" (0x0A)
  • CR - "\r" (0x0D).
Wird lineSeparator nicht angegeben, wird das für die Plattform standardmäßig vorgegebene Zeilentrennzeichen verwendet.
Dateiname Mit dem Parameter Dateiname kann der Dateiname angegeben werden, unter dem dieses Dokument gesichert werden soll.  Wird kein Dateiname angegeben, wird das Dokument unter dem Namen in der Einstellung Name gesichert.

Status

Der Parameter status wird auf einen der folgenden Werte gesetzt:
null Gibt an, dass die Sicherung erfolgreich war.
save.failed Gibt an, dass die Sicherung nicht erfolgreich war.
save.cancelled Gibt an, dass die Sicherung vom Benutzer abgebrochen wurde.

Beschreibung

Erfolgt die Sicherung unter einem anderen Dateinamen, werden die Einstellungen trim und textLimit nicht verwendet.

Anmerkung:  Die Implementierung der Sicherungsoperationen in einer Editoranwendung weicht unter Umständen vom Verhalten des Basiseditors, wie es im vorliegenden Dokument beschrieben wird, ab.

Beispiele

save
save "test.java" 
Zugehörige Konzepte
Editorbefehle, Aktionen und Parameter

Zugehöriger Verweis
Parameter length
Parameter name
Parameter save.lineSeparator
Parameter save.textLimit
Parameter save.trim
Parameter visible
Aktion save
Aktion saveAs
Aktion saveToWriter
Standardeditorbefehle