prevnext   » Startseite » Haupt-Referenz » Funktions-Referenz » saveFile()

saveFile()

Eine Zeichenkette oder alle Zeichenketten einer Liste in eine Datei speichern.

Syntax:

int/list saveFile ( filename, data )
int/list saveFile ( filename, data, bool:compare_before_save )
int/list saveFile ( filename, data, bool:compare_before_save, open_mode )

Parameter:

filename Eine Zeichenkette, die den Dateinamen enthält.
data Die Daten, die mit der Datei verglichen bzw. die gesichert werden sollen. Die Daten liegen entweder als Zeichenkette oder als Liste vor. Eine Zeichenkette wird mit einer Schreiboperation geschrieben.

Im Falle einer Liste werden nur Elemente (nicht-rekursiv) berücksichtigt, die eine Zeichenkette enthalten. Jede dieser Zeichenketten wird virtuell mit ein LF ergänzt. Alle Zeichenketten zusammen ergeben dann die virtuelle Gesamtzeichenkette.

compare_before_save Falls true: Datei nur schreiben, falls sie nicht existiert oder einen anderen Inhalt hat.
open_mode Modus, mit dem die Datei beim Schreiben geöffnet wird. Detail sind unter OpenFile() beschrieben. Die Voreinstellung ist 'wb'.

Beschreibung:

Der Inhalt von data wird in die Datei filename geschrieben. Falls compare_before_save==true, dann wird die Datei nur neu geschrieben, wenn der Inhalt der Datei von data abweicht.

Funktionsergebnis:   LIST/INT32

Ist ein Parameter falsch oder konnte auf die Datei filename nicht zugegriffen werden, dann wird eine Liste mit 2 Elementen geliefert. Das Element mit Index 0 enthält einen Fehlerkode, der z.B. in message() verwendet werden kann, und das Element mit Index 1 eine Zeichenkette mit ausführlicher Fehlermeldung.

Anderenfalls wird eine 32-Bit-Ganzzahl als Funktionsergebnis geliefert. Diese Zahl gibt die Anzahl der geschriebenen Zeichen wieder. Falls die Datei verglichen und eine Identität festgestellt wurde, dann wird der Wert 0 als Funktionsergebnis geliefert.

Siehe auch:
 compareFile()   loadFile()   openFile() 

Weitere ähnliche Funktionen:

Dateien
Funktion Kurzinfo
compareFile() Eine Datei mit lokalen Daten vergleichen.
compareFiles() Den Inhalt zweier Dateien vergleichen.
compareFilesEx() Einen Ausschnitt des Inhaltes zweier Dateien vergleichen.
copyFile()
copyFiles()
createDir()
deleteDir() Ein Verzeichnis löschen
deleteFile() Eine Datei löschen
deleteFiles() Dateien und Verzeichnisse löschen.
exifInfo()
fileAccessMode()
fileAttrib()
fileInfo()
fileSize() Die Größe eienr Datei bestimmen.
fileTime()
fileType()
findFile()
findFiles()
id3v2info()
inclAccessMode()
linkFile()
linkFiles()
loadFile() Den Inhalt einer Datei laden.
moveFile()
moveFiles()
saveFile() Eine Zeichenkette oder alle Zeichenketten einer Liste in eine Datei speichern.