stackLimit

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the stackLimit to <stackSizeInBytes>
get the [effective] stackLimit
Summary

Allows a script to set (in bytes) the maximum size of the (runtime) stack the engineuses for recursive computation.

Introduced4.5.1
OSwindows
Platformsdesktop, server, mobile
Example
set the stackLimit to 500
get the effective stackLimit
Values
NameTypeDescription
Value

The stackLimit is a positive integer.

RelatedProperty: recursionLimit
Description

Use the stackLimit property to set (in script) the maximum size of the (runtime) stack the engine uses for recursive computation.

The stackLimit property allows a script to set (in bytes) the maximum size of the (runtime) stack the engine uses for recursive computation. A change in the setting will only take effect when all currently executing handlers complete, and at this time the stack size limit will be reconfigured to the given limit, or the nearest amount to it depending on available memory.

The recursionLimit property is now bounded by the stackLimit – attempts to set the recursionLimit greater than the stackLimit will see it downwardly adjusted to the maximum current size allowed.

Note: The changes to the recursionLimit property and the new stackLimit property are only implemented on Windows at present.