Difference between revisions of "execVM"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|SYNTAX= |p21=" to "|SYNTAX2= |p21=")
Line 9: Line 9:
 
| Compiles and adds [[SQF_syntax|SQF]] [[Script]] to the [[Scheduler|scheduler]] queue and returns script handle. The script is first searched for in the mission folder, then in the campaign scripts folder and finally in the global scripts folder. The script does not execute immediately upon running [[execVM]] command, but with some delay. How much delay is unknown as it largely depends on how many other scripts there are in the queue and how busy is VM. The optional argument is passed to the script in [[private]] variable <tt>_this</tt>. In Arma 3 the script handle is also passed to the script in <tt>_thisScript</tt> variable.
 
| Compiles and adds [[SQF_syntax|SQF]] [[Script]] to the [[Scheduler|scheduler]] queue and returns script handle. The script is first searched for in the mission folder, then in the campaign scripts folder and finally in the global scripts folder. The script does not execute immediately upon running [[execVM]] command, but with some delay. How much delay is unknown as it largely depends on how many other scripts there are in the queue and how busy is VM. The optional argument is passed to the script in [[private]] variable <tt>_this</tt>. In Arma 3 the script handle is also passed to the script in <tt>_thisScript</tt> variable.
 
<br><br>In order to understand [[execVM]] consider the following comparison:
 
<br><br>In order to understand [[execVM]] consider the following comparison:
<code>[[private]] _handle <nowiki>=</nowiki> _args [[execVM]] "someFile.sqf";
+
<code>[[private]] _handle {{=}} _args [[execVM]] "someFile.sqf";
// is practically identical to
+
{{cc|is practically identical to}}
[[private]] _handle <nowiki>=</nowiki> _args [[spawn]] [[compile]] [[preprocessFileLineNumbers]] "someFile.sqf";</code>
+
[[private]] _handle {{=}} _args [[spawn]] [[compile]] [[preprocessFileLineNumbers]] "someFile.sqf";</code>
 
So if you need multiple execution of the same file, you might want to store it in a function ([[Functions_Library_(Arma_3)|Functions Library]]), otherwise, for a single execution, [[execVM]] is a good choice.<br><br>
 
So if you need multiple execution of the same file, you might want to store it in a function ([[Functions_Library_(Arma_3)|Functions Library]]), otherwise, for a single execution, [[execVM]] is a good choice.<br><br>
  
Line 19: Line 19:
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| arguments '''execVM''' filename |SYNTAX=
+
| arguments [[execVM]] filename |SYNTAX=
  
|p1= arguments: [[Anything]] - Arguments accessible as <tt>_this</tt> in the script |PARAMETER1=
+
|p1= arguments: [[Anything]] - arguments accessible as <tt>[[_this]]</tt> in the script |PARAMETER1=
  
|p2= filename: [[String]] - file with sqf code (doesn't have to have .sqf extension, but not using standard extensions may cause problems later, during binarisation)|PARAMETER2=
+
|p2= filename: [[String]] - file with sqf code (doesn't have to have .sqf extension, but not using standard extensions may cause problems later during binarisation) |PARAMETER2=
  
 
| [[Script]] - script handle, can be used to determine (via [[scriptDone]] (also via [[isNull]] in Arma 3)) when the execVMed script has finished. In Arma 3, the handle is also available inside the execVMed script in <tt>_thisScript</tt> variable.|RETURNVALUE=
 
| [[Script]] - script handle, can be used to determine (via [[scriptDone]] (also via [[isNull]] in Arma 3)) when the execVMed script has finished. In Arma 3, the handle is also available inside the execVMed script in <tt>_thisScript</tt> variable.|RETURNVALUE=
  
|s2= '''execVM''' filename |SYNTAX2=
+
|s2= [[execVM]] filename |SYNTAX2=
  
|p21= filename: [[String]] - file with sqf code (doesn't have to have .sqf extension, but not using standard extensions may cause problems later, during binarisation) |PARAMETER2=
+
|p21= filename: [[String]] - file with sqf code (doesn't have to have .sqf extension, but not using standard extensions may cause problems later, during binarisation) |PARAMETER21=
  
| r2= [[Script]] - script handle, can be used to determine (via [[scriptDone]] (also via [[isNull]] in Arma 3)) when the execVMed script has finished. In Arma 3, the handle is also available inside the execVMed script in <tt>_thisScript</tt> variable.|RETURNVALUE=
+
|r2= [[Script]] - script handle, can be used to determine (via [[scriptDone]] (also via [[isNull]] in Arma 3)) when the execVMed script has finished. In Arma 3, the handle is also available inside the execVMed script in <tt>_thisScript</tt> variable.|RETURNVALUE2=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
 
   
 
   
 
|x1= <code>_handle = [[execVM]] "test.sqf";</code> |EXAMPLE1=
 
|x1= <code>_handle = [[execVM]] "test.sqf";</code> |EXAMPLE1=
  
|x2= <code>_handle = [[player]] [[execVM]] "test.sqf";  
+
|x2= <code>_handle = [[player]] [[execVM]] "test.sqf";
[[waitUntil]] {[[scriptDone]] _handle};</code> |EXAMPLE2=
+
[[waitUntil]] { [[scriptDone]] _handle };</code> |EXAMPLE2=
  
|x3= In Arma 3 this is also possible: <code>_handle = [[execVM]] "123.sqf";  
+
|x3= In Arma 3 this is also possible:
[[waitUntil]] {[[isNull]] _handle};</code> |EXAMPLE2=
+
<code>_handle = [[execVM]] "123.sqf";  
 +
[[waitUntil]] { [[isNull]] _handle };</code> |EXAMPLE3=
  
 
+
|x4= <code>[4] [[execVM]] "showDamage.sqf";
|x4= <code>[4] execVM "showDamage.sqf";
+
{{cc|showDamage.sqf}}
// showDamage.sqf
+
[[private]] _damage = _this [[select]] 0;
_damage = _this [[select]] 0;
 
 
[[hint]] [[format]] ["%1", _damage];</code> |EXAMPLE4=
 
[[hint]] [[format]] ["%1", _damage];</code> |EXAMPLE4=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
 
| [[call]], [[spawn]], [[exec]], [[execFSM]], [[scriptDone]], [[scriptNull]], [[terminate]], [[sleep]], [[uiSleep]], [[waitUntil]], [[canSuspend]], [[diag_activeScripts]], [[diag_activeSQFScripts]], [[SQF syntax]], [[Control Structures]] |SEEALSO=
 
| [[call]], [[spawn]], [[exec]], [[execFSM]], [[scriptDone]], [[scriptNull]], [[terminate]], [[sleep]], [[uiSleep]], [[waitUntil]], [[canSuspend]], [[diag_activeScripts]], [[diag_activeSQFScripts]], [[SQF syntax]], [[Control Structures]] |SEEALSO=
 
 
}}
 
}}
  
