fwrite_bytesT_fwrite_bytesFwriteBytesFwriteBytes (Operator)

Name

fwrite_bytesT_fwrite_bytesFwriteBytesFwriteBytes — Screiben von Bytes in eine Binärdatei.

Signatur

fwrite_bytes( : : FileHandle, DataToWrite : NumberOfBytesWritten)

Beschreibung

fwrite_bytesfwrite_bytesFwriteBytesFwriteBytesFwriteBytes schreibt Bytes in die Ausgabedatei, die durch das Handle FileHandleFileHandleFileHandleFileHandlefileHandle definiert ist und mit dem Operator open_fileopen_fileOpenFileOpenFileOpenFile im Binärformat geöffnet worden sein muss.

Die Daten, die in die Datei geschrieben werden sollen, werden als DataToWriteDataToWriteDataToWriteDataToWritedataToWrite übergeben.

Die Anzahl der Bytes, die in die Datei geschrieben wurden, wird in NumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittennumberOfBytesWritten zurückgegeben.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

FileHandleFileHandleFileHandleFileHandlefileHandle (input_control) file → (handle)

Datei-Handle.

DataToWriteDataToWriteDataToWriteDataToWritedataToWrite (input_control) integer-array → (integer)

Zu schreibende Daten, die in die Datei geschrieben werden sollen.

NumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittennumberOfBytesWritten (output_control) integer → (integer)

Anzahl der Bytes, die in die Ausgabedatei geschrieben wurden.

Beispiel (HDevelop)

* Write a binary file byte by byte. 
open_file (Filename, 'append_binary', FileHandle)
fwrite_bytes(FileHandle, [0x97, 99, 102], BytesWritten)    
close_file (FileHandle)

Ergebnis

fwrite_bytesfwrite_bytesFwriteBytesFwriteBytesFwriteBytes liefert den Wert 2 (H_MSG_TRUE), falls die Ausgabedatei im Binärformat geöffnet ist und geschrieben werden konnte. Andernfalls wird eine Fehlerbehandlung ausgelöst.

Vorgänger

open_fileopen_fileOpenFileOpenFileOpenFile

Nachfolger

close_fileclose_fileCloseFileCloseFileCloseFile

Alternativen

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteString

Siehe auch

open_fileopen_fileOpenFileOpenFileOpenFile, close_fileclose_fileCloseFileCloseFileCloseFile, fread_bytesfread_bytesFreadBytesFreadBytesFreadBytes

Modul

Foundation

Operatoren