fwrite_bytesT_fwrite_bytesFwriteBytesFwriteBytesfwrite_bytes (Operator)

Name

fwrite_bytesT_fwrite_bytesFwriteBytesFwriteBytesfwrite_bytes — Schreiben von Bytes in eine Binärdatei.

Signatur

fwrite_bytes( : : FileHandle, DataToWrite : NumberOfBytesWritten)

Beschreibung

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

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

Die Anzahl der Bytes, die in die Datei geschrieben wurden, wird in NumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittennumberOfBytesWrittennumber_of_bytes_written 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

FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle (input_control) file → (handle)

Datei-Handle.

DataToWriteDataToWriteDataToWriteDataToWritedataToWritedata_to_write (input_control) integer-array → (integer)

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

NumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittenNumberOfBytesWrittennumberOfBytesWrittennumber_of_bytes_written (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_bytesFwriteBytesFwriteBytesFwriteBytesfwrite_bytes 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_fileOpenFileOpenFileOpenFileopen_file

Nachfolger

close_fileclose_fileCloseFileCloseFileCloseFileclose_file

Alternativen

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteStringfwrite_string

Siehe auch

open_fileopen_fileOpenFileOpenFileOpenFileopen_file, close_fileclose_fileCloseFileCloseFileCloseFileclose_file, fread_bytesfread_bytesFreadBytesFreadBytesFreadBytesfread_bytes

Modul

Foundation

Operatoren