Difference between revisions of "Lua:dwordToByteTable"

From Cheat Engine
Jump to navigation Jump to search
(Created page with ''''function''' dwordToByteTable(''Number'') Converts a DWORD (4 bytes) to a byte table. === Function Parameters === {|width="85%" cellpadding="10%" cellpadding="5%" cellspacing…')
 
m
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
'''function''' dwordToByteTable(''Number'')
+
[[Category:Lua]]
 +
'''function''' dwordToByteTable(''Number'') ''':''' Table
  
Converts a DWORD (4 bytes) to a byte table.
+
Converts a 32-bit dword (integer) to a table of bytes.
  
=== Function Parameters ===
+
===Function Parameters===
{|width="85%" cellpadding="10%" cellpadding="5%" cellspacing="0" border="0"
+
{|width="85%" cellpadding="10%" cellspacing="0" border="0"
 
!align="left"|Parameter
 
!align="left"|Parameter
 
!align="left"|Type
 
!align="left"|Type
Line 10: 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.
  
Note: If the number is a float only the integer no greater than or no less than the given value will be used.
+
===Explanation===
  
Same as value from 'math.floor'.
+
The "ToByteTable" functions convert a value (such as an integer or floating-point number) into a table of bytes that represent how the value is stored in memory.
  
i.e.: 8.1 : 8, 8.9 : 8, -8.1 : -8, -8.9 : -8
+
For example, if you use <code>wordToByteTable(1337)</code>:
  
 +
- The decimal number <code>1337</code> is <code>0x0539</code> in hexadecimal.
 +
- Computers typically use little-endian order, meaning the least significant byte comes first.
 +
- So, <code>0x0539</code> is split into two bytes: <code>0x39</code> (57 in decimal) and <code>0x05</code> (5 in decimal).
 +
- The resulting byte table is <code>{0x39, 0x05}</code> or <code>{57, 5}</code>.
  
Note: If the number is larger than a DWORD (4 bytes) only the lower portion of the number will be used.
+
This means:
 +
- <code>bytes[1] = 0x39</code> (the low byte)
 +
- <code>bytes[2] = 0x05</code> (the high byte)
  
i.e.: 0xFFFFFFFF00 : 0xFFFFFF00
+
This process applies to all "ToByteTable" functions: 
 +
They break down the value into its raw bytes, ordered from least significant to most significant (little-endian).
  
 +
===Examples===
 +
<pre>
 +
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)
 +
</pre>
  
== Examples ==
+
{{LuaSeeAlso}}
 
 
Code:
 
  local bt = dwordToByteTable(0xFFFFFFFF)
 
  writeBytes('00123ABC', bt)
 
 
 
 
 
Code:
 
  local bt = dwordToByteTable(10)
 
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  1 0A
 
  2 00
 
  3 00
 
  4 00
 
 
 
 
 
Code:
 
  local bt = dwordToByteTable(10.9)
 
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  1 0A
 
  2 00
 
  3 00
 
  4 00
 
 
 
 
 
Code:
 
  local bt = dwordToByteTable(0xFFFFFFFF00)
 
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  1 00
 
  2 FF
 
  3 FF
 
  4 FF
 
 
 
 
 
== See also ==
 
* [[Lua]]
 
* [[Help_File:Script engine|Script engine]]
 
  
 
=== Related Functions ===
 
=== Related Functions ===
* [[readBytes]]
+
{{ReadWriteMemory}}
* [[readInteger]]
 
* [[readQword]]
 
* [[readPointer]]
 
* [[readFloat]]
 
* [[readDouble]]
 
* [[readString]]
 
* [[writeBytes]]
 
* [[writeInteger]]
 
* [[writeQword]]
 
* [[writeFloat]]
 
* [[writeDouble]]
 
* [[writeString]]
 
* [[readBytesLocal]]
 
* [[readIntegerLocal]]
 
* [[readQwordLocal]]
 
* [[readPointerLocal]]
 
* [[readFloatLocal]]
 
* [[readDoubleLocal]]
 
* [[readStringLocal]]
 
* [[writeBytesLocal]]
 
* [[writeIntegerLocal]]
 
* [[writeQwordLocal]]
 
* [[writeFloatLocal]]
 
* [[writeDoubleLocal]]
 
* [[writeStringLocal]]
 
* [[wordToByteTable]]
 
* [[qwordToByteTable]]
 
* [[floatToByteTable]]
 
* [[doubleToByteTable]]
 
* [[stringToByteTable]]
 
* [[wideStringToByteTable]]
 
* [[byteTableToWord]]
 
* [[byteTableToDword]]
 
* [[byteTableToQword]]
 
* [[byteTableToFloat]]
 
* [[byteTableToDouble]]
 
* [[byteTableToString]]
 
* [[byteTableToWideString]]
 

Revision as of 17:34, 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.

Explanation

The "ToByteTable" functions convert a value (such as an integer or floating-point number) into a table of bytes that represent how the value is stored in memory.

For example, if you use wordToByteTable(1337):

- The decimal number 1337 is 0x0539 in hexadecimal. - Computers typically use little-endian order, meaning the least significant byte comes first. - So, 0x0539 is split into two bytes: 0x39 (57 in decimal) and 0x05 (5 in decimal). - The resulting byte table is {0x39, 0x05} or {57, 5}.

This means: - bytes[1] = 0x39 (the low byte) - bytes[2] = 0x05 (the high byte)

This process applies to all "ToByteTable" functions: They break down the value into its raw bytes, ordered from least significant to most significant (little-endian).

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

Lua
Script Engine

Related Functions

Read Functions
readBytes
readSmallInteger
readInteger
readQword
readPointer
readFloat
readDouble
readString
Read Functions (Local Process)
readBytesLocal
readIntegerLocal
readQwordLocal
readPointerLocal
readFloatLocal
readDoubleLocal
readStringLocal
Write Functions
writeBytes
writeSmallInteger
writeInteger
writeQword
writeFloat
writeDouble
writeString
Write Functions (Local Process)
writeBytesLocal
writeIntegerLocal
writeQwordLocal
writeFloatLocal
writeDoubleLocal
writeStringLocal
Byte Table Conversions (Value → Byte Table)
wordToByteTable
dwordToByteTable
qwordToByteTable
floatToByteTable
doubleToByteTable
stringToByteTable
wideStringToByteTable
Byte Table Conversions (Byte Table → Value)
byteTableToWord
byteTableToDword
byteTableToQword
byteTableToFloat
byteTableToDouble
byteTableToString
byteTableToWideString