binary.lua

local bit32 = require("bit32")

local binary = {}

---Converts an integer into a little endian byte array or a given size, defaults to 4 bytes if ommited
---@param int number
---@param optional length number
---@return table
function binary.int2bytes(int, length)
 length = length or 4
 local result = {}
 for i = 1, length do
 result[i] = bit32.band(bit32.rshift(int, ((i-1) * 8)), 0xFF)
 end
 return result
end

---Converts a little endian byte array into a binary string
---@param bytes table
---@return string
function binary.bytes2string(bytes)
 return string.char(table.unpack(bytes))
end

---Converts an integer into a little endian binary string of a given size, defaults to 4 bytes if ommited
---@param int number
---@param optional length number
---@return string
function binary.int2binString(int, length)
 return binary.bytes2string(binary.int2bytes(int, length))
end

---Converts a binary string into a byte array
---@param str string
---@return table
function binary.binString2bytes(str)
 local result = {}
 for i = 1, string.len(str) do
 result[i] = string.byte(str, i)
 end
 return result
end

---Converts a byte array of a little endian integer into an integer
---@param bytes table
---@return number
function binary.bytes2int(bytes)
 local result = 0
 for i, v in ipairs(bytes) do
 result = result + bit32.lshift(v, (i-1) * 8)
 end
 return result
end

---Converts a binary string of a little endian integer into a integer
---@param bytes table
---@return number
function binary.string2int(str)
 return binary.bytes2int(binary.string2bytes(str))
end

---Converts a binary string of a little endian integer into a integer
---@param bytes table
---@return number
function binary.binString2int(str)
 return binary.bytes2int(binary.string2bytes(str))
end

local function debug()
 local serial = require("serialization")
 print(serial.serialize(binary.int2bytes(384)))
 local test = binary.int2binString(384)
 print(test)
 test = binary.binString2bytes(test)
 print(serial.serialize(test))
 print(binary.bytes2int(test))
 end

return binary