Difference between revisions of "Lua:getNameFromAddress"

From Cheat Engine
Jump to navigation Jump to search
(Created page with '#REDIRECT getAddress')
 
m
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
#REDIRECT getAddress
+
[[Category:Lua]]
 +
'''function''' getNameFromAddress(''Address'', [''ModuleNames''], [''Symbols''], [''Sections'']) ''':''' String
 +
 
 +
Returns the given address as a string representation.
 +
Depending on the address and the options, this may return a registered symbol name, <code>modulename+offset</code>, or just a hexadecimal string.
 +
 
 +
===Function Parameters===
 +
{|width="85%" cellpadding="10%" cellspacing="0" border="0"
 +
!align="left"|Parameter
 +
!align="left"|Type
 +
!style="width: 80%;background-color:white;" align="left"|Description
 +
|-
 +
|Address
 +
|Integer or [[CEAddressString]]
 +
|The address to convert to a string.
 +
|-
 +
|ModuleNames
 +
|Boolean (optional)
 +
|If true (default), allows returning <code>modulename+offset</code> if possible.
 +
|-
 +
|Symbols
 +
|Boolean (optional)
 +
|If true (default), allows returning registered symbol names if available.
 +
|-
 +
|Sections
 +
|Boolean (optional)
 +
|If true, allows returning section names. Default is false.
 +
|}
 +
 
 +
===Returns===
 +
String — The string representation of the address.
 +
 
 +
===Examples===
 +
<pre>
 +
-- Get the name for an address, preferring symbols and module names
 +
local name = getNameFromAddress(0x401000)
 +
print(name)
 +
-- cheatengine-x86_64-SSE4-AVX2.exe+1000
 +
 
 +
-- Only return hexadecimal if no symbol or module name is available
 +
local hexOnly = getNameFromAddress(0x401000, false, false)
 +
print(hexOnly)
 +
-- 00401000
 +
</pre>
 +
 
 +
{{LuaSeeAlso}}
 +
 
 +
=== Related Functions ===
 +
* [[Lua:getAddress|getAddress]]
 +
* [[Lua:getCommonModuleList|getCommonModuleList]]
 +
* [[Lua:inModule|inModule]]
 +
* [[Lua:inSystemModule|inSystemModule]]
 +
* [[Lua:targetIs64Bit|targetIs64Bit]]
 +
* [[Lua:enumModules|enumModules]]

Latest revision as of 19:38, 11 July 2025

function getNameFromAddress(Address, [ModuleNames], [Symbols], [Sections]) : String

Returns the given address as a string representation. Depending on the address and the options, this may return a registered symbol name, modulename+offset, or just a hexadecimal string.

Function Parameters[edit]

Parameter Type Description
Address Integer or CEAddressString The address to convert to a string.
ModuleNames Boolean (optional) If true (default), allows returning modulename+offset if possible.
Symbols Boolean (optional) If true (default), allows returning registered symbol names if available.
Sections Boolean (optional) If true, allows returning section names. Default is false.

Returns[edit]

String — The string representation of the address.

Examples[edit]

-- Get the name for an address, preferring symbols and module names
local name = getNameFromAddress(0x401000)
print(name)
-- cheatengine-x86_64-SSE4-AVX2.exe+1000

-- Only return hexadecimal if no symbol or module name is available
local hexOnly = getNameFromAddress(0x401000, false, false)
print(hexOnly)
-- 00401000

See also[edit]

Related Functions[edit]