isNull: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>") |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
(3 intermediate revisions by 2 users not shown) | |||
Line 29: | Line 29: | ||
Which null type the item has to be equal to depends on the type of game entity tested: | Which null type the item has to be equal to depends on the type of game entity tested: | ||
{{{!}} class | {{{!}} class="wikitable" style="text-align: center" | ||
! [[:Category:Data Types|Type]] | ! [[:Category:Data Types|Type]] | ||
{{!}} [[Object]] | {{!}} [[Object]] | ||
Line 37: | Line 37: | ||
{{!}} [[Location]] | {{!}} [[Location]] | ||
{{!}} [[Task]] | {{!}} [[Task]] | ||
{{!}} [[Script]] | {{!}} [[Script Handle|Script]] | ||
{{!}} [[Config]] | {{!}} [[Config]] | ||
{{!}} [[Diary Record]] | {{!}} [[Diary Record]] | ||
{{!}} [[Team Member]] | |||
{{!}}- | {{!}}- | ||
! Null value | ! Null value | ||
Line 51: | Line 52: | ||
{{!}} [[configNull]] | {{!}} [[configNull]] | ||
{{!}} [[diaryRecordNull]] | {{!}} [[diaryRecordNull]] | ||
{{!}} | {{!}} [[teamMemberNull]] | ||
{{!}}- style="font-size: .85em" | |||
! Since | ! Since | ||
{{!}} | {{!}} colspan="2" {{!}} {{GVI|ofp|1.00}} | ||
{{!}} {{GVI|ofp|1.00}} | {{!}} colspan="2" {{!}} {{GVI|arma1|1.00}} | ||
{{!}} | {{!}} colspan="2" {{!}} {{GVI|arma2|1.00}} | ||
{{!}} {{GVI|arma1|1.00}} | |||
{{!}} | |||
{{!}} {{GVI|arma2|1.00}} | |||
{{!}} {{GVI|arma3|1.30}} | {{!}} {{GVI|arma3|1.30}} | ||
{{!}} {{GVI|arma3|1.54}} | {{!}} {{GVI|arma3|1.54}} | ||
{{!}} {{GVI|arma3|2.00}} | {{!}} {{GVI|arma3|2.00}} | ||
{{!}} {{GVI|arma3|2.10}} | |||
{{!}}} | {{!}}} | ||
{{Feature | important | A test via | {{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]].}} | See also [[isEqualTo]].}} | ||
|s1= [[isNull]] entity | |s1= [[isNull]] entity | ||
|p1= entity: [[Object]], [[Control]], [[Display]], [[Group]], [[Location]], [[Task]], [[Script]], [[Config]] or [[Diary Record]] | |p1= entity: [[Object]], [[Control]], [[Display]], [[Group]], [[Location]], [[Task]], [[Script Handle]], [[Config]] or [[Diary Record]] | ||
|r1= [[Boolean]] | |r1= [[Boolean]] | ||
|x1= <sqf>if (isNull obj) then {hint " | |x1= <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"; | |||
}; | |||
</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> | |||
[[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]] | ||
}} | }} |
Latest revision as of 21:32, 19 September 2024
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: - 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:
- Example 2:
- Diary Record support before 2.00:
Team Member support before 2.10:
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
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.00
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Operation Flashpoint: Elite: Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Variables