isNil: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Some wiki formatting) |
Lou Montana (talk | contribs) m (Text replacement - "{{HashLink" to "{{Link") |
||
(One intermediate revision by the same user not shown) | |||
Line 19: | Line 19: | ||
|descr= Tests whether a variable is [[nil]] or undefined from its [[Identifier|identifier]], or whether the given expression evaluates to [[nil]] or [[Nothing]]. | |descr= Tests whether a variable is [[nil]] or undefined from its [[Identifier|identifier]], or whether the given expression evaluates to [[nil]] or [[Nothing]]. | ||
{{Feature | arma0 | This command does not exist in {{ofp}}/{{arma0}} but can be emulated (see {{ | {{Feature|arma0|This command does not exist in {{ofp}}/{{arma0}} but can be emulated (see {{Link|#Example 5}}).}} | ||
|s1= [[isNil]] variableName | |s1= [[isNil]] variableName | ||
Line 30: | Line 30: | ||
|p21= code: [[Code]] - code to evaluate: | |p21= code: [[Code]] - code to evaluate: | ||
* the code '''will''' be executed; | * the code '''will''' be executed; <sqf inline>isNil { player setDamage 1 };</sqf> ''will'' kill the player | ||
* the code will not be allowed to [[canSuspend|suspend]] while expression is evaluated, even if the parent scope allows it (see {{ | * the code will not be allowed to [[canSuspend|suspend]] while expression is evaluated, even if the parent scope allows it (see {{Link|#Example 4}}). | ||
|r2= [[Boolean]] - [[true]] if ''code'' returns [[Nothing]], [[false]] otherwise | |r2= [[Boolean]] - [[true]] if ''code'' returns [[Nothing]], [[false]] otherwise | ||
Line 60: | Line 60: | ||
|x5= {{ofp}} [[String]] comparison workaround<br> | |x5= {{ofp}} [[String]] comparison workaround<br> | ||
[[SQS Syntax]]: | [[SQS Syntax]]: | ||
< | <sqs> | ||
_nil = format ["%1", _undefinedVariable] | _nil = format ["%1", _undefinedVariable] | ||
? (format ["%1", variableToTest] == _nil) : hint "variableToTest is nil" | ? (format ["%1", variableToTest] == _nil) : hint "variableToTest is nil" | ||
</ | </sqs> | ||
[[SQF Syntax]]: | [[SQF Syntax]]: |
Revision as of 18:43, 4 January 2023
Description
- Description:
- Tests whether a variable is nil or undefined from its identifier, or whether the given expression evaluates to nil or Nothing.
- Groups:
- Variables
Syntax
- Syntax:
- isNil variableName
- Parameters:
- variableName: String - missionNamespace's or local variable's identifier (e.g "globalVariable", "_localVariable")
- Return Value:
- Boolean - true if variable is nil
Alternative Syntax
- Syntax:
- isNil code
- Parameters:
- code: Code - code to evaluate:
- Return Value:
- Boolean - true if code returns Nothing, false otherwise
Examples
- Example 1:
- Example 2:
- Example 3:
- Example 4:
- This trick forces executing something in Unscheduled Environment:
0 spawn { systemChat str canSuspend; // chat shows true isNil { hint str canSuspend }; // hint shows false };
- Example 5:
- Operation Flashpoint String comparison workaround
SQS Syntax:SQF Syntax:
Additional Information
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
Categories:
- Scripting Commands
- Introduced with Armed Assault version 1.00
- ArmA: Armed Assault: New Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Variables