Difference between revisions of "Lua:wordToByteTable"

From Cheat Engine
Jump to navigation Jump to search
m
Line 1: Line 1:
 
[[Category:Lua]]
 
[[Category:Lua]]
'''function''' wordToByteTable(''Number'') ''':''' table
+
'''function''' wordToByteTable(''Number'') ''':''' Table
 
 
Converts a WORD (2 bytes) to a byte table, interpreting it as an integer.
 
 
 
 
 
Note: If the number is a float only the integer no greater than or no less than the given value will be used.
 
 
 
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 WORD (2 bytes) only the lower portion of the number will be used.
 
 
 
  i.e.: 0xFFFF00 : 0xFF00
 
          2 1 0      1 0
 
  
 +
Converts a 16-bit word (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 25: Line 11:
 
|-
 
|-
 
|Number
 
|Number
|number
+
|Integer
|The number to convert to a byte table
+
|The 16-bit word to convert.
 
|}
 
|}
  
 +
===Returns===
 +
Table — A table containing the bytes representing the word.
  
== Examples ==
+
===Examples===
 
+
<pre>
Code:
+
local bytes = wordToByteTable(0x1234)
  local bt = wordToByteTable(0xFFFF)
+
for i, b in ipairs(bytes) do
                            --1 0
+
  print(string.format("Byte %d: %02X", i, b))
  writeBytes('00123ABC', bt)
+
end
 
+
-- Output: Byte 1: 34, Byte 2: 12 (little-endian order)
 
+
</pre>
Code:
 
  local bt = wordToByteTable(10)
 
  for i, v in ipairs(bt) do
 
    print(i - 1, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  0 0A
 
  1 00
 
 
 
 
 
Code:
 
  local bt = wordToByteTable(10.9)
 
  for i, v in ipairs(bt) do
 
    print(i - 1, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  0 0A
 
  1 00
 
 
 
 
 
Code:
 
  local bt = wordToByteTable(0xFFFF00)
 
                            --2 1 0
 
  for i, v in ipairs(bt) do
 
    print(i - 1, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  0 00
 
  1 FF
 
 
 
  
 
{{LuaSeeAlso}}
 
{{LuaSeeAlso}}

Revision as of 17:23, 11 July 2025

function wordToByteTable(Number) : Table

Converts a 16-bit word (integer) to a table of bytes.

Function Parameters

Parameter Type Description
Number Integer The 16-bit word to convert.

Returns

Table — A table containing the bytes representing the word.

Examples

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

See also

Related Functions