buffer

Um buffer é um objeto que representa um bloco de memória de tamanho fixo e manipulável. A biblioteca de buffer fornece funções para a criação e manipulação de objetos de buffer, fornecendo todas as suas funções dentro da variável global buffer.

O buffer foi projetado para ser usado como uma estrutura de armazenamento de dados binários de baixo nível, substituindo os usos de string.pack() e string.unpack(). Os casos de uso incluem a leitura e a gravação de formatos binários existentes, trabalhando com dados em uma forma mais compacta, serialização para formatos binários personalizados e geralmente trabalhando com tipos de memória nativos

Quando passado através das APIs do Roblox, incluindo enviar um buffer através de eventos personalizados, a identificação do objeto de buffer não é preservada e o alvo receberá uma cópia. Semelhante a outras limitações, o mesmo objeto de buffer não pode ser usado de vários Actor scripts (Parallel Luau).

Muitas das funções aceitam um deslocamento em bytes a partir do início do buffer. O deslocamento de 0 a partir do início do bloco de memória acessa o primeiro bytes. Todos os deslocamentos, contagens e tamanhos devem ser números inteiros negativos. Se os bytes que são acessados por qualquer operação de leitura ou gravação estiverem fora da memória do buffer, um erro é exibido.

Os métodos read e write que trabalham com inteiros e flutuais usam pequeno-endian codificação.