isKindOf: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|r2= Boolean |RETURNVALUE= " to "|r2= Boolean |RETURNVALUE2=")
Line 7: Line 7:
____________________________________________________________________________________________
____________________________________________________________________________________________


| Checks whether the object is (a subtype) of the given type. While main syntax and alt syntax support only CfgVehicles, CfgAmmo and CfgNonAIVehicles, alt syntax 2 allows to specify any config, including mission config. |DESCRIPTION=
| Checks whether the object is (a subtype) of the given type. While main and alternative syntaxes support only '''CfgVehicles''', '''CfgAmmo''' and '''CfgNonAIVehicles''', alternative syntax 2 allows to specify any config, including [[missionConfigFile|mission config]]. |DESCRIPTION=
____________________________________________________________________________________________
____________________________________________________________________________________________


| object '''isKindOf''' typeName |SYNTAX=
| object [[isKindOf]] typeName |SYNTAX=


|p1= object: [[Object]] |PARAMETER1=
|p1= object: [[Object]] |PARAMETER1=
Line 17: Line 17:


| [[Boolean]] |RETURNVALUE=
| [[Boolean]] |RETURNVALUE=
____________________________________________________________________________________________


|s2=  typeName1 '''isKindOf''' typeName2 |Alternative Syntax=
|s2=  typeName1 [[isKindOf]] typeName2 |Alternative Syntax=


|p21= typeName1: [[String]]|PARAMETER21=
|p21= typeName1: [[String]] |PARAMETER21=


|p22= typeName2: [[String]]|PARAMETER2=
|p22= typeName2: [[String]] |PARAMETER22=


|r2= [[Boolean]] |RETURNVALUE2=
|r2= [[Boolean]] |RETURNVALUE2=
|s3=  typeName1 '''isKindOf''' [typeName2, targetConfig]         (''since Arma 3 v1.47'') |Alternative Syntax=
____________________________________________________________________________________________
 
|s3=  typeName1 [[isKindOf]] [typeName2, targetConfig]        (''Since {{arma3}} v1.47'') |Alternative Syntax2=


|p41= typeName1: [[String]]|PARAMETER1=
|p31= typeName1: [[String]]|PARAMETER31=


|p42 = [typeName2, targetConfig]: - [[Array]]|PARAMETER2=
|p32 = [typeName2, targetConfig]: - [[Array]]|PARAMETER32=


|p43= typeName2: [[String]]|PARAMETER3=
|p33= typeName2: [[String]]|PARAMETER33=


|p44= targetConfig: [[Config]]|PARAMETER4=
|p34= targetConfig: [[Config]]|PARAMETER34=


|r3= [[Boolean]] |RETURNVALUE=
|r3= [[Boolean]] |RETURNVALUE3=
____________________________________________________________________________________________
____________________________________________________________________________________________
   
   
Line 42: Line 45:
|x2= <code>"BMP2" [[isKindOf]] "Tank";</code> |EXAMPLE2=
|x2= <code>"BMP2" [[isKindOf]] "Tank";</code> |EXAMPLE2=


|x3= <code>[[currentWeapon]] [[player]] [[isKindOf]] ["Rifle", [[configFile]] >> "CfgWeapons"];</code> |EXAMPLE2=
|x3= <code>[[currentWeapon]] [[player]] [[isKindOf]] ["Rifle", [[configFile]] >> "CfgWeapons"];</code> |EXAMPLE3=


____________________________________________________________________________________________
____________________________________________________________________________________________


| [[countType]], [[typeOf]], [[inheritsFrom]], [[configHierarchy]], [[ArmA_2:_CfgVehicles | Arma 2 CfgVehicles]] |SEEALSO=
| [[countType]], [[typeOf]], [[inheritsFrom]], [[configHierarchy]], [[ArmA_2:_CfgVehicles | Arma 2 CfgVehicles]] |SEEALSO=
}}
}}


Line 55: Line 57:


