text_file_write

text_file_write schreibt einen Text in eine Datei in einem gegebenen Zeichenformat und einer gegebenen Konvention für neue Zeilen.

bool = text_file_write(ssFilename, ssText)
bool = text_file_write(ssFilename, ssText, ssEncoding)
bool = text_file_write(ssFilename, ssText, ssEncoding, ssNewline)

Returnwert

bool ist TRUE (1) wenn die Datei geschrieben werden konnte und sonst FALSE (0).

Parameter

ssFilename

ssFilename ist der komplette Name (mit Pfad) der Textdatei. Falls die Datei bereits existiert, wird sie überschrieben.

ssText

ssText ist der Text.

ssEncoding

ssEncoding ist eine der folgenden Zeichenketten:

Wert

Bedeutung

ansi

ANSI

utf8

UTF-8

utf8bom

UTF-8 mit BOM (Byte Order Mark).

utf16

UTF-16

utf16le

UTF-16 little-endian

utf16lebom

UTF-16 little-endian mit BOM

utf16bom

UTF-16 mit BOM

Bei den Werten wird Groß-/Kleinschreibung nicht unterschieden und Minus-Zeichen werden rausgefiltert, UTF-16-LE ist also auch gültig.

ssNewline

ssNewline ist einer der folgenden Werte:

Wert

Bedeutung

„default“

Default Wert, entspricht „crlf“

„crlf“

\x0d \x0a

„cr“

\x0d

„lf“

\x0a

Beispiel

ssText = "[[This is
a text]]";
text_file_write("c:/test.txt", ssText, "utf8", "default")

History

Version

Beschreibung

R2024.3

Der Defaultwert von ssEncoding ist jetzt in allen Fällen utf8.

R2013.1

Bei dem Parameter ssEncoding dürfen --Zeichen im Wert stehen, z. B. utf-8.

5.0.0

Neu.

id-847459