nil: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replace - "</dd>" to "")
(Add more details)
 
(48 intermediate revisions by 7 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]]'''<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]].


|s1= [[nil]]


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


Doing so creates a global variable with the same name that overrides the "command" ''nil'':
|x1= <sqf>variableToDestroy = nil;</sqf>


  foo = "foo";
|x2= <sqf>
  nil = "bar";
private _variable = 50;
  foo = nil;
_variable = nil;
  hint foo; // displays "bar"
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>


 
|seealso= [[isNil]] [[Variables]]
 
}}
<!-- Note Section END -->
</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]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]

Latest revision as of 10:38, 8 November 2023

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
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
Retrieved from "https://community.bistudio.com/wiki?title=nil&oldid=347969"