<doc>
	<legacy_id></legacy_id>
	<name>stackLimit</name>
	<type>property</type>

	<syntax>
		<example>set the stackLimit to <i>stackSizeInBytes</i></example>
		<example>get the [effective] stackLimit</example>
	</syntax>

	<synonyms>
	</synonyms>

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

	<examples>
<example>set the stackLimit to 500</example>
<example>get the effective stackLimit</example>
	</examples>

	<history>
		<introduced version="4.5.1">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<global/>
	</objects>

	<platforms>
		<windows/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<property tag="recursionLimit">recursionLimit property</property>
	</references>

	<description>
	<overview>Use the <b>stackLimit</b> property to set (in script) the maximum size of the (runtime) stack the engine uses for recursive computation.</overview>

		<parameters>
		</parameters>

	<value>The <b>stackLimit</b> is a positive integer.</value>
	<comments>The <b>stackLimit</b> 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.<p></p><p>The <b>recursionLimit</b> property is now bounded by the stackLimit &ndash; attempts to set the <b>recursionLimit</b> greater than the <b>stackLimit</b> will see it downwardly adjusted to the maximum current size allowed.</p><p></p><p></p><note>The changes to the recursionLimit property and the new stackLimit property are only implemented on Windows at present.</note></comments>
	</description>
</doc>