isNull

1.00

GAGlobal

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:

• Objects -> objNull
• Controls -> controlNull
• Displays -> displayNull
• Groups -> grpNull
• Locations -> locationNull (since ARMA 2)
• Tasks -> taskNull (since ARMA 2)
• Scripts -> scriptNull (since Arma 3 1.29.127075)
• Configs -> configNull (since Arma 3 1.53.133130)

Note: A test via == does not work, because, for example, objNull is not equal to anything, not even to itself. Use isEqualTo.

Groups:

Uncategorised

Syntax

Syntax:

isNull entity

Parameters:

entity: Object, Control, Display, Group (or Location, Task since ARMA 2 (or Script since Arma 3 1.29.127075))

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

Bottom Section

Posted on December 9, 2015 - 11:29 (UTC)

Commy2

isNull does not work with the TEAM_MEMBER type. Use this instead: _tmember isEqualTo teamMemberNull

Posted on December 9, 2015 - 11:38 (UTC)

Commy2

The note in the description does not apply to the CONFIG type, probably due to backwards compatibility.
configNull == configNull -> true