WriteData()

Syntax

Ergebnis = WriteData(#Datei, *Speicherpuffer, Länge)

Schreibt den Inhalt des angegebenen Speicherpuffers in eine Datei.

Parameter

#Datei	Gibt die Datei an, in welche geschrieben werden soll.
*Speicherpuffer	Gibt die Speicheradresse der Daten an, welche in die Datei geschrieben werden sollen.
Länge	Gibt die Anzahl an Bytes an, welche in die Datei geschrieben werden sollen.

Rückgabewert

Gibt die Anzahl an Bytes zurück, welche tatsächlich in die Datei geschrieben wurden. Sofern ein Fehler auftrat, ist der Rückgabewert gleich Null.

Anmerkungen

Wegen des Zwischenspeicherns (Cachen) kann diese Funktion auch dann eine Erfolgsmeldung zurückgeben, wenn auf dem Ausgabegerät nicht genug Platz für die Schreib-Operation übrig ist. Die Datei muss mit Schreib-Unterstützung geöffnet worden sein (d.h. nicht mit ReadFile()).

Beispiel

  *MemoryID = AllocateMemory(1000)       ; reservieren eines Speicherblocks
  If *MemoryID
    PokeS(*MemoryID, "Speichere diesen String im Speicherblock")   ; wir schreiben einen String in den Speicherblock
  EndIf
  If CreateFile(0, "Text.txt")           ; wir erstellen eine neue Text-Datei...
    WriteData(0, *MemoryID, 10)          ; die ersten 10 Zeichen des Speicherblocks in die Datei schreiben
    CloseFile(0)                         ; die zuvor geöffnete Datei schließen und damit die geschriebenen Daten endgültig speichern
  Else
    Debug "Konnte die Datei nicht erstellen!"
  EndIf

Siehe auch

ReadData(), CreateFile(), OpenFile()

Unterstützte OS

Alle