spawn

-wrong parameter ("Arma") defined!-1.00

Hover & click on the images for description

Description

Description:

Starts running a new script (SQF). Additional arguments are passed in local _this variable. The new script is running in scheduled environment, spawn does not wait for it to be done, instead spawn returns a Script handle.

Groups:

Uncategorised

Syntax

Syntax:

arguments spawn code

Parameters:

arguments: Any Value

code: Code

Return Value:

Script Handle - can be used to determine (via scriptDone (also via isNull in Arma 3)) when the spawned script has finished. In Arma 3, the handle is also available inside the spawned script in _thisScript variable.

Examples

Example 1:

[] spawn { player globalChat "This is run in parallel."; };

Example 2:

There is no guarantee that spawned scripts will be executed in the same order they spawned: for "_i" from 0 to 100 do { _null = _i spawn { diag_log _this } } Result: 51,1,2...49,50,0,52,53...100

Additional Information

See also:

callexecVMexecFSMexeccompilepreprocessFileLineNumberspreprocessFileterminatescriptDone

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

Posted on 5 March, 2009

Kronzky

spawn cannot call other local functions on the same scope as itself.
It can, however, call other global functions: _addOne = {TST=TST+1}; TST_addOne = {TST=TST+1}; _add = { TST=TST+1; player sideChat format ["added: %1",TST]; [] call _addOne; player sideChat format ["called local: %1",TST]; [] call TST_addOne; player sideChat format ["called global: %1",TST]; }; TST=0; [] call _add; [] spawn _add; The call of _addOne from the spawned function does not do anything.

Bottom Section

Posted on October 21, 2014 - 23:33 (UTC)

DreadedEntity

spawn requires a script handle when used in the 2D editor. (A3)
In scripts and in the debug console, it is not required, but very useful for keeping track of running scripts. Having a script handle also makes it easy to terminate scripts at any time.

Since spawn creates a new scheduled environment, having an excess of open threads can make the scheduler queue extremely long, significantly increasing the execution time of each thread. (it takes an extremely large amount of threads, though)

Posted on August 25, 2015 - 13:39 (UTC)

IT07

If you want to call a local function which has NOT been created inside a spawned function, then do this: _fncOne = { systemChat"This is _fncOne" }; _fncTwo = { call (_this select 0) }; [_fncOne] spawn _fncTwo;