Difference between revisions of "Lua:wordToByteTable"

From Cheat Engine
Jump to navigation Jump to search
m (Added CodeBox Template.)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
'''function''' wordToByteTable(''Number'')
+
[[Category:Lua]]
 +
{{CodeBox|'''function''' wordToByteTable(''Number'') ''':''' Table}}
  
Converts a WORD (2 bytes) to a byte table.
+
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 10: 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.
  
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 WORD (2 bytes) only the lower porsion 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.: 0xFFFF00 : 0xFF00
+
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 = 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)
 +
</pre>
  
== Examples ==
+
{{LuaSeeAlso}}
 
 
Code:
 
  local bt = wordToByteTable(0xFFFF)
 
  writeBytes('00123ABC', bt)
 
 
 
 
 
Code:
 
  local bt = wordToByteTable(8)
 
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  1 08
 
  2 00
 
 
 
 
 
Code:
 
  local bt = wordToByteTable(8.9)
 
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  1 08
 
  2 00
 
 
 
 
 
Code:
 
  local bt = wordToByteTable(0xFFFF00)
 
  for i, v in ipairs(bt) do
 
    print(i, string.format('%02X', v))
 
  end
 
 
 
Output:
 
  1 00
 
  2 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]]
 
* [[dwordToByteTable]]
 
* [[qwordToByteTable]]
 
* [[floatToByteTable]]
 
* [[doubleToByteTable]]
 
* [[stringToByteTable]]
 
* [[wideStringToByteTable]]
 
* [[byteTableToWord]]
 
* [[byteTableToDword]]
 
* [[byteTableToQword]]
 
* [[byteTableToFloat]]
 
* [[byteTableToDouble]]
 
* [[byteTableToString]]
 
* [[byteTableToWideString]]
 

Latest revision as of 23:09, 4 December 2025

<> Function

function wordToByteTable(Number) : Table

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

Function Parameters[edit]

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

Returns[edit]

Table — A table containing the bytes representing the word.

Explanation[edit]

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[edit]

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[edit]

Lua
Script Engine

Related Functions[edit]

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