isNull: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Take[ _]On[ _]Helicopters(\|.*)?\]\]" to "{{GameCategory|tkoh|Scripting Commands}}")
m (Text replacement - "_{10,} " to "")
Line 1: Line 1:
{{Command|Comments=
{{Command|Comments=
____________________________________________________________________________________________


| ofp |Game name=
| ofp |Game name=
Line 9: Line 8:


|gr1= Variables |GROUP1=
|gr1= Variables |GROUP1=
____________________________________________________________________________________________


| Checks whether the tested item is null.<br>
| Checks whether the tested item is null.<br>
Line 53: Line 51:


|pr= [[teamMemberNull]] for [[Team Member]] type is '''not''' supported. Use {{Inline code|[[private]] _isNull {{=}} _teamMember [[isEqualTo]] [[teamMemberNull]]}} instead. |PROBLEMS=
|pr= [[teamMemberNull]] for [[Team Member]] type is '''not''' supported. Use {{Inline code|[[private]] _isNull {{=}} _teamMember [[isEqualTo]] [[teamMemberNull]]}} instead. |PROBLEMS=
____________________________________________________________________________________________


| [[isNull]] entity |SYNTAX=
| [[isNull]] entity |SYNTAX=
Line 60: Line 57:


| [[Boolean]] |RETURNVALUE=
| [[Boolean]] |RETURNVALUE=
____________________________________________________________________________________________


|x1 = <code>[[if]] ([[isNull]] obj) [[then]] {[[hint]] "doesn't exist";};</code>
|x1 = <code>[[if]] ([[isNull]] obj) [[then]] {[[hint]] "doesn't exist";};</code>

Revision as of 02:40, 17 January 2021

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
Null value objNull grpNull controlNull displayNull locationNull taskNull scriptNull configNull diaryRecordNull
Since OFP v1.00 OFP v1.00 ArmA v1.00 ArmA v1.00 Arma 2 v1.00 Arma 2 v1.00 Arma 3 v1.29.127075 Arma 3 v1.53.133130 Arma 3 v1.99.146508
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.
Problems:
teamMemberNull for Team Member type is not supported. Use private _isNull = _teamMember isEqualTo teamMemberNull instead.
Groups:
Variables

Syntax

Syntax:
isNull entity
Parameters:
entity: Object, Control, Display, Group, Location, Task, Script, Config or Diary Record
Return Value:
Boolean

Examples

Example 1:
if (isNull obj) then {hint "doesn't exist";};

Additional Information

See also:
controlNulldisplayNullgrpNulllocationNullobjNulltaskNullteamMemberNullscriptNullconfigNulltypeName

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

Notes

Bottom Section