View source for Call.v

The '''call.v''' command executes a logic script by reference.

== Syntax ==

call.v([[variable|var]] vA);

== Remarks ==

The [[logic]] with resource number equal to value of variable '''vA''' is executed one time. If it is not currently loaded when called, it is loaded, then executed, and then unloaded after returning. A [[script entry]] is not made for logics that are loaded/unloaded in support of the '''call.v''' command.

If a logic is likely to be called more than once or twice, it is better to load it using the '''[[load.logics.v]]''' command. This avoids having AGI continually load and unload the same logic over and over.

== Possible Errors ==

If the logic does not exist, AGI will display a 'resource not found' message, and immediately quit.

== Example ==

<div class="CodeBlockHeader">Code:</div>
<syntaxhighlight lang="agi">
[ assume logic #98 is error handling logic
v50 = 98;
if(errorNumber > 0)
  {
  call.v(v50);
  }
</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:'''
| 23 (0x17 hex)
|}

== See Also ==

[[Flow Control Commands]]<br />
'''[[call]]'''<br />
'''[[load.logics.v]]'''<br />
[[Category:Commands]]<br />