Difference between revisions of "Lua:stringToByteTable"

From Cheat Engine
Jump to navigation Jump to search
m (Syntax Highlighting.)
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[[Category:Lua]]
 
[[Category:Lua]]
−
'''function''' stringToByteTable(''String'') ''':''' table
+
{{CodeBox|'''function''' stringToByteTable(''String'') ''':''' Table}}
  
−
Converts a string to a byte table.
+
Converts a string to a table of bytes, where each byte represents the ASCII/ANSI value of the corresponding character.
  
−
 
+
===Function Parameters===
−
=== Function Parameters ===
+
{|width="85%" cellpadding="10%" cellspacing="0" border="0"
−
{|width="85%" cellpadding="10%" cellpadding="5%" cellspacing="0" border="0"
 
 
!align="left"|Parameter
 
!align="left"|Parameter
 
!align="left"|Type
 
!align="left"|Type
Line 12: Line 11:
 
|-
 
|-
 
|String
 
|String
−
|string
+
|String
−
|The string to convert to a byte table
+
|The string to convert.
 
|}
 
|}
  
 +
===Returns===
 +
Table — A table containing the bytes representing each character in the string.
 +
 +
===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 <code>wordToByteTable(1337)</code>:
  
−
== Examples ==
+
- The decimal number <code>1337</code> is <code>0x0539</code> in hexadecimal.
−
  local bt = stringToByteTable('player.weapons.rifle')
+
- Computers typically use little-endian order, meaning the least significant byte comes first.
−
  bt[#bt + 1] = 0
+
- So, <code>0x0539</code> is split into two bytes: <code>0x39</code> (57 in decimal) and <code>0x05</code> (5 in decimal).
−
  writeBytes('00123ABC', bt)
+
- The resulting byte table is <code>{0x39, 0x05}</code> or <code>{57, 5}</code>.
  
 +
This means:
 +
- <code>bytes[1] = 0x39</code> (the low byte)
 +
- <code>bytes[2] = 0x05</code> (the high byte)
  
−
Code:
+
This process applies to all "ToByteTable" functions:
−
  local bt = stringToByteTable('test')
+
They break down the value into its raw bytes, ordered from least significant to most significant (little-endian).
−
  for i, v in ipairs(bt) do
 
−
    print(i - 1, string.format('%02X', v))
 
−
  end
 
  
−
Output:
+
===Examples===
−
  0 74
+
<syntaxhighlight lang="lua" line>
−
  1 65
+
local bytes = stringToByteTable("ABC")
−
  2 73
+
for i, b in ipairs(bytes) do
−
  3 74
+
  print(string.format("Byte %d: %02X", i, b))
 +
end
 +
-- Output: Byte 1: 41, Byte 2: 42, Byte 3: 43 (hex for 'A', 'B', 'C')
 +
</syntaxhighlight>
  
 +
{{LuaSeeAlso}}
  
−
== See also ==
+
{{RelatedStrings}}
−
* [[Lua]]
 
−
* [[Help_File:Script engine|Script engine]]
 
  
−
=== Related Functions ===
+
{{ReadWriteMemory}}
−
* [[ansiToUtf8]]
 
−
* [[utf8ToAnsi]]
 
−
* [[translate]]
 
−
* [[readBytes]]
 
−
* [[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]]
 
−
* [[dwordToByteTable]]
 
−
* [[qwordToByteTable]]
 
−
* [[floatToByteTable]]
 
−
* [[doubleToByteTable]]
 
−
* [[wideStringToByteTable]]
 
−
* [[byteTableToWord]]
 
−
* [[byteTableToDword]]
 
−
* [[byteTableToQword]]
 
−
* [[byteTableToFloat]]
 
−
* [[byteTableToDouble]]
 
−
* [[byteTableToString]]
 
−
* [[byteTableToWideString]]
 

Latest revision as of 15:47, 25 June 2026

<> Lua API Reference

function stringToByteTable(String) : Table

Converts a string to a table of bytes, where each byte represents the ASCII/ANSI value of the corresponding character.

Function Parameters[edit]

Parameter Type Description
String String The string to convert.

Returns[edit]

Table — A table containing the bytes representing each character in the string.

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]

1 local bytes = stringToByteTable("ABC")
2 for i, b in ipairs(bytes) do
3   print(string.format("Byte %d: %02X", i, b))
4 end
5 -- Output: Byte 1: 41, Byte 2: 42, Byte 3: 43 (hex for 'A', 'B', 'C')

Main Pages

Core Lua documentation entry points

◆ Lua
◆ Script Engine

String Related Lua Functions

Encoding conversion and localized text helpers



Retrieved from "https://wiki.cheatengine.org/index.php?title=Lua:stringToByteTable&oldid=8200"