isNil

From Bohemia Interactive Community
Revision as of 02:01, 27 May 2018 by Lou Montana (talk | contribs) (Add example, comments cleanup)
Jump to navigation Jump to search
-wrong parameter ("Arma") defined!-1.00
Hover & click on the images for description

Description

Description:
Tests whether the variable defined by the String argument is undefined, or whether an expression result passed as Code is undefined.
The command returns true if the variable or the expression result is undefined (i.e. the expression result is Nothing), and false in all other cases.
Logo A0.png1.00 isNil doesn't exist in Operation Flashpoint, you can emulate it:

// SQS syntax _nil = format ["%1", _undefinedVariable] ? (format ["%1", foo] == _nil) : foo = "Hello World!" // SQF syntax _nil = format ["%1", _undefinedVariable];

if (format ["%1", foo] == _nil) then { foo = "Hello World!"; };
Groups:
Uncategorised

Syntax

Syntax:
isNil variableName
Parameters:
variableName: String - name of missionNamespace variable (for example "someVar") or local variable (for example "_someVar")
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 something other than Nothing

Examples

Example 1:
if (isNil "_pokus") then { _pokus = 0; };
Example 2:
isNil {player getVariable "someVar"};
Example 3:
_myArray = [0,1]; isNil { _myArray select 0 }; // returns false isNil { _myArray select 1 }; // returns false isNil { _myArray select 2 }; // returns true isNil { _myArray select 3 }; // throws a script error. only length+1 select is allowed

Additional Information

See also:
nilVariables

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

Bottom Section