file.setText

Home

4D v19.8

file.setText


file.setText ( text {; charSet {; breakMode}} )

Parameter	Typ	Beschreibung
text	Text	Text zum Speichern in File
charSet	Text, Lange Ganzzahl	Name oder Nummer des Zeichensatzes
breakMode	Lange Ganzzahl	Behandlung von Zeilenenden

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" ohne BOM (außer im Kompatibilitätsmodus, siehe Seite Kompatibilität).

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: LF (carriage return auf Mac OS), CRLF (carriage return + line feed unter Windows)
Document with CRLF	Lange Ganzzahl	2	Zeilenumbrüche werden in CRLF (Carriage Return + Line Feed) umgewandelt, dem Standardformat von Windows.
Document with CR	Lange Ganzzahl	3	Zeilenumbrüche werden in CR (Carriage Return) umgewandelt, dem Standardformat von Classic Mac OS.
Document with LF	Lange Ganzzahl	4	Zeilenumbrüche werden in LF (Line Feed) umgewandelt, dem Standardformat von Unix und macOS.

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