fread_bytesT_fread_bytesFreadBytesFreadBytesfread_bytes (Operator)

Name

fread_bytesT_fread_bytesFreadBytesFreadBytesfread_bytes — Einlesen von Bytes aus einer Eingabebinärdatei.

Signatur

fread_bytes( : : FileHandle, NumberOfBytes : ReadData, IsEOF)

Beschreibung

fread_bytesfread_bytesFreadBytesFreadBytesFreadBytesfread_bytes liest Bytes aus der Eingabedatei, die durch das Handle FileHandleFileHandleFileHandleFileHandlefileHandlefile_handle definiert ist und mit open_fileopen_fileOpenFileOpenFileOpenFileopen_file im Binärformat geöffnet worden sein muss.

Die Anzahl der zu lesenden Bytes wird in NumberOfBytesNumberOfBytesNumberOfBytesNumberOfBytesnumberOfBytesnumber_of_bytes übergeben, und muss größer als 0 sein.

Die gelesenen Bytes werden in ReadDataReadDataReadDataReadDatareadDataread_data zurückgegeben. IsEOFIsEOFIsEOFIsEOFisEOFis_eof enthält den Wert 1, wenn das Dateiende erreicht wurde, ansonsten 0.

Wenn die Anzahl der zu lesenden Bytes größer ist als die Anzahl der Bytes in der Eingabebinärdatei, werden die gelesenen Bytes bis zum Dateiende in ReadDataReadDataReadDataReadDatareadDataread_data zurückgegeben und der Parameter IsEOFIsEOFIsEOFIsEOFisEOFis_eof wird auf 1 gesetzt.

Wenn keine Bytes gelesen werden können, weil das Ende der Datei erreicht ist, wird in ReadDataReadDataReadDataReadDatareadDataread_data ein leeres Tupel zurückgegeben und der Parameter IsEOFIsEOFIsEOFIsEOFisEOFis_eof auf 1 gesetzt.

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.

NumberOfBytesNumberOfBytesNumberOfBytesNumberOfBytesnumberOfBytesnumber_of_bytes (input_control) integer → (integer)

Anzahl der zu lesenden Bytes.

ReadDataReadDataReadDataReadDatareadDataread_data (output_control) integer-array → (integer)

Gelesenen Bytes.

IsEOFIsEOFIsEOFIsEOFisEOFis_eof (output_control) integer → (integer)

Ende der Datei beim Lesen erreicht.

Beispiel (HDevelop)

* Read a binary file 5 bytes at a time till EOF is reached.
open_file(Filename,'input_binary',FileHandle)
repeat
  fread_bytes(FileHandle, 5, BytesRead, IsEOF)
until (IsEOF)
close_file (FileHandle)

Ergebnis

fread_bytesfread_bytesFreadBytesFreadBytesFreadBytesfread_bytes liefert den Wert TRUE, falls die Eingabedatei im Binärformat geöffnet ist und gelesen werden konnte. Andernfalls wird eine Fehlerbehandlung ausgelöst.

Vorgänger

open_fileopen_fileOpenFileOpenFileOpenFileopen_file

Nachfolger

close_fileclose_fileCloseFileCloseFileCloseFileclose_file

Alternativen

fread_charfread_charFreadCharFreadCharFreadCharfread_char

Siehe auch

open_fileopen_fileOpenFileOpenFileOpenFileopen_file, close_fileclose_fileCloseFileCloseFileCloseFileclose_file, fwrite_bytesfwrite_bytesFwriteBytesFwriteBytesFwriteBytesfwrite_bytes

Modul

Foundation

Operatoren