pmem

pmem index -> val

pmem index val -> val

Parameters

• index : the index of the value you want to save/read in the persistent memory (0..255)
• val : the value you want to store in the memory. Omit this parameter if you want to read the memory.

Output

• val : when function is call with only index parameters it'll return the value saved in that memory slot.

Description

This function allows you to save and retrieve data in one of the 256 individual 32-bit slots available in the cartridge's persistent memory. This is useful for saving high-scores, level advancement or achievements. The data is stored as unsigned 32-bit integers (from 0 to 4294967295).

Tips

• pmem depends on the cartridge hash (md5), so don't change your lua script if you want to keep the data.
• Use saveid: with a personalized string in the header metadata to override the default MD5 calculation. This allows the user to update a cart without losing their saved data.

Example

--pmem demo
--load saved value at slot zero and save it back
--incremented by 1
pmem(0,pmem(0)+1)

function TIC()
 cls()
 print("Started "..pmem(0).." times");
end