isNull: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (template:command argument fix)
Line 20: Line 20:
* [[Config]]s -> [[configNull]] (since Arma 3 1.53.133130)
* [[Config]]s -> [[configNull]] (since Arma 3 1.53.133130)


Note: A test via <nowiki>==</nowiki> does not work, because, for example, [[objNull]] is not equal to anything, not even to itself. Use [[isEqualTo]]. |= Description
Note: A test via <nowiki>==</nowiki> does not work, because, for example, [[objNull]] is not equal to anything, not even to itself. Use [[isEqualTo]]. |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| '''isNull''' entity |= Syntax
| '''isNull''' entity |SYNTAX=


|p1 = entity: [[Object]], [[Control]], [[Display]], [[Group]] (or [[Location]], [[Task]] since ARMA 2 (or [[Script]] since Arma 3 1.29.127075)) |= Parameter 1
|p1 = entity: [[Object]], [[Control]], [[Display]], [[Group]] (or [[Location]], [[Task]] since ARMA 2 (or [[Script]] since Arma 3 1.29.127075)) |PARAMETER1=


| [[Boolean]] |= Return value
| [[Boolean]] |RETURNVALUE=
____________________________________________________________________________________________
____________________________________________________________________________________________


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


| [[controlNull]], [[displayNull]], [[grpNull]], [[locationNull]], [[objNull]], [[taskNull]], [[teamMemberNull]], [[scriptNull]], [[configNull]], [[typeName]]|= See also
| [[controlNull]], [[displayNull]], [[grpNull]], [[locationNull]], [[objNull]], [[taskNull]], [[teamMemberNull]], [[scriptNull]], [[configNull]], [[typeName]]|SEEALSO=


}}
}}

Revision as of 14:41, 7 April 2019

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:
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

Notes

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