nil: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
(Add more details)
 
(53 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| ofp |= Game name
|game1= ofp
|version1= 1.00


|1.00|= Game version
|game2= ofpe
____________________________________________________________________________________________
|version2= 1.00


| Nil value. This value can be used to undefine existing variables. |= Description
|game3= arma1
____________________________________________________________________________________________
|version3= 1.00


| '''nil''' |= Syntax
|game4= arma2
|version4= 1.00


| [[Any Value]] |= Return value
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50
 
|x1= <pre>variableToDestroy = nil</pre> |= Example 1
____________________________________________________________________________________________


| |= See also
|game6= tkoh
|version6= 1.00


}}
|game7= arma3
|version7= 0.50


<h3 style="display:none">Notes</h3>
|gr1= Variables
<dl class="command_description">
<!-- Note Section BEGIN -->
<dt class="note">'''[[User:Mikero|Mikero]]'''</dt><dd class="note">
Note that ArrayName = nil destroys the arrayNAME '''not''' the array content.


Array content is 'destroyed' when no more ArrayName'''s''' refer to the content.
|descr= Nil value. This value can be used to undefine existing [[Variables|variables]].
</dd>


<dt class="note">'''[[User:Worldeater|Worldeater]]'''</dt><dd class="note">
|s1= [[nil]]
'''Never ever assign a value to ''nil''!'''


Doing so creates a global variable with the same name that overrides the "command" ''nil'':
|r1= [[Nothing]]


  foo = "foo";
|x1= <sqf>variableToDestroy = nil;</sqf>
  nil = "bar";
  foo = nil;
  hint foo; // displays "bar"
</dd>


|x2= <sqf>
private _variable = 50;
_variable = nil;
hint format ["Variable = %1", _variable]; // will display "Variable = any" in {{Link|Scheduler#Unscheduled Environment|unscheduled environment}}
// will output "Error Undefined variable in expression: _variable" in {{Link|Scheduler#Scheduled Environment|scheduled environment}}
// identical to
hint format ["Variable = %1", _variableThatWasNeverDefined];
</sqf>


<!-- Note Section END -->
|seealso= [[isNil]] [[Variables]]
</dl>
}}
 
<h3 style="display:none">Bottom Section</h3>
 
 
[[Category:Scripting Commands|NIL]]
[[Category:Scripting Commands OFP 1.96|NIL]]
[[Category:Scripting Commands OFP 1.46|NIL]]
[[Category:Scripting Commands ArmA|NIL]]

Latest revision as of 10:38, 8 November 2023

Hover & click on the images for description

Description

Description:
Nil value. This value can be used to undefine existing variables.
Groups:
Variables

Syntax

Syntax:
nil
Return Value:
Nothing

Examples

Example 1:
variableToDestroy = nil;
Example 2:
private _variable = 50; _variable = nil; hint format ["Variable = %1", _variable]; // will display "Variable = any" in unscheduled environment // will output "Error Undefined variable in expression: _variable" in scheduled environment // identical to hint format ["Variable = %1", _variableThatWasNeverDefined];

Additional Information

See also:
isNil Variables

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