buffer
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Un tamper es un objeto que representa un bloque de memoria de tamaño fijo y mutable. La biblioteca de tamper proporciona funciones para la creación y manipulación de objetos de tamper, proporcionando todas sus funciones dentro de la variable global buffer .
El tamano es una estructura de almacenamiento de datos binarios de nivel bajo que reemplaza el uso de string.pack() y string.unpack() . Los casos de uso incluyen la lectura y escritura de formatos binarios existentes, trabajar con datos en una forma más compacta, serializar a formatos binarios personalizados y general trabajar con tipos de memoria nativos como números de longitud fijos y flotas.
Cuando se pasa a través de las API de Roblox, incluida la enviar de un buffer a través de eventos personalizados, el ID del objeto de buffer no se mantiene y el objetivo recibirá una copia. Como con otras limitaciones, el mismo objeto de buffer no se puede usar desde múltiples scripts Actor (Parallel Luau).
Muchas de las funciones aceptan un desplazamiento en bytes desde el comienzo del tamano de memoria. El desplazamiento de 0 desde el comienzo del tamano de memoria accede al primer bytes. Todos los desplazamientos, contados y tamaños deben ser números enteros positivos. Si los bytes que son accedidos por cualquier operación de lectura o escritura están fuera del tamano de memoria, se produce un error.
Los métodos read y write que trabajan con números enteros y flotantes usan la codificación little-endian.
Resumen
Funciones
Crea un tamano de memoria.
Crea un tamano desde una cadena.
Convierte un tamano a una cadena.
Devuelve el tamaño del tamano en bytes.
Lee un valor de números firmados de 8 bits del tamano de memoria.
Lee un número entero de 8 bits del tamano de memoria.
Lee un valor de números firmados de 16 bits del tamano de memoria.
Lee un número entero de 16 bits del tamano de memoria.
Lee un valor de números firmados de 32 bits del tamano de memoria.
Lee un número entero de 32 bits del tamano de memoria.
Lee un valor de punto flotante de 32 bits del tamano de memoria.
Lee un valor de punto flotante de 64 bits del tamano de memoria.
Escribe un número entero firmado de 8 bits en el tamano.
Escribe un número entero de 8 bits sin signar en el tamano.
Escribe un número entero firmado de 16 bits en el tamano.
Escribe un número entero de 16 bits a la memoria.
Escribe un número entero firmado de 32 bits en el tamano.
Escribe un número entero de 32 bits sin signar al tamano de memoria.
Escribe un valor de punto flotante de 32 bits en el tamano.
Escribe un valor de punto flotante de 64 bits en el tamano.
Lee una cadena del tamano de memoria.
Escribe una cadena en el tamano.
Copia bytes entre los buffers.
Establece una región de la memoria del tamano de página a un valor de signo de 8 bits.
Funciones
readf32
Lee los datos del tamano al reinterpretar los bytes en el desplazamiento como un valor de punto flotante de 32 bits y convertirlos en un número. Si el valor de punto flotante coincide con cualquier patrón de bit que representa NaN (no un número), el valor devuelto puede ser convertido en una representación de punto de datos diferente.
Parámetros
Devuelve
readf64
Lee los datos del tamano al reinterpretar los bytes en el desplazamiento como un valor de punto flotante de 64 bits y convertirlos en un número. Si el valor de punto flotante coincide con cualquier patrón de bit que representa NaN (no un número), el valor devuelto puede ser convertido en una representación de punto de NaN diferente.
Parámetros
Devuelve
writei16
Escribe datos en el tamano al convertir el número en un número entero de 16 bits y reinterpretarlo como unidades individuales.
Parámetros
Devuelve
writeu16
Escribe datos en el tamano al convertir el número en un número entero de 16 bits y reinterpretarlo como unidades individuales.
Parámetros
Devuelve
writei32
Escribe datos en el tamano al convertir el número en un número entero de 32 bits y reinterpretarlo como unidades individuales.
Parámetros
Devuelve
writeu32
Escribe datos en el tamano al convertir el número en un número entero de 32 bits y reinterpretarlo como unidades individuales.
Parámetros
Devuelve
writef32
Escribe datos en el tamano al convertir el número en un valor de punto flotante de 32 bits y reinterpretarlo como unidades individuales.
Parámetros
Devuelve
writef64
Escribe datos en el tamano al convertir el número en un valor de punto flotante de 64 bits y reinterpretarlo como unidades individuales.
Parámetros
Devuelve
writestring
Escribe datos de una cadena en el tamano de memoria especificado offset . Si se especifica un tamano de memoria opcional count, solo se toman count bytes de la cadena.
Parámetros
Devuelve
copy
Copia count bytes desde source comenzando desde el desplazamiento sourceOffset hasta el desplazamiento 1> target1> en el desplazamiento 4> targetOffset4> .
Es posible que source y target sean idénticas. Copiar una región conectada dentro del mismo buffer actúa como si la región de origen se copiara en un buffer temporal y luego ese buffer se copia sobre el objetivo.
Parámetros
Búfer para copiar datos.
Desplazarse desde el comienzo de la memoria del tamano, empezando por 0.
Puffer para tomar los datos.
Desplazarse desde el comienzo de la memoria del tamano, empezando por 0.
Número de bytes para copiar. Si se omite, toda la información de source comienza con sourceOffset .
Devuelve
fill
Establece count bytes en el tamano de inicio del buffer comenzando en el offset especificado para value .
Parámetros
Búfer para escribir los datos.
Desplazarse desde el comienzo de la memoria del tamano, empezando por 0.
Un número entero en el rango [0, 255].
Número de bytes para escribir. Si se omitió, todos los bytes después del desplazamiento especificado se establecer.