isNull: Difference between revisions
Jump to navigation
Jump to search
(add. classification) |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
(77 intermediate revisions by 14 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{RV|type=command | ||
| ofp |= | |game1= ofp | ||
|version1= 1.00 | |||
|1.00 | |game2= ofpe | ||
|version2= 1.00 | |||
| | |game3= arma1 | ||
|version3= 1.00 | |||
| | |game4= arma2 | ||
|version4= 1.00 | |||
|game5= arma2oa | |||
|version5= 1.50 | |||
| | |game6= tkoh | ||
|version6= 1.00 | |||
| | |game7= arma3 | ||
|version7= 0.50 | |||
| | |arg= global | ||
| | |gr1= Variables | ||
}} | |descr= Checks whether the tested item is null.<br> | ||
Which null type the item has to be equal to depends on the type of game entity tested: | |||
{{{!}} class="wikitable" style="text-align: center" | |||
! [[:Category:Data Types|Type]] | |||
{{!}} [[Object]] | |||
{{!}} [[Group]] | |||
{{!}} [[Control]] | |||
{{!}} [[Display]] | |||
{{!}} [[Location]] | |||
{{!}} [[Task]] | |||
{{!}} [[Script Handle|Script]] | |||
{{!}} [[Config]] | |||
{{!}} [[Diary Record]] | |||
{{!}} [[Team Member]] | |||
{{!}}- | |||
! Null value | |||
{{!}} [[objNull]] | |||
{{!}} [[grpNull]] | |||
{{!}} [[controlNull]] | |||
{{!}} [[displayNull]] | |||
{{!}} [[locationNull]] | |||
{{!}} [[taskNull]] | |||
{{!}} [[scriptNull]] | |||
{{!}} [[configNull]] | |||
{{!}} [[diaryRecordNull]] | |||
{{!}} [[teamMemberNull]] | |||
{{!}}- style="font-size: .85em" | |||
! Since | |||
{{!}} {{GVI|ofp|1.00}} | |||
{{!}} {{GVI|ofp|1.00}} | |||
{{!}} {{GVI|arma1|1.00}} | |||
{{!}} {{GVI|arma1|1.00}} | |||
{{!}} {{GVI|arma2|1.00}} | |||
{{!}} {{GVI|arma2|1.00}} | |||
{{!}} {{GVI|arma3|1.30}} | |||
{{!}} {{GVI|arma3|1.54}} | |||
{{!}} {{GVI|arma3|2.00}} | |||
{{!}} {{GVI|arma3|2.10}} | |||
{{!}}} | |||
{{Feature|important|2= A test via [[a == b|==]] does '''not''' work because a null value is not equal to anything, not even itself ([[configNull]] being the exception). | |||
See also [[isEqualTo]].}} | |||
|s1= [[isNull]] entity | |||
|p1= entity: [[Object]], [[Control]], [[Display]], [[Group]], [[Location]], [[Task]], [[Script Handle]], [[Config]] or [[Diary Record]] | |||
|r1= [[Boolean]] | |||
|x1= <sqf> | |||
if (isNull obj) then | |||
{ | |||
hint "obj variable is defined but obj is null"; | |||
}; | |||
</sqf> | |||
|x2= [[Diary Record]] support before {{GVI|arma3|2.00}}: | |||
<sqf> | |||
< | private _nullRecord = objNull createDiaryRecord []; // wrong parameters = failure to create a record = null value | ||
private _createdRecord = player createDiaryRecord ["Diary", ["title", "description"]]; | |||
if (_createdRecord isEqualTo _nullRecord) then { hint "Failed" }; | |||
</sqf> | |||
< | [[Team Member]] support before {{GVI|arma3|2.10}}: | ||
</ | <sqf>private _isNull = _teamMember isEqualTo teamMemberNull;</sqf> | ||
|seealso= [[controlNull]] [[displayNull]] [[grpNull]] [[locationNull]] [[objNull]] [[taskNull]] [[teamMemberNull]] [[scriptNull]] [[configNull]] [[typeName]] | |||
[[ | }} | ||
[[ | |||
[[ | |||
[[ | |||
[[ | |||
[[ | |||
[[ | |||
[[ |
Latest revision as of 11:04, 29 December 2022
Description
- Description:
- Checks whether the tested item is null.
Which null type the item has to be equal to depends on the type of game entity tested: - Groups:
- Variables
Syntax
- Syntax:
- isNull entity
- Parameters:
- entity: Object, Control, Display, Group, Location, Task, Script Handle, Config or Diary Record
- Return Value:
- Boolean
Examples
- Example 1:
- Example 2:
- Diary Record support before
2.00:
Team Member support before2.10:
Additional Information
- See also:
- controlNull displayNull grpNull locationNull objNull taskNull teamMemberNull scriptNull configNull typeName
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
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.00
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Operation Flashpoint: Elite: Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Variables