Bezeichnung
Peek -- betrachtet einen Speicherblock (V2.0)
Übersicht
val = Peek(id, offset[, type, len, endian])
Beschreibung
Mit diesem Befehl können Sie den in id angegebenen Speicherblock mit dem in offset angegebenen Versatz betrachten. type gibt den Datentyp an, den Sie betrachten möchten. Das kann #BYTE, #SHORT, #INTEGER, #FLOAT, #DOUBLE oder #STRING sein. #BYTE wird ein Byte aus dem Block lesen, #SHORT liest zwei Bytes, #INTEGER sowie #FLOAT vier Bytes, #DOUBLE acht Bytes und #STRING liest aus dem Speicherblock, bis er auf ein nicht-grafisches oder ein Nullzeichen trifft.

Ab Hollywood 2.5 können Sie das optionalen Argument len angeben. Dieses Argument kann nur beim Typ #STRING verwendet werden. Wenn angegeben, liest Peek() genau len Bytes aus dem angegebenen Speicherblock und gibt es als Zeichenkette zurück. Sie können dies verwenden, um Rohdaten aus Speicherblöcken zu lesen, da Peek() bei nicht-grafischen oder Nullzeichen nicht mehr endet, wenn len angegeben wird. Wenn len 0 ist, was der Standardeinstellung entspricht, liest Peek() Bytes, bis es ein nicht-grafisches oder Nullzeichen findet.

Ab Hollywood 6.0 gibt es einen neuen Parameter endian, mit dem Sie die Byte-Reihenfolge angeben können, die beim Lesen der Daten aus dem Speicherblock verwendet werden soll. Dies kann auf die folgenden Typen festgelegt werden:

#BIGENDIAN:
Big-Endian-Byte-Reihenfolge, MSB zuerst. Dies ist die Standardeinstellung.

#NATIVEENDIAN:
Native-Endian-Byte-Reihenfolge. Wenn Sie diesen Typ verwenden, hängt die Byte-Reihenfolge von der Standard-Byte-Reihenfolge auf dem Hostsystem ab, d.h. Big Endian auf Big-Endian-Systemen, Little Endian auf Little-Endian-Systemen. Seien Sie vorsichtig mit diesem Typ, da er die Portabilität einschränkt.

#LITTLEENDIAN:
Little-Endian-Byte-Reihenfolge, zuerst LSB. (V8.0)

Eingaben
id
ID des zu verwendenden Speicherblocks
offset
Versatz, ab dem gelesen wird (in Bytes)
type
optional: Datentyp, der betrachtet wird (standardmäßig auf #INTEGER)
len
optional: Anzahl der zu lesenden Bytes (funktioniert nur in Verbindung mit dem Typ #STRING) (Voreinstellung 0, wobei gelesen wird bis der Befehl auf ein nicht-grafisches oder Nullzeichen trifft) (V2.5)
endian
optional: Reihenfolge der Bytes (Standardeinstellung ist #BIGENDIAN) (V6.0)
Rückgabewerte
val
Inhalt des Speicherblocks beim angegebenen Versatz; kann ein Wert oder eine Zeichenfolge sein (wenn type auf #STRING gesetzt wurde)

Navigation zeigen