Line 62: Line 61:
  
 
<dd class="notedate">Posted on November 23, 2010 - 15:56
 
<dd class="notedate">Posted on November 23, 2010 - 15:56
<dt class="note">'''[[User:Kabilen|Kabilen]]'''<dd class="note">Passing variables to the script file''
+
<dt class="note">[[User:Kabilen|Kabilen]]
 +
<dd class="note">Passing variables to the script file''
  
 
To pass multiple variables to the script file, use an array e.g:
 
To pass multiple variables to the script file, use an array e.g:
Line 88: Line 88:
 
<h3 style="display:none">Bottom Section</h3>
 
<h3 style="display:none">Bottom Section</h3>
  
[[Category:Scripting Commands|EXECVM]]
+
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA|EXECVM]]
+
[[Category:Scripting Commands ArmA|{{uc:{{PAGENAME}}}}]]
[[Category:Command Group: Program Flow|EXECVM]]
 
 
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Command Group: Program Flow|{{uc:{{PAGENAME}}}}]]

Revision as of 19:58, 1 October 2019

-wrong parameter ("Arma") defined!-1.00
Hover & click on the images for description

Description

Description:
Compiles and adds SQF Script to the scheduler queue and returns script handle. The script is first searched for in the mission folder, then in the campaign scripts folder and finally in the global scripts folder. The script does not execute immediately upon running execVM command, but with some delay. How much delay is unknown as it largely depends on how many other scripts there are in the queue and how busy is VM. The optional argument is passed to the script in private variable _this. In Arma 3 the script handle is also passed to the script in _thisScript variable.

In order to understand execVM consider the following comparison: private _handle = _args execVM "someFile.sqf"; // is practically identical to private _handle = _args spawn compile preprocessFileLineNumbers "someFile.sqf"; So if you need multiple execution of the same file, you might want to store it in a function (Functions Library), otherwise, for a single execution, execVM is a good choice.

To see what VM scripts are currently in the scheduler, use diag_activeSQFScripts command.

Template:Warning
Groups:
Uncategorised

Syntax

Syntax:
arguments execVM filename
Parameters:
arguments: Anything - arguments accessible as _this in the script
filename: String - file with sqf code (doesn't have to have .sqf extension, but not using standard extensions may cause problems later during binarisation)
Return Value:
Script - script handle, can be used to determine (via scriptDone (also via isNull in Arma 3)) when the execVMed script has finished. In Arma 3, the handle is also available inside the execVMed script in _thisScript variable.

Alternative Syntax

Syntax:
execVM filename
Parameters:
filename: String - file with sqf code (doesn't have to have .sqf extension, but not using standard extensions may cause problems later, during binarisation)
Return Value:
Script - script handle, can be used to determine (via scriptDone (also via isNull in Arma 3)) when the execVMed script has finished. In Arma 3, the handle is also available inside the execVMed script in _thisScript variable.

Examples

Example 1:
_handle = execVM "test.sqf";
Example 2:
_handle = player execVM "test.sqf"; waitUntil { scriptDone _handle };
Example 3:
In Arma 3 this is also possible: _handle = execVM "123.sqf"; waitUntil { isNull _handle };
Example 4:
[4] execVM "showDamage.sqf"; // showDamage.sqf private _damage = _this select 0; hint format ["%1", _damage];

Additional Information

See also:
callspawnexecexecFSMscriptDonescriptNullterminatesleepuiSleepwaitUntilcanSuspenddiag_activeScriptsdiag_activeSQFScriptsSQF syntaxControl Structures

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Notes

Notes

Posted on November 23, 2010 - 15:56
Kabilen
Passing variables to the script file To pass multiple variables to the script file, use an array e.g: null = [myunit,1234] execVM "test.sqf"; Now within test.sqf to access the elements, use the following: _myunit = _this select 0;
_myvar = _this select 1;

Notes

Bottom Section