View source for Load.logics.v

The '''load.logics.v''' command indirectly loads a [[logic]] resource onto the [[memory heap]].

== Syntax ==

load.logics.v([[variable|var]] vLOGICNUM);

== Remarks ==

This command loads [[logic]] '''B''', where '''B''' equals the value of '''vLOGICNUM''', onto the [[memory heap]], keeping it in memory permanently until it gets unloaded (by ending the game, [[restarting]], [[restoring]], or entering a [[new room]]). This avoids having to load and unload it each time it is called with the '''[[call]]''' command.

There is no 'discard logic' command to unload a logic once it is loaded.

AGI adds a script entry to the [[script stack]] each time a [[logic]] resource is loaded.

== Possible Errors ==

If you attempt to load a [[logic]] that does not exist, AGI will raise a [[runtime error]] and crash.

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
v50 = 75;
call.v(v50);        [ loads and executes logic 75, unloading it after returning
load.logics.v(v50); [  loads logic, and adds script entry
call.v(v50);        [ executes logic, but does not unload it after returning
</syntaxhighlight>

== Technical Information ==

{| border="1" cellpadding="2"
| style="background-color: #efefef" width="200" | '''Required Interpreter Version:'''
| width="175" | Available in all AGI versions.
|-
| style="background-color: #efefef" | '''Byte-Code Value:'''
| 21 (0x15 hex)
|}

== See Also ==

'''[[call]]'''<br />
'''[[load.logics]]'''<br />
[[Memory Management]]<br />
[[AGI Scripts]]<br />
[[Category:Commands]]<br />