Lua:createMemoryStream

From Cheat Engine
Jump to navigation Jump to search

<> Lua API Reference

function createMemoryStream() : MemoryStream

Creates a new MemoryStream object.

A MemoryStream is a stream stored in memory. It inherits from Stream and Object, and can be used to load, store, modify, or save binary data.

The MemoryStream's memory address can be accessed through its read-only Memory property. This address may change when the stream size changes.

Function Parameters[edit]

This function has no parameters.

Returns[edit]

MemoryStream — A new MemoryStream object.

Class Information[edit]

Class Inherits From Description
MemoryStream Stream, Object A stream object that stores its contents in memory.

Properties[edit]

Property Type Description
Memory Integer The address in Cheat Engine's memory where this stream is currently loaded. This property is read-only and may change when the stream size changes.

Methods[edit]

Method Return Type Description
loadFromFile(filename) void Replaces the contents of the memory stream with the contents of a file on disk.
saveToFile(filename) void Writes the contents of the memory stream to the specified file.
loadFromFileNoError(filename) Boolean, String Replaces the contents of the memory stream with the contents of a file on disk. On success, returns true. On failure, returns false and a secondary return value containing the error message.
saveToFileNoError(filename) Boolean, String Writes the contents of the memory stream to the specified file. On success, returns true. On failure, returns false and a secondary return value containing the error message.

Examples[edit]

1 local stream = createMemoryStream()
2 
3 stream.loadFromFile("C:\\\\Temp\\\\input.bin")
4 print("Memory address: " .. string.format("%X", stream.Memory))
5 
6 stream.saveToFile("C:\\\\Temp\\\\output.bin")
1 local stream = createMemoryStream()
2 
3 local success, errorMessage = stream.loadFromFileNoError("C:\\\\Temp\\\\input.bin")
4 
5 if success then
6   print("File loaded into memory stream")
7 else
8   print("Failed to load file: " .. errorMessage)
9 end

Main Pages

Core Lua documentation entry points

Lua
Script Engine

Sections / Views

Memory Mapping

Memory Copy / Compare

Memory Streams