isNil
From Bohemia Interactive Community
Click on the images for descriptions
Introduced in
- Game:
- Armed Assault
- Version:
- 1.00
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.ⓘisNil doesn't exist in Operation Flashpoint, you can emulate it:
if (format ["%1", foo] == _nil) then { foo = "Hello World!"; };// SQS syntax _nil = format ["%1", _undefinedVariable] ? (format ["%1", foo] == _nil) : foo = "Hello World!"
// SQF syntax _nil = format ["%1", _undefinedVariable];
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:
- the code will be executed.
isNil { player setDamage 1; };
will kill the player - the code will be executed in unscheduled environment
- the code will be executed.
- 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
Notes
Only post proven facts here. Report bugs on the feedback tracker. Use the talk page or the forums for discussions.
Add New Note | How To
Add New Note | How To