4D Doc Center : Document to text

Home

4D v14.3

Document to text


Document to text ( DateiName {; Zeichensatz {; UmbruchModus}} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
DateiName	String	Dokumentname oder Pfadname zum Dokument
Zeichensatz	Text, Lange Ganzzahl	Name oder Nummer des Zeichensatzes
UmbruchModus	Lange Ganzzahl	Bearbeitungsmodus für Zeilenumbrüche
Funktionsergebnis	Text	Text aus dem Dokument

Beschreibung

Mit der Funktion Document to text können Sie den Inhalt einer Datei direkt auf der Festplatte in einer 4D Textvariablen oder einem Textfeld wiederfinden.

In DateiName übergeben Sie Name oder Pfadname der Datei zum Lesen. Die Datei muss auf der Festplatte vorhanden sein, sonst wird ein Fehler erzeugt. Sie können folgendes übergeben:

Nur den Dateinamen, z.B. "meineDatei.txt": In diesem Fall muss die Datei neben der Strukturdatei der Anwendung liegen.
Einen Pfadnamen in Bezug auf die Strukturdatei der Anwendung, z.B. "\\docs\\meineDatei.txt" unter Windows oder ":docs:meineDatei.txt" auf OS X.
Einen absoluten Pfadnamen, z.B. "c:\\app\\docs\\meineDatei.txt" unter Windows oder "MacHD:docs:meineDatei.txt" auf OS X.

In Zeichensatz übergeben Sie den Zeichensatz zum Lesen des Inhalts. Sie können einen String mit dem standardmäßigen Namen übergeben, z.B. “ISO-8859-1” oder “UTF-8” oder seine MIBEnum ID (Lange Ganzzahl). Weitere Informationen zur Liste der Zeichensätze, die 4D unterstützt, finden Sie in der Beschreibung zum Befehl CONVERT FROM TEXT.

Bei Dokumenten mit Byte Order Mark (BOM) verwendet 4D den hier gesetzten Zeichensatz anstelle der Vorgabe in Zeichensatz (dieser Parameter wird dann ignoriert).

Bei Dokumenten ohne BOM und ohne Angabe des Parameters Zeichensatz verwendet 4D standardmäßig folgende Zeichensätze:

unter Windows: ANSI
auf OS X: MacRoman

In UmbruchModus können Sie eine Lange Ganzzahl übergeben, um die Handhabung der Zeichen für Zeilenende im Dokument anzugeben. Sie können eine der nachfolgenden Konstanten unter dem Thema Systemdokumente übergeben:

Konstante	Typ	Wert	Meldung
Document unchanged	Lange Ganzzahl	0	Keine Bearbeitung
Document with CR	Lange Ganzzahl	3	Zeilenumbrüche werden in das Mac OS Format konvertiert: CR (carriage return)
Document with CRLF	Lange Ganzzahl	2	Zeilenumbrüche werden in das Windows Format konvertiert: CRLF (carriage return + line feed)
Document with LF	Lange Ganzzahl	4	Zeilenumbrüche werden in das Unix Format konvertiert: LF (line feed)
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)

Lassen Sie den Parameter UmbruchModus weg, werden Zeilenumbrüche im native Modus (1) gehandhabt.

Hinweis: Diese Funktion verändert nicht die Variable OK. Schlägt die Operation fehl, wird ein Fehler generiert, den Sie mit einer Methode abfangen können, die der Befehl ON ERR CALL installiert.

Beispiel

Nehmen wir folgendes Textdokument (Felder sind durch Tabs getrennt):

id    name    price    vat
3    4D Tags    99    19.6

Führen Sie diesen Code aus:

$Text:=Document to text("products.txt")

... erhalten Sie:

  // $Text = "id\tname\tprice\tvat\r\n3\t4D Tags\t99 \t19.6"

  // \t = tab

  // \r = CR