Lua:readStringLocal

function readStringLocal(Address, MaxLength, [WideChar]) : String

Reads a string from the specified address in Cheat Engine's own process memory (not the target process) until a 0-terminator is encountered. The maximum number of characters to read is limited by MaxLength to prevent freezing. Set WideChar to true if the string is encoded using widechar (UTF-16/Unicode) formatting.

Function Parameters

Parameter	Type	Description
Address	Integer or CEAddressString	The address in Cheat Engine's memory to read from.
MaxLength	Integer	The maximum number of characters to read (prevents infinite loops).
WideChar	Boolean (optional)	Set to true to read as a widechar (UTF-16/Unicode) string. Default is false (ASCII/ANSI).

Returns

String — The string read from the specified address.

Examples

-- Read an ASCII string from address 0x123456 in CE's memory, up to 100 characters
local str = readStringLocal(0x123456, 100)
print("String:", str)

-- Read a widechar (Unicode) string from a CEAddressString
local wstr = readStringLocal("00400000+10", 256, true)
print("Wide string:", wstr)

See also

• Lua
• Script engine

Related Functions

• ansiToUtf8
• utf8ToAnsi
• translate
• readBytes
• readSmallInteger
• readInteger
• readQword
• readPointer
• readFloat
• readDouble
• readString
• writeBytes
• writeSmallInteger
• writeInteger
• writeQword
• writeFloat
• writeDouble
• writeString
• readBytesLocal
• readIntegerLocal
• readQwordLocal
• readPointerLocal
• readFloatLocal
• readDoubleLocal
• readStringLocal
• writeBytesLocal
• writeIntegerLocal
• writeQwordLocal
• writeFloatLocal
• writeDoubleLocal
• writeStringLocal
• wordToByteTable
• dwordToByteTable
• qwordToByteTable
• floatToByteTable
• doubleToByteTable
• stringToByteTable
• wideStringToByteTable
• byteTableToWord
• byteTableToDword
• byteTableToQword
• byteTableToFloat
• byteTableToDouble
• byteTableToString
• byteTableToWideString