<dd class="notedate">Posted on April 23, 2007 - 16:34
<dd class="notedate">Posted on April 23, 2007 - 16:34
<dt class="note">'''[[User:Kronzky|Kronzky]]'''
<dt class="note">[[User:Kronzky|Kronzky]]
<dd class="note">This command can be used on the whole [[ArmA: CfgVehicles|hierarchical class tree]] (i.e. when checking a [[ArmA:_Vehicles#Wheeled|HMMWV]], one could test for "HMMWV50", "Car", "LandVehicle", etc., all of which would return [[true]].)
<dd class="note">This command can be used on the whole [[ArmA: CfgVehicles|hierarchical class tree]] (i.e. when checking a [[ArmA:_Vehicles#Wheeled|HMMWV]], one could test for "HMMWV50", "Car", "LandVehicle", etc., all of which would return [[true]].)


Line 90: Line 92:
<dd class="note">
<dd class="note">
In case you cannot use [[isKindOf]] because of the reasons stated, just use [[BIS fnc returnParents]] with class names as return value:
In case you cannot use [[isKindOf]] because of the reasons stated, just use [[BIS fnc returnParents]] with class names as return value:
<code> _isKindOf = "Rifle" [[in]] [([[configFile]] >> "CfgWeapons" >> "BWA3_G36K"),[[true]]<nowiki>]</nowiki> [[call]] [[BIS_fnc_returnParents]]; // is true</code>
<code>_isKindOf = "Rifle" [[in]] [([[configFile]] >> "CfgWeapons" >> "BWA3_G36K"), [[true]]<nowiki>]</nowiki> [[call]] [[BIS_fnc_returnParents]]; {{cc|is true`}}</code>
</dd>
</dd>
</dl>
</dl>

Revision as of 14:56, 4 September 2019

-wrong parameter ("Arma") defined!-1.00
Hover & click on the images for description

Description

Description:
Checks whether the object is (a subtype) of the given type. While main and alternative syntaxes support only CfgVehicles, CfgAmmo and CfgNonAIVehicles, alternative syntax 2 allows to specify any config, including mission config.
Groups:
Uncategorised

Syntax 1

Syntax:
object isKindOf typeName
Parameters:
object: Object
typeName: String
Return Value:
Boolean

Syntax 2

Syntax:
typeName1 isKindOf typeName2
Parameters:
typeName1: String
typeName2: String
typeName1: String
[typeName2, targetConfig]: - Array
typeName2: String
targetConfig: Config
Return Value:
Boolean

Syntax 3

Syntax:
typeName1 isKindOf [typeName2, targetConfig]        (Since Arma 3 v1.47)
Return Value:
Boolean

Examples

Example 1:
vehicle player isKindOf "Tank";
Example 2:
"BMP2" isKindOf "Tank";
Example 3:
currentWeapon player isKindOf ["Rifle", configFile >> "CfgWeapons"];

Additional Information

See also:
countTypetypeOfinheritsFromconfigHierarchy Arma 2 CfgVehicles

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

Posted on April 23, 2007 - 16:34
Kronzky
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.)
Posted on 16 Apr, 2008
Dr_Eyeball
It appears isKindOf is limited to the CfgVehicles branch of the class hierachy.
So CfgWeapons, CfgMagazines, etc will return false for checks like: ("M9" isKindOf "Pistol") returns false
Posted on 8 Nov, 2009
.kju
In a2 isKindOf also works for CfgAmmo in addition to CfgVehicles: ("M_9M311_AA" isKindOf "MissileBase") returns true. NOT for CfgWeapons, CfgMagazines and others..

Bottom Section

Posted on June 16, 2015 - 17:54 (UTC)
James
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`
Posted on September 6, 2015 - 22:21 (UTC)
Basstard
In A3 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:
bool = "CA_Magazine" in ([(configFile >> "CfgMagazines" >> "HandGrenade"),true] call BIS_fnc_returnParents); --> 0.12111ms bool = "HandGrenade" isKindOf ["CA_Magazine", configFile >> "CfgMagazines"]; --> 0.00439453ms
When checking in CfgVehicles the syntax from example 2 performs a little faster.
Retrieved from "https://community.bistudio.com/wiki?title=isKindOf&oldid=136845"