Difference between revisions of "Lua:readBytes"
Jump to navigation
Jump to search
m (moved readBytes to Lua:readBytes) |
m |
||
| Line 1: | Line 1: | ||
[[Category:Lua]] | [[Category:Lua]] | ||
| − | '''function''' readBytes(''Address'', '' | + | '''function''' readBytes(''Address'', ''ByteCount'', [''ReturnAsTable'']) |
| − | Returns the bytes | + | Reads bytes from the specified address in the currently opened (target) process. |
| + | Returns the bytes as multiple return values or as a table if ''ReturnAsTable'' is true. | ||
===Function Parameters=== | ===Function Parameters=== | ||
| − | {|width="85%" cellpadding="10 | + | |
| + | {|width="85%" cellpadding="10%" cellspacing="0" border="0" | ||
!align="left"|Parameter | !align="left"|Parameter | ||
!align="left"|Type | !align="left"|Type | ||
| Line 11: | Line 13: | ||
|- | |- | ||
|Address | |Address | ||
| − | |[[CEAddressString]] | + | |Integer or [[CEAddressString]] |
| − | |The address to read | + | |The address in the target process to read from. |
|- | |- | ||
| − | | | + | |ByteCount |
|Integer | |Integer | ||
| − | |The number of bytes to read | + | |The number of bytes to read. |
|- | |- | ||
|ReturnAsTable | |ReturnAsTable | ||
| − | |Boolean | + | |Boolean (optional) |
| − | | | + | |If true, returns a table of bytes. If false or omitted, returns each byte as a separate return value. |
|} | |} | ||
| + | |||
| + | ===Examples=== | ||
| + | <pre> | ||
| + | -- Read 4 bytes and get them as separate values | ||
| + | local b1, b2, b3, b4 = readBytes(0x123456, 4) | ||
| + | print(b1, b2, b3, b4) | ||
| + | |||
| + | -- Read 4 bytes and get them as a table | ||
| + | local bytes = readBytes(0x123456, 4, true) | ||
| + | for i, v in ipairs(bytes) do | ||
| + | print("Byte " .. i .. ": " .. v) | ||
| + | end | ||
| + | </pre> | ||
{{LuaSeeAlso}} | {{LuaSeeAlso}} | ||
Revision as of 16:01, 11 July 2025
function readBytes(Address, ByteCount, [ReturnAsTable])
Reads bytes from the specified address in the currently opened (target) process. Returns the bytes as multiple return values or as a table if ReturnAsTable is true.
Function Parameters
| Parameter | Type | Description |
|---|---|---|
| Address | Integer or CEAddressString | The address in the target process to read from. |
| ByteCount | Integer | The number of bytes to read. |
| ReturnAsTable | Boolean (optional) | If true, returns a table of bytes. If false or omitted, returns each byte as a separate return value. |
Examples
-- Read 4 bytes and get them as separate values
local b1, b2, b3, b4 = readBytes(0x123456, 4)
print(b1, b2, b3, b4)
-- Read 4 bytes and get them as a table
local bytes = readBytes(0x123456, 4, true)
for i, v in ipairs(bytes) do
print("Byte " .. i .. ": " .. v)
end
