buffer

Ein Buffer ist ein Objekt, das eine feste Größe mutable Block of Memory repräsentiert. Die Buffer-Bibliothek bietet Funktionen für die Erstellung und Manipulation von Buffer-Objekten, wobei alle seine Funktionen innerhalb der globalen buffer Variable.

Buffer ist eine Low-Level-binäre Datenstruktur, die die Verwendung von string.pack() und string.unpack() ersetzt. Anwendungsfälle umfassen das Lesen und Schreiben von bestehenden Binärdaten, das Arbeiten mit Daten in kompakterer Form, die SerIALisierung auf benutzerdefinierte Binärformate und die allgemeine Arbeit mit nativen Memoiren wie fixen Längen und Sch floats.

Wenn durch Roblox-APIs geschickt wird, einschließlich das Senden eines Buffers über benutzerdefinierte Ereignisse, die Identität des Buffer-Objekts wird nicht erhalten und das Ziel eine Kopie erhalten wird. Ähnlich wie andere Einschränkungen, kann das gleiche Buffer-Objekt nicht von mehreren Class.Actor -Skripts (Parallel Luau) verwendet werden.

Viele der Funktionen akzeptieren einen Offset in Bytes von Beginn der Buffer. Offset von 0 von Beginn des Buffer-Speicher-Blocks greift auf den ersten Byte zu. Alle Offsets, Zähler und Größen sollten nicht negative Zahlwerte sein. Wenn die Bytes, die von einer Lesen oder Schreiben Operation auf dem Buffer außerhalb des Buffers sind, sind, wird ein Fehler geworfen.

Die Methoden read und write, die mit Zahlen und Floating arbeiten, verwenden little-endian Encoding.