4D Doc Center : TEXT TO DOCUMENT

Home

4D v14.3

TEXT TO DOCUMENT


TEXT TO DOCUMENT ( Dateiname ; Text {; Zeichensatz {; Umbruchmodus}} )

Parameter	Typ	Beschreibung
Dateiname	String	Dokumentname oder Pfadname zum Dokument
Text	Text	Text zum Speichern im Dokument
Zeichensatz	Text, Lange Ganzzahl	Name oder Nummer des Zeichensatzes
Umbruchmodus	Lange Ganzzahl	Bearbeitungsmodus für Zeilenumbrüche

Beschreibung

Mit dem Befehl TEXT TO DOCUMENT können Sie den Text direkt in eine Datei auf der Festplatte schreiben.

In Dateiname übergeben Sie Name oder Pfadname der zu schreibenden Datei. Sie wird angelegt, wenn sie noch nicht existiert. Ist sie bereits auf der Festplatte vorhanden, wird der bisherige Inhalt entfernt. Bei noch geöffneter Datei wird der Inhalt gesperrt und ein Fehler generiert. In DateiName können Sie folgendes übergeben:

Nur den Dateinamen, z.B. "meineDatei.txt": In diesem Fall wird die Datei neben der Strukturdatei der Anwendung gesetzt.
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.

Wollen Sie, dass der Benutzer Name oder Speicherort des Dokuments angeben kann, verwenden Sie die Funktionen Open document oder Create document sowie die Systemvariable Document.

Hinweis: Von diesem Befehl erzeugte Dokumente haben standardmäßig keine Endung. Dazu müssen Sie eine Endung in Dateiname übergeben oder den Befehl SET DOCUMENT TYPE verwenden.

In Text übergeben Sie den Text zum Schreiben auf die Festplatte. Das kann eine Konstante ("mein Text") oder ein 4D Textfeld bzw. Variable sein.

In Zeichensatz übergeben Sie den Zeichensatz zum Schreiben des Dokuments. 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 zu den von 4D unterstützten Zeichensätzen finden Sie in der Beschreibung zum Befehl CONVERT FROM TEXT. Gibt es ein Byte Order Mark (BOM)für den Zeichensatz, fügt 4D diesen in das Dokument ein. Geben Sie keinen Zeichensatz an, verwendet 4D standardmäßig den Zeichensatz "UTF_8" und ein BOM.

In Umbruchmodus önnen Sie eine Lange Ganzzahl übergeben, um die Handhabung der Zeichen für Zeilenende vor dem Sichern in eine Datei 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: Dieser Befehl 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 1

Hier sehen Sie typische Beispiele zu diesem Befehl:

 TEXT TO DOCUMENT("myTest.txt";"Dies ist ein Test")

 TEXT TO DOCUMENT("myTest.xml";"Dies ist ein Test")

Beispiel 2

Hier kann der Benutzer den Speicherort für die zu erstellende Datei angeben:

 $MyTextVar:="Dies ist ein Test"

 ON ERR CALL("IO ERROR HANDLER")

 $vhDocRef :=Create document("")

  // Dokument mit der Endung ".txt" speichern

  // In diesem Fall wird an den Namen immer die Endung .txt angefügt; das lässt sich nicht verändern

 If(OK=1) // Wurde das Dokument erfolgreich erstellt

    CLOSE DOCUMENT($vhDocRef) // Dokument schließen

    TEXT TO DOCUMENT(Document;$MyTextVar )

  // Wir schreiben das Dokument

 Else

  // Fehlerverwaltung

 End if