exec: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (Text replacement - "|Game name=" to "|Game name= |gr1= Program Flow |GROUP1= ")
(37 intermediate revisions by 20 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|E]]
{{Command|Comments=
[[Category:Scripting Commands OFP 1.97|E]]
____________________________________________________________________________________________
[[Category:Scripting Commands OFP 1.46|E]]
[[Category:Scripting Commands ArmA|E]]


| ofp |Game name=


<h2 style="color:#000066"> '''''argument'' exec ''script'''''</h2>
|gr1= Program Flow |GROUP1=




'''Operand types:'''


'''argument:''' [[Any Value]]
|1.00|Game version=
____________________________________________________________________________________________


'''script:''' [[String]]
| Execute a script using (the deprecated but still available) [[SQS syntax]]. [[SQF syntax]] (and [[execVM]]) is the most recent scripting language.<br>
The magic variable [[Magic_Variables#time|_time]] used within the script contains the elapsed time in seconds since the script started.
{{Informative | To see the active SQS scripts currently in the scheduler, use [[diag_activeSQSScripts]] command.}} |DESCRIPTION=
____________________________________________________________________________________________


'''Type of returned value:'''
| argument [[exec]] script |SYNTAX=


[[Nothing]]
|p1= argument: [[Any Value]] - the argument passed to the script through the [[Magic_Variables#this|_this]] variable. To pass multiple arguments, use an [[Array]]. |PARAMETER1=


'''Description:'''
|p2= script: [[String]] - the file path to the script. It should be given relatively to the mission folder, campaign scripts subfolder or global scripts folder and is searched there in the same order.<br>If you refer to a script packed together with an addon, the path should look like this: "\ADDON_PBO_NAME\script.sqs" where ADDON_PBO_NAME is the name of the addon's [[PBO]] file without extension. |PARAMETER2=


Execute script.
| [[Nothing]] |RETURNVALUE=
____________________________________________________________________________________________
 
|x1= <code>[<nowiki/>[[player]], _jeep] [[exec]] "getin.sqs"</code> |EXAMPLE1=
____________________________________________________________________________________________


Argument is passed to script as local variable '''_this'''.
| [[execVM]], [[call]], [[spawn]], [[execFSM]] |SEEALSO=
}}


Script is first searched for in mission folder, then in campaign scripts subfolder, lastly in global scripts folder.
<h3 style="display:none">Bottom Section</h3>


 
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
'''Example:'''
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
[ [[player]], jeepOne] '''exec''' "getIn.sqs"
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Armed Assault|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]

Revision as of 11:37, 18 September 2020

Hover & click on the images for description

Description

Description:
Execute a script using (the deprecated but still available) SQS syntax. SQF syntax (and execVM) is the most recent scripting language.
The magic variable _time used within the script contains the elapsed time in seconds since the script started.
To see the active SQS scripts currently in the scheduler, use diag_activeSQSScripts command.
Groups:
Program Flow

Syntax

Syntax:
argument exec script
Parameters:
argument: Any Value - the argument passed to the script through the _this variable. To pass multiple arguments, use an Array.
script: String - the file path to the script. It should be given relatively to the mission folder, campaign scripts subfolder or global scripts folder and is searched there in the same order.
If you refer to a script packed together with an addon, the path should look like this: "\ADDON_PBO_NAME\script.sqs" where ADDON_PBO_NAME is the name of the addon's PBO file without extension.
Return Value:
Nothing

Examples

Example 1:
[player, _jeep] exec "getin.sqs"

Additional Information

See also:
execVMcallspawnexecFSM

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

Bottom Section