file.getText

Home

4D v19.8

file.getText


file.getText ( {charSet}{;}{breakMode} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
charSet	Text, Lange Ganzzahl	Name oder Nummer des Zeichensatzes
breakMode	Lange Ganzzahl	Behandlung von Zeilenenden
Funktionsergebnis	Text	Text aus dem Dokument

Beschreibung

Die Methode file.getText gibt den Inhalt des File als Text zurück.

Die im Objekt file angegebene Datei muss auf der Festplatte existieren, sonst wird ein Fehler generiert.

In charSet übergeben Sie den Zeichensatz zum Lesen 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.

Enthält das Dokument ein Byte Order Mark (BOM), verwendet 4D den eigenen Zeichensatz anstelle des in charSet angegebenen Zeichensatzes (dieser Parameter wird dann ignoriert).

Enthält das Dokument kein BOM und ohne den Parameter charSet, verwendet 4D standardmäßig die “UTF-8” Zeichensätze.

In breakMode können Sie eine Lange Ganzzahl für die Verwaltung von Zeichen für Zeilenende im Dokument ü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.

Zurückgegebener Wert

Text des File.

Beispiel

Vorgegeben ist folgendes Textdokument (Felder sind durch Tabs getrennt):

id name price vat
3 thé 1.06€ 19.6
2 café 1.05€ 19.6

Führen Sie diesen Code aus:

 $myFile:=Folder(fk documents folder).file("Billing.txt") //standardmäßig UTF-8

 $txt:=$myFile.getText()

... erhalten Sie:

  // $Text = "id name price vat\r\n3 thé 1.06€\t19.6\r\n2\tcafé\t1.05€\t19.6"

  // \t = tab

  // \r = CR

Siehe auch

file.setText