hasMemory

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
the hasMemory of <bytes>
hasMemory(<bytes>)
Summary

Returns true if the specified amount of memory is available, false otherwise.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
bytes

The number of bytes you require. If the amount of available memory is greater than or equal to the bytes, the function returns true.

Example
hasMemory(2*1024*1024) -- returns true if 2M available
if hasMemory(500*1024) then open stack "Explore Multimedia"
RelatedKeyword: graphic
Property: size, destroyStack, alwaysBuffer, freeSize
Command: revUnloadSpeech
Function: heapSpace, stackSpace, value, diskSpace
Control Structure: function
Glossary: Mac OS, return
Description

Use the hasMemory function to check whether there's enough memory available for an action (such as displaying a large graphic) before you do it.

This function is only partially implemented, and may not return useful values on some platforms. It is included in LiveCode for compatibility with imported SuperCard projects.

*Cross-platform note:* On Mac OS systems, the value returned depends on the amount of free memory in the application heap and does not take available temporary memory into account. This means that even if the hasMemory function returns false, there may be enough system memory available for the task, since LiveCode uses temporary memory when necessary.