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 |
R2013.1 |
Bei dem Parameter ssEncoding dürfen |
5.0.0 |
Neu. |
Siehe auch
id-847459