4D v14.3

Document to text

Home

 
4D v14.3
Document to text

Document to text 


 

Document to text ( DateiName {; Zeichensatz {; UmbruchModus}} ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
DateiName  String in Dokumentname oder Pfadname zum Dokument
Zeichensatz  Text, Lange Ganzzahl in Name oder Nummer des Zeichensatzes
UmbruchModus  Lange Ganzzahl in Bearbeitungsmodus für Zeilenumbrüche
Funktionsergebnis  Text in Text aus dem Dokument

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.

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

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Systemdokumente
Nummer: 1236

 
GESCHICHTE 

New
Erstellt: 4D v14

 
SIEHE AUCH 

Systemdokumente
TEXT TO DOCUMENT

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v14 R3)
4D Programmiersprache ( 4D v14 R2)
4D Programmiersprache ( 4D v14.3)
4D Programmiersprache ( 4D v14 R4)