scriptNull: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Some wiki formatting)
 
(54 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command


| arma3 |Game name=
|game1= arma3
|version1= 1.32


|1.32|Game version=
|gr1= Variables


|gr1= Variables |GROUP1=
|descr= A non-existing or [[scriptDone|completed]] [[Script Handle]]. To compare non-existent scripts use [[isNull]] or [[isEqualTo]]:
<sqf>
scriptNull == scriptNull; // ERROR! == cannot be used with script object
isNull scriptNull; // true
scriptNull isEqualTo scriptNull; // true
</sqf>


| A non-existing [[Script]] or script that has finished ([[scriptDone]]). To compare non-existent scripts use [[isNull]] or [[isEqualTo]]:
|s1= [[scriptNull]]
* <tt>[[scriptNull]] <nowiki>==</nowiki> [[scriptNull]]; // ERROR! <nowiki>==</nowiki> cannot be used with script object</tt>
* <tt>[[isNull]] [[scriptNull]]; // true</tt>
* <tt>[[scriptNull]] [[isEqualTo]] [[scriptNull]]; // true</tt> |DESCRIPTION=


| '''scriptNull''' |SYNTAX=
|r1= [[Script Handle]] - NULL script


| [[Script]] - NULL script |RETURNVALUE=
|x1= Wait until previous script is finished before starting a new one:
 
<sqf>
 
0 spawn
|x1= Wait until previous script is finished before starting a new one:<code>[] spawn
{
{
_script = [[scriptNull]];
_script = scriptNull;
[[for]] "_i" [[from]] 1 [[to]] 10 [[do]] {
for "_i" from 1 to 10 do
[[waitUntil]] {[[isNull]] _script};
{
_script = _i [[spawn]] {
waitUntil { isNull _script };
[[hint]] [[format]] ["script %1 started", _this];
_script = _i spawn
[[sleep]] 1;
{
[[hint]] [[format]] ["script %1 finished", _this];
hint format ["script %1 started", _this];
[[sleep]] 0.2;
sleep 1;
hint format ["script %1 finished", _this];
sleep 0.2;
};
};
};
};
};</code> |EXAMPLE1=
};
</sqf>


 
|x2= <sqf>
|x2= <code>[[if]] ([[scriptDone]] (_obj [[getVariable]] ["objScript", [[scriptNull]]])) [[then]] {
if (scriptDone (_obj getVariable ["TAG_objScript", scriptNull])) then
_obj [[setVariable]] ["objScript", _obj [[spawn]] {
{
[[waitUntil]] {[[damage]] _this > 0.9};
_scriptHandle = _obj spawn { waitUntil { damage _this > 0.9 }; hint "Critical Damage!"; };
[[hint]] "Critical Damage!";
_obj setVariable ["TAG_objScript", _scriptHandle];
}];
};
};</code> |EXAMPLE2=
</sqf>
 
| x3 = <code>[[str]] [[scriptNull]]; // <NULL-script></code> |=


|[[controlNull]], [[displayNull]], [[grpNull]], [[locationNull]], [[objNull]], [[taskNull]], [[teamMemberNull]], [[configNull]], [[typeName]], [[isNull]], [[scriptDone]], [[spawn]], [[execVM]]  |SEEALSO=
|x3= <sqf>str scriptNull; // <NULL-script></sqf>


|seealso= [[controlNull]] [[displayNull]] [[grpNull]] [[locationNull]] [[objNull]] [[taskNull]] [[teamMemberNull]] [[configNull]] [[typeName]] [[isNull]] [[scriptDone]] [[spawn]] [[execVM]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 19:03, 21 April 2024

Arma 3 logo black.png1.32
Hover & click on the images for description

Description

Description:
A non-existing or completed Script Handle. To compare non-existent scripts use isNull or isEqualTo:
scriptNull == scriptNull; // ERROR! == cannot be used with script object isNull scriptNull; // true scriptNull isEqualTo scriptNull; // true
Groups:
Variables

Syntax

Syntax:
scriptNull
Return Value:
Script Handle - NULL script

Examples

Example 1:
Wait until previous script is finished before starting a new one:
0 spawn { _script = scriptNull; for "_i" from 1 to 10 do { waitUntil { isNull _script }; _script = _i spawn { hint format ["script %1 started", _this]; sleep 1; hint format ["script %1 finished", _this]; sleep 0.2; }; }; };
Example 2:
if (scriptDone (_obj getVariable ["TAG_objScript", scriptNull])) then { _scriptHandle = _obj spawn { waitUntil { damage _this > 0.9 }; hint "Critical Damage!"; }; _obj setVariable ["TAG_objScript", _scriptHandle]; };
Example 3:
str scriptNull; // <NULL-script>

Additional Information

See also:
controlNull displayNull grpNull locationNull objNull taskNull teamMemberNull configNull typeName isNull scriptDone spawn execVM

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
Retrieved from "https://community.bistudio.com/wiki?title=scriptNull&oldid=363804"