isNull: Difference between revisions

Latest revision as of 11:04, 29 December 2022

1.00

Hover & click on the images for description

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:

Type	Object	Group	Control	Display	Location	Task	Script	Config	Diary Record	Team Member
Null value	objNull	grpNull	controlNull	displayNull	locationNull	taskNull	scriptNull	configNull	diaryRecordNull	teamMemberNull
Since	1.00	1.00	1.00	1.00	1.00	1.00	1.30	1.54	2.00	2.10

⚠

A test via == does not work because a null value is not equal to anything, not even itself (configNull being the exception). See also isEqualTo.

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:: if (isNull obj) then { hint "obj variable is defined but obj is null"; };
Example 2:: Diary Record support before 2.00:
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" };
Team Member support before 2.10:
private _isNull = _teamMember isEqualTo teamMemberNull;

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

@@ Line 29: / Line 29: @@
 Which null type the item has to be equal to depends on the type of game entity tested:
-{{{!}} class{{=}}"wikitable" style{{=}}"text-align: center"
+{{{!}} class="wikitable" style="text-align: center"
 ! [[:Category:Data Types|Type]]
 {{!}} [[Object]]
@@ Line 37: / Line 37: @@
 {{!}} [[Location]]
 {{!}} [[Task]]
-{{!}} [[Script]]
+{{!}} [[Script Handle|Script]]
 {{!}} [[Config]]
 {{!}} [[Diary Record]]
+{{!}} [[Team Member]]
 {{!}}-
 ! Null value
@@ Line 51: / Line 52: @@
 {{!}} [[configNull]]
 {{!}} [[diaryRecordNull]]
-{{!}}- style{{=}}"font-size: .85em"
+{{!}} [[teamMemberNull]]
+{{!}}- style="font-size: .85em"
 ! Since
 {{!}} {{GVI|ofp|1.00}}
@@ Line 61: / Line 63: @@
 {{!}} {{GVI|arma3|1.30}}
 {{!}} {{GVI|arma3|1.54}}
 {{!}} {{GVI|arma3|2.00}}
+{{!}} {{GVI|arma3|2.10}}
 {{!}}}
-{{Feature | important | A test via {{=}}{{=}} does '''not''' work, because a null value is not equal to anything, not even itself ([[configNull]] being the exception).
+{{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]].}}
-|pr= [[teamMemberNull]] for [[Team Member]] type is '''not''' supported. Use {{ic|[[private]] _isNull {{=}} _teamMember [[isEqualTo]] [[teamMemberNull]]}} instead.
+|s1= [[isNull]] entity
-|s1=  [[isNull]] entity
+|p1= entity: [[Object]], [[Control]], [[Display]], [[Group]], [[Location]], [[Task]], [[Script Handle]], [[Config]] or [[Diary Record]]
-|p1= entity: [[Object]], [[Control]], [[Display]], [[Group]], [[Location]], [[Task]], [[Script]], [[Config]] or [[Diary Record]]
+|r1= [[Boolean]]
-|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>
-|x1= <code>[[if]] ([[isNull]] obj) [[then]] {[[hint]] "doesn't exist";};</code>
+[[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]]
+|seealso= [[controlNull]] [[displayNull]] [[grpNull]] [[locationNull]] [[objNull]] [[taskNull]] [[teamMemberNull]] [[scriptNull]] [[configNull]] [[typeName]]
 }}