Difference between revisions of "Lua:dwordToByteTable"

From Cheat Engine
Jump to navigation Jump to search
m
Line 1: Line 1:
 
[[Category:Lua]]
 
[[Category:Lua]]
'''function''' dwordToByteTable(''Number'') ''':''' table
+
'''function''' dwordToByteTable(''Number'') ''':''' Table
  
Converts a DWORD (4 bytes) to a byte table, interpreting it as an integer.
+
Converts a 32-bit dword (integer) to a table of bytes.
  
 
+
===Function Parameters===
Note: If the number is a float only the integer no greater than or no less than the given value will be used.
+
{|width="85%" cellpadding="10%" cellspacing="0" border="0"
 
 
Same as value from 'math.floor'.
 
 
 
  i.e.: 8.1 : 8, 8.9 : 8, -8.1 : -8, -8.9 : -8
 
 
 
 
 
Note: If the number is larger than a DWORD (4 bytes) only the lower portion of the number will be used.
 
 
 
  i.e.: 0xFFFFFFFF00 : 0xFFFFFF00
 
          4 3 2 1 0      3 2 1 0
 
 
 
=== Function Parameters ===
 
{|width="85%" cellpadding="10%" cellpadding="5%" cellspacing="0" border="0"
 
 
!align="left"|Parameter
 
!align="left"|Parameter
 
!align="left"|Type
 
!align="left"|Type
Line 24: Line 11:
 
|-
 
|-
 
|Number
 
|Number
|number
+
|Integer
|The number to convert to a byte table
+
|The 32-bit dword to convert.
 
|}
 
|}
  
 +
===Returns===
 +
Table — A table containing the bytes representing the dword.
  
== Examples ==
+
===Examples===
  local bt = dwordToByteTable(0xFFFFFFFF)
+
<pre>
                              --3 2 1 0
+
local bytes = dwordToByteTable(0x12345678)
  writeBytes('00123ABC', bt)
+
for i, b in ipairs(bytes) do
 
+
  print(string.format("Byte %d: %02X", i, b))
 
+
end
Code:
+
-- Output: Byte 1: 78, Byte 2: 56, Byte 3: 34, Byte 4: 12 (little-endian order)
  local bt = dwordToByteTable(10)
+
</pre>
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  0 0A
 
  1 00
 
  2 00
 
  3 00
 
 
 
 
 
Code:
 
  local bt = dwordToByteTable(10.9)
 
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  0 0A
 
  1 00
 
  2 00
 
  3 00
 
 
 
 
 
Code:
 
  local bt = dwordToByteTable(0xFFFFFFFF00)
 
                              --4 3 2 1 0
 
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  0 00
 
  1 FF
 
  2 FF
 
  3 FF
 
 
 
  
 
{{LuaSeeAlso}}
 
{{LuaSeeAlso}}

Revision as of 17:24, 11 July 2025

function dwordToByteTable(Number) : Table

Converts a 32-bit dword (integer) to a table of bytes.

Function Parameters

Parameter Type Description
Number Integer The 32-bit dword to convert.

Returns

Table — A table containing the bytes representing the dword.

Examples

local bytes = dwordToByteTable(0x12345678)
for i, b in ipairs(bytes) do
  print(string.format("Byte %d: %02X", i, b))
end
-- Output: Byte 1: 78, Byte 2: 56, Byte 3: 34, Byte 4: 12 (little-endian order)

See also

Related Functions