WriteData()

Syntax

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

Schreibt den Inhalt des angegebenen Speicherpuffers in eine Datei.

Parameter

#Datei	Die Datei, in welche geschrieben werden soll.
*Speicherpuffer	Die Speicheradresse der Daten, welche in die Datei geschrieben werden sollen.
Länge	Die Anzahl an Bytes, 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, GetHomeDirectory()+"Text.txt")   ; wir erstellen eine neue Text-Datei...
    WriteData(0, *MemoryID, SizeOf(Character)*Len("Speichere diesen String im Speicherblock"))   ; schreibe den Text aus dem Speicherblock in die Datei
    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