nil: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
(Add more details)
 
(42 intermediate revisions by 4 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|variables]]. |= Description
|game3= arma1
____________________________________________________________________________________________
|version3= 1.00


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


| [[Void]] |= Return value
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50
 
|x1= <code>variableToDestroy = [[nil]];</code> |= Example 1
____________________________________________________________________________________________


| [[isNil]], [[Variables]] |= 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.99|{{uc:{{PAGENAME}}}}]]
[[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}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Variables|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on September 25, 2014 - 09:50 (UTC)</dd>
<dt class="note">[[User:Kenoxite|Kenoxite]]</dt>
<dd class="note">
While [[isNil]] isn't available in OFP/CWA you can easily emulate it with something like this:
<pre>
_nil = format["%1",_nilstring];
?(format["%1",foo]==_nil): foo = "Hello World!"
</pre>
</dd>
</dl>
<!-- DISCONTINUE Notes -->
 
 
Container my_var is still incremented, even if value my_var is voided.
}}
}}

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