file.setText

Home

4D v19

file.setText

Beschreibung

Die Methode file.setText schreibt text als den neuen Inhalt von File.

Existiert die im Objekt File angegebene Datei nicht auf der Festplatte, wird sie von der Methode angelegt. Existiert sie bereits, wird der bisherige Inhalt entfernt, außer sie ist schon geöffnet. In diesem Fall ist der Inhalt gesperrt und ein Fehler wird generiert.

In text übergeben Sie den Text für die Datei. Das kann ein buchstäblicher Text ("my text") oder eine 4D Textfeld oder Variable sein.

In charSet übergeben Sie den Zeichensatz zum Schreiben des Inhalts. Sie können einen String mit dem Standardnamen (z.B. “ISO-8859-1” oder “UTF-8”) bzw. seine MIBEnum ID (Lange Ganzzahl) angeben. Weitere Informationen dazu finden Sie unter dem Befehl CONVERT FROM TEXT. Gibt es für den Zeichensatz ein Byte Order Mark (BOM), fügt 4D ihn in die Datei ein. Geben Sie keinen Zeichensatz an, verwendet 4D standardmäßig den Zeichensatz "UTF-8" und ein BOM.

In breakMode können Sie eine Lange Ganzzahl für die Verwaltung von Zeichen für Zeilenende vor dem Sichern in der Datei übergeben. Es gibt folgende Konstanten unter dem Thema "Systemdokumente":

Konstante	Typ	Wert	Kommentar
Document unchanged	Lange Ganzzahl	0	Keine Bearbeitung
Document with native format	Lange Ganzzahl	1	(Standard) Zeilenumbrüche werden in das native Format des Betriebssystems konvertiert: CR (carriage return auf Mac OS), CRLF (carriage return + line feed unter Windows)
Document with CRLF	Lange Ganzzahl	2	Zeilenumbrüche werden in das Windows Format konvertiert: CRLF (carriage return + line feed)
Document with CR	Lange Ganzzahl	3	Zeilenumbrüche werden in das Mac OS Format konvertiert: CR (carriage return)
Document with LF	Lange Ganzzahl	4	Zeilenumbrüche werden in das Unix Format konvertiert: LF (line feed)

Standardmäßig, also ohne den Parameter breakMode, werden Zeilenenden im native Modus (1) bearbeitet.

Beispiel

 $myFile:=File("C:\\Documents\\Hello.txt";fk platform path)

 $myFile.setText("Hello world")

Siehe auch

file.getText