isKindOf

1.001.001.001.501.000.50

Hover & click on the images for description

Description

Description:

Checks whether the given object or type is (a subtype) of the given type.
While Syntax 1 and Syntax 2 only support CfgVehicles, 1.00CfgAmmo and CfgNonAIVehicles, Syntax 3 can be used with any config, including the mission config.

Groups:

Object Manipulation

Syntax 1

Syntax:

object isKindOf typeName

Parameters:

object: Object

typeName: String

Return Value:

Boolean

Syntax 2

Syntax:

class1 isKindOf class2

Parameters:

class1: String

class2: String

Return Value:

Boolean

1.48

Syntax 3

Syntax:

class1 isKindOf [class2, targetConfig]

Parameters:

class1: String

class2: String

targetConfig: Config

Return Value:

Boolean

Examples

Example 1:

vehicle player isKindOf "Tank";

Example 2:

"BMP2" isKindOf "Tank";

Example 3:

currentWeapon player isKindOf ["Rifle", configFile >> "CfgWeapons"];

Example 4:

private _isSoldier = player isKindOf "CAManBase";

Additional Information

See also:

typeOf countType inheritsFrom configHierarchy

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

Kronzky - c

Posted on Apr 23, 2007 - 16:34 (UTC)

This command can be used on the whole hierarchical class tree (i.e. when checking a HMMWV, one could test for "HMMWV50", "Car", "LandVehicle", etc., all of which would return true.)

James - c

Posted on Jun 16, 2015 - 17:54 (UTC)

In case you cannot use isKindOf because of the reasons stated, just use BIS_fnc_returnParents with class names as return value:

_isKindOf = "Rifle" in [configFile >> "CfgWeapons" >> "BWA3_G36K", true] call BIS_fnc_returnParents; // is true

Basstard - c

Posted on Sep 06, 2015 - 22:21 (UTC)

In Arma 3 isKindOf works well with CfgWeapons and CfgMagazines using the syntax from example 3.
It should be prefered to James' solution as it performs more than 25x faster. Tested in debug console with the following code snippets:

"CA_Magazine" in ([configFile >> "CfgMagazines" >> "HandGrenade", true] call BIS_fnc_returnParents); // 0.12111 ms "HandGrenade" isKindOf ["CA_Magazine", configFile >> "CfgMagazines"]; // 0.00439453 ms

When checking in CfgVehicles the syntax from Example 2 performs a little faster.