Difference between revisions of "Lua:splitDisassembledString"

From Cheat Engine
Jump to navigation Jump to search
m (Syntax Highlighting.)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
'''function''' splitDisassembledString(''DisassembledString'')
+
[[Category:Lua]]
 +
{{CodeBox|'''function''' splitDisassembledString(''disassembledString'') ''':''' String, String, String, String}}
  
−
Slipts a disassembler string, returning 4 strings. The address, bytes, opcode and extra field.
+
Splits a disassembled instruction string (typically returned from <code>disassemble</code>) into '''four separate strings''':
−
To be used with return from [[disassemble]].
+
the address, opcode, bytes, and extra field (comment).
  
−
=== Function Parameters ===
+
===Function Parameters===
−
 
+
{|width="85%" cellpadding="5%" 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
 
!style="width: 80%;background-color:white;" align="left"|Description
 
!style="width: 80%;background-color:white;" align="left"|Description
 
|-
 
|-
−
|DisassembledString
+
|disassembledString
−
|string
+
|String
−
|The disassembled string to split
+
|The disassembled instruction string to parse.
 
|}
 
|}
  
 +
===Example===
 +
<syntaxhighlight lang="lua" line>
 +
local disStr = disassemble(0x00403E0B)
 +
local address, opcode, bytes, extra = splitDisassembledString(disStr)
 +
print(address)  -- e.g., "[cheatengine-x86_64-SSE4-AVX2.exe+7BF0A0]"
 +
print(opcode)  -- e.g., "lea rcx,[00BBF010]"
 +
print(bytes)    -- e.g., "48 8D 0D FEB17B00"
 +
print(extra)    -- e.g., "00403E0B"
 +
</syntaxhighlight>
  
−
== Examples ==
+
{{LuaSeeAlso}}
−
  local addr = getAddress('00123ABC')
 
−
  local disassStr = disassemble(addr)
 
−
  local extraField, opcode, bytes, address = splitDisassembledString(disassStr)
 
−
  local addr_2 = addr + getInstructionSize(addr)
 
−
  local disassStr_2 = disassemble(addr)
 
−
  local extraField_2, opcode_2, bytes_2, address_2 = splitDisassembledString(disassStr)
 
−
 
 
−
 
 
−
Code:
 
−
  local addr = getAddress('Tutorial-x86_64.exe+164A7')
 
−
  local disassStr = disassemble(addr)
 
−
  local extraField, opcode, bytes, address = splitDisassembledString(disassStr)
 
−
  for i = 1, 10 do
 
−
    local a = getNameFromAddress(address) or address
 
−
    local b = bytes .. string.rep(' ', 20 - #bytes)
 
−
    local o = opcode .. string.rep(' ', 30 - #opcode)
 
−
    print(string.format('%s:  %s  -  %s    %s', a, b, o, extraField))
 
−
    addr = addr + getInstructionSize(addr)
 
−
    disassStr = disassemble(addr)
 
−
    extraField, opcode, bytes, address = splitDisassembledString(disassStr)
 
−
  end
 
−
Output:
 
−
  Tutorial-x86_64.exe+164A7:  48 63 40 3C          -  movsxd  rax,dword ptr [rax+3C]   
 
−
  Tutorial-x86_64.exe+164AB:  48 8D 04 03          -  lea rax,[rbx+rax]                 
 
−
  Tutorial-x86_64.exe+164AF:  48 8B 40 60          -  mov rax,[rax+60]                 
 
−
  Tutorial-x86_64.exe+164B3:  90                    -  nop                               
 
−
  Tutorial-x86_64.exe+164B4:  48 8D 64 24 20        -  lea rsp,[rsp+20]                 
 
−
  Tutorial-x86_64.exe+164B9:  5B                    -  pop rbx                           
 
−
  Tutorial-x86_64.exe+164BA:  C3                    -  ret                               
 
−
  Tutorial-x86_64.exe+164BB:  00 00                -  add [rax],al                     
 
−
  Tutorial-x86_64.exe+164BD:  00 00                -  add [rax],al                     
 
−
  Tutorial-x86_64.exe+164BF:  00 53 48              -  add [rbx+48],dl 
 
−
 
 
−
 
 
−
== See also ==
 
−
* [[Lua]]
 
−
* [[Help_File:Script engine|Script engine]]
 
  
−
=== Related Functions ===
+
{{Assembly}}
−
* [[disassemble]]
 
−
* [[getInstructionSize]]
 
−
* [[getPreviousOpcode]]
 
−
* [[AOBScan]]
 
−
* [[autoAssemble]]
 
−
* [[readBytes]]
 
−
* [[readPointer]]
 
−
* [[writeBytes]]
 
−
* [[writeFloat]]
 
−
* [[readBytesLocal]]
 
−
* [[readPointerLocal]]
 
−
* [[writeBytesLocal]]
 
−
* [[wordToByteTable]]
 
−
* [[dwordToByteTable]]
 
−
* [[qwordToByteTable]]
 
−
* [[floatToByteTable]]
 
−
* [[doubleToByteTable]]
 
−
* [[stringToByteTable]]
 
−
* [[wideStringToByteTable]]
 
−
* [[byteTableToWord]]
 
−
* [[byteTableToDword]]
 
−
* [[byteTableToQword]]
 
−
* [[byteTableToFloat]]
 
−
* [[byteTableToDouble]]
 
−
* [[byteTableToString]]
 
−
* [[byteTableToWideString]]
 

Latest revision as of 19:27, 25 June 2026

<> Lua API Reference

function splitDisassembledString(disassembledString) : String, String, String, String

Splits a disassembled instruction string (typically returned from disassemble) into four separate strings: the address, opcode, bytes, and extra field (comment).

Function Parameters[edit]

Parameter Type Description
disassembledString String The disassembled instruction string to parse.

Example[edit]

1 local disStr = disassemble(0x00403E0B)
2 local address, opcode, bytes, extra = splitDisassembledString(disStr)
3 print(address)  -- e.g., "[cheatengine-x86_64-SSE4-AVX2.exe+7BF0A0]"
4 print(opcode)   -- e.g., "lea rcx,[00BBF010]"
5 print(bytes)    -- e.g., "48 8D 0D FEB17B00"
6 print(extra)    -- e.g., "00403E0B"

Main Pages

Core Lua documentation entry points

◆ Lua
◆ Script Engine

Assembler and Disassembler Related Lua Functions

Auto assembler, disassembly helpers, instruction size lookup, and assembler callbacks



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