Hilfe

ReadBytes

B2D B+ B3D

Aufruf

byte = ReadBytes (bank, stream, start, anzahl)

Parameter

bank Identität der Bank, ermittelt mit CreateBank
stream Identität der Datei oder des TCP Streams, ermittel mit OpenFile, ReadFile bzw. OpenTCPStream
start Startposition in Byte (ab 0)
anzahl Anzahl der Bytes (ab 1)


Rückgabewert

Die Funktion liefert die Anzahl der erfolgreich eingelesenen Bytes zurück.
Zusätzlich wird die Speicherbank mit den gelesenen Werten gefüllt.


Beschreibung

Dieser Befehl liest Daten aus einer Datei in ein Speicherfeld ein. Die Datei muss vorher mit OpenFile/ReadFile geöffnet, bzw. der Stream mit OpenTCPStream erstellt worden sein. Zudem muss auch ein Speicherfeld mit CreateBank definiert werden. "Start" gibt die Startposition in Byte an. Es können beliebig viele Bytes eingelesen werden.

Diese Methode wird z.B. für das Einlesen von Levels benutzt. Mit WriteBytes können die Daten abgespeichert werden. Benutze Peek/Poke-Befehle, um Daten zu lesen/speichern.

Die Datei muss bereits existieren, da sonst eine Fehlermeldung nach einem Lesevorgang erscheint. Benutze vorher den Befehl FileType.


Beispiel

Dieses Beispiel demonstriert die BANK-Möglichkeiten:

bnkTest = CreateBank(100)

PokeByte bnkTest,1,255
PokeInt bnkTest,2,12345678
PokeShort bnkTest,6,12345
PokeFloat bnkTest,8,12345.6789

file = WriteFile("test.txt")
WriteBytes bnkTest, file, 0, 100
CloseFile file

FreeBank bnkTest

bnkTest = CreateBank(100)

file = ReadFile("test.txt")
ReadBytes bnkTest, file, 0, 100
CloseFile file

Print PeekByte (bnkTest,1)
Print PeekInt (bnkTest,2)
Print PeekShort (bnkTest,6)
Print PeekFloat (bnkTest,8)

FreeBank bnkTest

WaitKey


Siehe auch

CreateBank, Eof, FreeBank, PeekByte, PeekFloat, PeekInt, PeekShort, PokeByte, PokeFloat, PokeInt, PokeShort, ReadAvail, ReadByte, ReadFloat, ReadInt, ReadLine, ReadShort, WriteBytes

Übersicht Datenverwaltung Speicherbänke