buffer

Un tampon est un objet qui représente un bloc de mémoire de taille fixe modifiable.La bibliothèque tampon fournit des fonctions pour la création et la manipulation d'objets tampon, fournissant toutes ses fonctions à l'intérieur de la variable globale buffer.

Le tampon est destiné à être utilisé comme structure de stockage de données binaires de bas niveau, remplaçant l'utilisation de string.pack() et de string.unpack().Les cas d'utilisation incluent la lecture et l'écriture de formats binaires existants, le travail avec des données sous une forme plus compacte, la sérialisation vers des formats binaires personnalisés, et le travail général avec des types de mémoire natifs comme les entiers de longueur fixe et les flottes.

Lorsqu'il est transmis via les API de Roblox, y compris l'envoi d'un tampon via des événements personnalisés, l'identité de l'objet tampon n'est pas préservée et la cible recevra une copie.Semblable à d'autres limitations, le même objet tampon ne peut pas être utilisé à partir de plusieurs scripts Actor parallèles (Luau parallèle).

De nombreuses fonctions acceptent un décalage en octets dès le début du tampon.L'offset de 0 à partir du début de l'accès à la mémoire tampon permet d'accéder au premier octet.Tous les décalages, les comptages et les tailles devraient être des nombres entiers non négatifs.Si les octets auxquels une opération de lecture ou d'écriture a accès sont en dehors de la mémoire tampon, une erreur est échouée.

Les méthodes read et write qui fonctionnent avec des entiers et des flottants utilisent l'encodage peu endian.