---
name: "isNull"
type: command
status: ok
groups: ["Variables"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/isNull
revid: 370892
updated: 2025-02-21T10:44:05Z
---

# isNull

*Command · Variables · Arma 3 v0.50 · introduced in Operation Flashpoint v1.00*

Locality: arguments **global**

## 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](../topics/Object.md) | [Group](../topics/Group.md) | [Control](../topics/Control.md) | [Display](../topics/Display.md) | [Location](../topics/Location.md) | [Task](../topics/Task.md) | [Script](../topics/Script_Handle.md) | [Config](../topics/Config.md) | [Diary Record](../topics/Diary_Record.md) | [Team Member](../topics/Team_Member.md) |
| Null value | [objNull](../commands/objNull.md) | [grpNull](../commands/grpNull.md) | [controlNull](../commands/controlNull.md) | [displayNull](../commands/displayNull.md) | [locationNull](../commands/locationNull.md) | [taskNull](../commands/taskNull.md) | [scriptNull](../commands/scriptNull.md) | [configNull](../commands/configNull.md) | [diaryRecordNull](../commands/diaryRecordNull.md) | [teamMemberNull](../commands/teamMemberNull.md) |
| Since | Operation Flashpoint v1.00 | Armed Assault v1.00 | Arma 2 v1.00 | Arma 3 v1.30 | Arma 3 v1.54 | Arma 3 v2.00 | Arma 3 v2.10 |  |  |  |

> [!IMPORTANT]
>

## Syntax

```sqf
isNull entity
```

**Parameters:**

- `entity`: [Object](../topics/Object.md), [Control](../topics/Control.md), [Display](../topics/Display.md), [Group](../topics/Group.md), [Location](../topics/Location.md), [Task](../topics/Task.md), [Script Handle](../topics/Script_Handle.md), [Config](../topics/Config.md) or [Diary Record](../topics/Diary_Record.md)

**Returns:** [Boolean](../topics/Boolean.md)

## Examples

### Example 1

```sqf
if (isNil "obj") exitWith { hint "obj variable is undefined" };

if (isNull obj) then
{
    hint "obj variable is defined but is null";
}
else
{
    hint "obj variable is defined and is not null";
};
```

### Example 2

[Diary Record](../topics/Diary_Record.md) support before Arma 3 v2.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" };
```

[Team Member](../topics/Team_Member.md) support before Arma 3 v2.10:

```sqf
private _isNull = _teamMember isEqualTo teamMemberNull;
```

## See also

[controlNull](../commands/controlNull.md) · [displayNull](../commands/displayNull.md) · [grpNull](../commands/grpNull.md) · [locationNull](../commands/locationNull.md) · [objNull](../commands/objNull.md) · [taskNull](../commands/taskNull.md) · [teamMemberNull](../commands/teamMemberNull.md) · [scriptNull](../commands/scriptNull.md) · [configNull](../commands/configNull.md) · [typeName](../commands/typeName.md)

<sub>Source: [BI Community Wiki — isNull](https://community.bistudio.com/wiki/isNull) (revision 370892).</sub>